IDE
在 VS Code、Cursor 等 IDE 中使用 OpenCode。
OpenCode 可以与 VS Code、Cursor、Windsurf、VSCodium 等支持终端的 IDE 集成。只需在集成终端中运行 opencode 即可在 IDE 内使用 TUI。
使用方式
-
快速打开:
- macOS:
Cmd+Esc - Windows / Linux:
Ctrl+Esc在分屏终端中打开 OpenCode;如果已有会话,会直接聚焦到该终端。
- macOS:
-
开启新会话:
- macOS:
Cmd+Shift+Esc - Windows / Linux:
Ctrl+Shift+Esc即使已有 OpenCode 终端,也会再启动一个新会话。你也可以点击 IDE 中的 OpenCode 按钮。
- macOS:
-
上下文感知: 插件可以自动将当前选中的代码或当前激活的文件上下文传给 OpenCode。
-
文件引用快捷键:
- macOS:
Cmd+Option+K - Windows / Linux:
Alt+Ctrl+K快速在输入中插入类似@File#L37-42的文件/行号引用,让 OpenCode 精确定位到当前编辑位置。
- macOS:
安装
在 VS Code / Cursor / Windsurf / VSCodium 中使用:
-
打开 IDE;
-
打开集成终端;
-
运行:
Terminal window opencode首次运行时,插件会自动安装。
如果你希望在 TUI 中使用 /editor 或 /export 时直接调用 IDE 编辑器,需要在 Shell 中设置:
export EDITOR="code --wait"更多说明见 TUI 文档的编辑器设置。
手动安装
也可以在扩展市场中搜索 OpenCode 并手动点击 Install 安装。
故障排查
如果自动安装失败,可以检查:
- 是否在“集成终端”而不是外部终端中运行了
opencode; - IDE 的命令行工具是否已安装:
- VS Code:
code - Cursor:
cursor - Windsurf:
windsurf - VSCodium:
codium
- VS Code:
- 如果命令不存在,可以在 IDE 中按
Cmd+Shift+P(Mac)或Ctrl+Shift+P(Windows/Linux),搜索:- “Shell Command: Install ‘code’ command in PATH” 或对应 IDE 的命令
- 确认 IDE 具有安装扩展的权限(某些企业环境可能对此有限制)。