claude-code.el

claude-code.el

An Emacs interface for Claude Code CLI, providing integration between Emacs and Claude AI for coding assistance.

Features

- Seamless Emacs Integration - Start, manage, and interact with Claude without leaving Emacs
- Stay in Your Buffer - Send code, regions, or commands to Claude while keeping your focus
- Fix Errors Instantly - Point at a flycheck/flymake error and ask Claude to fix it
- Paste Images - M-x yank-media sends a clipboard image to Claude as an @path reference (Emacs 29+)
- Multiple Instances - Run separate Claude sessions for different projects or tasks
- Quick Responses - Answer Claude with a keystroke (//1/2/3) without switching buffers
- Smart Context - Optionally include file paths and line numbers when sending commands to Claude
- Transient Menu - Access all commands and slash commands through a transient menu
- Continue Conversations - Resume previous sessions or fork to earlier points
- Read-Only Mode - Toggle to select and copy text with normal Emacs commands and keybindings
- Mode Cycling - Quick switch between default, auto-accept edits, and plan modes
- Desktop Notifications - Get notified when Claude finishes processing
- Terminal Choice - Works with eat, vterm, and ghostel (libghostty) backends
- Fully Customizable - Configure keybindings, notifications, and display preferences

Installation

Prerequisites

- Emacs 30.0 or higher
- Claude Code CLI installed and configured
- Required: transient (0.7.5+) inheritenv (0.2)
- Optional: eat (0.9.2+) for eat backend, vterm for vterm backend, ghostel for ghostel backend
  - Note: If not using a :vc install, the eat package requires NonGNU ELPA:

- Optional but recommended: Monet for IDE integration

Using builtin use-package (Emacs 30+)

Using straight.el

Basic Usage

Setting…