Claude Code Emacs
Run Claude Code AI coding sessions directly in Emacs with powerful MCP integration.
Quick Start
;; Add to your init.el
(add-to-list 'load-path "/path/to/claude-code")
(require 'claude-code)
(global-set-key (kbd "C-c c") 'claude-code-transient)
# Install MCP server globally
npm install -g claude-code-mcp-server
# Configure Claude Code to use MCP
claude mcp add-json emacs '{
"type": "stdio",
"command": "claude-code-mcp"
}'
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
⌨️ Key Bindings
Global
| Key | Action |
|-----|--------|
| C-c c | Open main transient menu |
| C-u M-x claude-code-run | Start with options (model, resume, etc.) |
In Claude Code Session (vterm mode)
| Key | Action |
|-----|--------|
| C-c C-q | Close Claude Code window |
| C-c C-k | Send Escape key |
| C-c C-o | Send Ctrl+O (toggle expand) |
| C-c C-e | Send Ctrl+E (toggle expand more) |
| C-c C-d | Send Ctrl+T (toggle TODO display) |
| C-c C-n | Send Tab (toggle thinking mode) |
| C-c RET | Send Return key |
| C-c TAB | Send Shift+Tab (toggle auto-accept) |
| C-c C-t | Open transient menu |
In Prompt Buffer
| Key | Action |
|-----|--------|
| C-c C-s | Send section at point |
| C-c C-r | Send selected region |
| C-c C-o | Open Claude Code session |
| C-c C-t | Open prompt transient menu |
| @ | File completion |
In Transient Menu (C-c c)
| Key | Action |
|-----|--------|
| 1/y | Send 1 (yes) |
| 2 | Send 2 |
| 3 | Send 3 |
| k | Send Escape |
| e | Send Ctrl+E (toggle expand more) |
| o | Send Ctrl+O (toggle expand) |
| t | Send Ctrl+T (toggle TODO display) |
| h | Send Tab (toggle thinking mode) |
| g | Git & GitHub menu |
| / | Slash commands menu |
Common Workflows
Project Prompts
Each project gets a .claude-code.prompt.md file at the project root. When you open this file, it automatically positions at the end for quick prompt entry:
# Claude Code Prompts for my-project
This file contains prompts for Claude Code sessions.
## Example Prompts
Fix the bug in @src/utils.js where the parser fails on empty strings
---
Add unit tests for @src/api/auth.js
Open with M-x claude-code-open-prompt-file or p in transient menu.
Fix LSP Errors
M-x claude-code-fix-diagnostic
;; or press 'f' in transient menu
Custom Commands
Create .claude/commands/refactor.md:
Refactor the following code: $ARGUMENTS
Execute with x in transient menu → select "refactor"
Git Operations
Press g in main menu for git commands:
g - commitp - pushr - review changesc - PR comments
Requirements
- Emacs 28.1+
- Claude Code CLI installed
- Node.js 16+ (for MCP)
- Required packages:
projectile, vterm, transient, markdown-mode
- Optional packages:
... View full README on GitHub
