# 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) を参考にしました。
