mirror of
https://github.com/claude-code-best/claude-code.git
synced 2026-06-22 08:15:53 +00:00
60 lines
2.5 KiB
Markdown
60 lines
2.5 KiB
Markdown
# VSCode IDE Bridge
|
||
|
||
这是一个给当前仓库配套的本地 VSCode 扩展，用来把 VSCode 和现有 Claude Code CLI 的 `ws-ide` 链路接起来。
|
||
|
||
## 当前能力
|
||
|
||
- 在本地 `127.0.0.1` 启动 `ws-ide` WebSocket 服务
|
||
- 写出 CLI 可发现的 `~/.claude/ide/<port>.lock`
|
||
- 把 VSCode 当前活动文件和选区变化发送为 `selection_changed`
|
||
- 实现 `openDiff`、`close_tab`、`closeAllDiffTabs` 三个 IDE MCP tools
|
||
- 提供 `Claude Code Bridge: Restart` 和 `Claude Code Bridge: Show Status` 两个调试命令
|
||
|
||
## 当前限制
|
||
|
||
- diff 现在支持通过保存右侧文件把修改回传给 CLI，但还没有补“未保存直接接受右侧手工编辑”这类更细的交互
|
||
- 还没有补 `openFile`、`getDiagnostics`、`at_mentioned`、`log_event` 这些附加能力
|
||
- 目前按单个活动 CLI 连接设计，新连接会替换旧连接
|
||
|
||
## 本地使用
|
||
|
||
推荐把这个目录单独当成一个扩展工程来打开，而不是总是从 monorepo 根目录调试。
|
||
|
||
1. 在 VSCode 中直接打开 `packages/vscode-ide-bridge`
|
||
2. 打开“运行和调试”
|
||
3. 二选一：
|
||
- `Run VSCode IDE Bridge`
|
||
- `Run VSCode IDE Bridge (Open Claude Code Root)`，会直接在测试窗口里打开 monorepo 根目录
|
||
4. 这会自动先执行 `Build VSCode IDE Bridge`
|
||
5. 如果用了第一个启动项，就在新开的 Extension Development Host 窗口中再打开你真正要联调的目标工作区
|
||
如果用了第二个启动项，会直接打开 `claude-code` 根目录
|
||
6. 打开命令面板，执行 `Claude Code Bridge: Show Status`
|
||
7. 确认输出中已经出现监听端口和 lockfile 路径
|
||
8. 在这个测试窗口的集成终端里启动 Claude Code CLI；如果没有自动连上，再执行 `/ide`
|
||
|
||
这个目录自带自己的 VSCode 配置：
|
||
|
||
- `Run VSCode IDE Bridge`
|
||
- `Run VSCode IDE Bridge (Open Claude Code Root)`
|
||
- `Build VSCode IDE Bridge`
|
||
- `Test VSCode IDE Bridge`
|
||
- `Package VSCode IDE Bridge`
|
||
|
||
如果你仍然从 monorepo 根目录开发，也可以继续使用根目录下的 `.vscode` 配置。
|
||
|
||
## 打包
|
||
|
||
可以直接在这个包目录里执行：
|
||
|
||
```bash
|
||
bun run package
|
||
```
|
||
|
||
成功后会在 `dist/vscode-ide-bridge.vsix` 生成可安装的 VSCode 扩展包。
|
||
|
||
## 验证建议
|
||
|
||
- 选中一段代码后发起提问，确认 CLI prompt 中出现 `<ide_selection>`
|
||
- 触发一次文件 diff，确认 VSCode 中会打开 diff，并能通过通知选择“接受”或“拒绝”
|
||
- 查看 `Claude Code IDE Bridge` output channel，确认没有鉴权失败或 lockfile 写入失败
|