インストール

動作要件

• Emacs 29.1 以降。 ほかのパッケージは要りません。transient は Emacs に含まれています。
• Claude Code CLI。 PATH に置くか、ecc-executable で指定します。

次のパッケージは任意です。

パッケージ	機能
ghostel	ecc-tui-open でセッションを引き渡すターミナルエミュレータ
posframe	/btw の回答や使用量レポートのフローティングポップアップ
nerd-icons	トランスクリプト内のツール呼び出しアイコン
markdown-mode	プランバッファおよびレビューバッファのメジャーモード
mermaid-cli	返答中の ```mermaid ブロックを図として表示

インストール手順

ecc は MELPA にないので、Git リポジトリからインストールします。リポジトリは emacs-claude-code、パッケージは ecc なので、URL から名前を取るパッケージマネージャーにはパッケージ名を指定してください。

Emacs 30 以降

(use-package ecc
  :ensure t
  :vc (:url "https://github.com/wakamenod/emacs-claude-code" :rev :newest))

:rev "<commit-sha>" でコミットを固定できます。

Emacs 29

M-x package-vc-install RET https://github.com/wakamenod/emacs-claude-code RET

そのあとは :vc なしの use-package で設定します。

straight.el

(use-package ecc
  :straight (ecc :type git :host github :repo "wakamenod/emacs-claude-code"))

最初の設定

M-x ecc-start は autoload されるので、設定なしでも動きます。グローバルキーマップをプレフィクスに割り当ててください。

(use-package ecc
  :ensure t
  :vc (:url "https://github.com/wakamenod/emacs-claude-code" :rev :newest)
  :bind-keymap ("C-c c" . ecc-global-map))

ecc-global-map で、リクエストへの応答、応答待ちのセッションへの移動、サイドバーの表示をどのバッファからでもできます。このサイトではキーを C-c c で書いています。キーバインドを参照してください。

ほかの設定も含めた例は、README の作者の設定を参照してください。

MCP サーバーの有効化

内蔵の MCP サーバーはループバックインターフェイスで動きます。Claude は Emacs から xref の参照、imenu のシンボル、診断を読み、レビューで作業し、作業を worktree のセッションに引き渡せます。デフォルトでは無効で、Elisp の評価はさらに別に有効にします。

(setq ecc-mcp-enabled t)
;; Claude に任意の Elisp を評価させたい場合のみ有効化:
;; (setq ecc-mcp-enable-execute-code t)

動作確認

プロジェクトのファイルを開いて M-x ecc-start を実行し、下のプロンプト領域にメッセージを入力して C-c C-c を押します。続きは最初のセッションにあります。

CLI が起動しないときは、M-x ecc-show-log（C-c ? → L）で、ecc が実行したコマンドと CLI が返したものを確認できます。

すべての設定は M-x customize-group RET ecc と設定のページにあります。