claude-code-emacs

Claude Code Emacs

Run Claude Code AI coding sessions directly in Emacs with powerful MCP integration.

Quick Start

Now run M-x claude-code-run to start a session!

Key Features

🚀 Core Features
- Project-isolated sessions - Each project gets its own Claude Code buffer
- Smart file completion - Type @ in prompts to reference project files
- Transient menus - Press C-c c for the main menu with all commands
- Custom commands - Define reusable commands in .claude/commands/*.md
- Project prompts - .claude-code.prompt.md file per project for persistent context

🔌 MCP Integration
Claude Code can directly interact with your Emacs environment:
- Buffer operations - List/read open buffers, get selected text
- LSP integration - Get diagnostics, find definitions/references, describe symbols
- Diff tools - Compare files, view git changes, apply patches
- Real-time events - Buffer changes and diagnostics sent to Claude Code automatically
- Automatic reconnection - If Emacs restarts, running sessions (including background agents) re-register themselves and reconnect automatically

⌨️ Key Bindings

Global

In Claude Code Session (vterm mode)

In Agent View Mode (claude-code-vterm-agent-mode)

A minor mode for operating the Claude Code agents view.
Press C-c C-a in a Claude Code session to send Left (which opens the
agents view) and enable this mode.

The mode stays deliberately minimal so its keymap is free for user
extensions. Everything not listed below passes through to the
terminal: typing reaches the agents view's text input, and the TUI's
own control keys (C-r rename, C-s switch view, C-t pin, arrows,
RET, ESC) work as in a plain vterm.

The transient menu bundles all agents view operations: select
(n/p), rename via minibuffer (r), pin to top (t), stop with
confirmation (k),…