nekolas note

毎日書くことを目指しているけど全然達成できてないブログ

6.3 KB Raw
# zed-cc-ide — Claude Code IDE Bridge for Zed

[Zed](https://zed.dev) で開いているファイル・カーソル位置・選択範囲を
[Claude Code](https://claude.com/claude-code) に継続的に共有する Zed 拡張です。
Claude Code の `/ide` コマンド(IDE 連携)を Zed で使えるようにします。

VS Code 拡張と同じ仕組み(`~/.claude/ide/<port>.lock` +ローカル WebSocket 上の MCP)を
Zed で実現しているため、Claude Code 側からは公式 IDE 連携と同じように見えます。

## できること

- **アクティブファイルの共有** — Zed でファイルを切り替えると Claude Code に伝わる
- **カーソル位置・選択範囲の共有** — 移動・選択のたびに継続送信(push)。
  取りこぼしても Claude 側から現在値を取得できる(pull)
- **接続状態の通知** — `/ide` 接続成功で Zed にトースト表示。失敗・切断時は警告

**できないこと**: 診断情報(diagnostics)の共有。Zed が拡張へ診断を公開していないため、
`getDiagnostics` は常に空配列を返します。

## 仕組み

```
Zed ──(LSP stdio)──▶ cc-ide-server(ネイティブ補助バイナリ)
                        │  ├─ ~/.claude/ide/<port>.lock を書く(dir 0700 / file 0600)
                        │  └─ ws://127.0.0.1:<port>(JSON-RPC 2.0 / MCP)を待受
Claude Code ──/ide──────▶ 接続(auth: x-claude-code-ide-authorization)
```

- **Zed 拡張**(WASM, [`src/lib.rs`](./src/lib.rs)) — language server として
  ネイティブの `cc-ide-server` を起動する薄いランチャー
- **cc-ide-server**(Rust, [`server/`](./server/)) — LSP(stdio)と MCP "ide"(WebSocket)の
  両面サーバ。エディタ操作に伴う LSP リクエストからファイル・カーソル・選択を検出し、
  デバウンスして Claude Code へ push する

## インストール

### 前提

- macOS、[rustup](https://rustup.rs) の Rust ツールチェイン(stable)
- Zed が拡張をソースからビルドするため、**Zed のプロセスから `rustup`/`cargo`/`rustc` が
  見える**必要があります(後述のスクリプトが symlink を設定します)

### 付属スクリプトで導入(推奨)

```sh
cd zed-cc-ide
./scripts/install-zed-extension.sh
```

スクリプトは次を行います:

1. `cc-ide-server` をビルドして `~/.local/bin` へ配置
2. WASM ターゲットの追加と、`rustup`/`cargo` の `~/.local/bin` への symlink
   (GUI 起動の Zed は `~/.cargo/bin` が PATH に無いことが多いため)
3. dev 拡張としての登録(Zed がソースから WASM コンポーネントをビルドしてロード)

### 手動で導入する場合

1. `cd server && cargo build --release` して `cc-ide-server` を PATH の通った場所へ置く
   (拡張は `which cc-ide-server` 相当で解決します)
2. Zed のコマンドパレット → **「zed: install dev extension」** → このディレクトリを選択

## 使い方

1. Zed でファイルを開く — 拡張が `cc-ide-server` を起動し、ロックファイルが生成される
2. Zed 内のターミナル等で `claude` を起動し、`/ide` で **Zed** を選択
3. 接続成功で Zed に「Claude Code に接続しました」のトースト
4. 以降、ファイル切替・カーソル移動・範囲選択が Claude に自動で届く

動作確認のコツ: Rust などは標準の language server が優先されるため、
ロックファイル生成の確認は **Markdown ファイルを開く**のが分かりやすいです
(Zed ログに `starting language server process ... cc-ide-server --lsp` が出ます)。

## トラブルシューティング

- **`/ide` に Zed が出ない** — `~/.claude/ide/*.lock` が無い場合、language server が
  起動していません。Zed ログ(cmd-shift-p → `zed: open log`)で
  `compiled Rust extension ... cc-ide` と LSP 起動行を確認してください
- **拡張の再ロード後、LSP が二度と起動しなくなる** — 起動中の Zed は
  拡張ディレクトリ(symlink の張り替えや移動)を検知するとマニフェストの
  再インデックスだけ行い、wasm の再ロードや LSP の再起動はしません。
  ログに `extensions updated. loading 1` が出ていてもファイルを開いて
  LSP が起動しない場合は **Zed を再起動**してください(再起動時に
  既存の `extension.wasm` を読み込み、開いているバッファの LSP を復元します)。
  リポジトリ自体を移動した場合は symlink の張り直しに加えて Zed 再起動が必須です
- **拡張ビルドが `failed to run rustup target add` で失敗** — Zed の PATH から
  rustup が見えていません。`~/.local/bin` など Zed の PATH 上に `rustup`/`cargo`/`rustc` を
  symlink するか、ターミナルから `zed` で起動し直してください
- **`E0463: can't find crate for core`** — `rustc` が rustup 版でなく別系統
  (Homebrew 等)に解決されています。`rustc` の symlink も rustup 版に向けてください
- **拡張がロードされない** — `Cargo.toml` の `zed_extension_api` バージョンが
  インストール済み Zed と不一致の可能性があります。Zed に合わせて調整してください

## 既知の制約

- 選択範囲の検出は Zed 内部の LSP ポーリング挙動(`codeAction` 等)に依存しており、
  公式 API ではありません。Zed の変更で壊れる可能性がありますが、その場合も
  pull(Claude 側からの取得)は機能する設計です
- MCP プロトコルバージョンは対象の Claude Code CLI と整合が必要です
  ([`server/src/protocol.rs`](./server/src/protocol.rs))。不一致だと接続が確立しないことがあります

## 開発

```sh
cd server
cargo test          # 単体(LSP 変換)+ 統合(push/pull payload)
cargo run --example mock_claude   # Claude Code 役のモックで実機 Zed との往復を確認
```

## 謝辞

プロトコルの先行実装として [`celve/claude-code-zed`](https://github.com/celve/claude-code-zed)
および [`coder/claudecode.nvim`](https://github.com/coder/claudecode.nvim) を参考にしました。