OpenCode 文档（IDE 集成）

OpenCode 扩展支持 VS Code、Cursor 及其他任何兼容终端的 IDE。只需在终端中运行 opencode 即可启动使用。

使用方法

快速启动

Mac 系统：使用快捷键 Cmd+Esc
Windows/Linux 系统：使用快捷键 Ctrl+Esc
功能：在分屏终端视图中打开 OpenCode；若已有运行中的终端会话，将直接聚焦该会话。

新建会话

Mac 系统：使用快捷键 Cmd+Shift+Esc
Windows/Linux 系统：使用快捷键 Ctrl+Shift+Esc
功能：即使已有 OpenCode 终端会话，仍可新建一个；也可通过 UI 中的 OpenCode 按钮点击创建。

上下文感知

自动共享当前选中的内容或标签页给 OpenCode。

文件引用快捷键

Mac 系统：使用快捷键 Cmd+Option+K
Windows/Linux 系统：使用快捷键 Alt+Ctrl+K
功能：插入文件引用，示例格式为 @File#L37-42（表示引用文件 File 的第 37-42 行）。

安装步骤

适用于 VS Code 及热门衍生版本（如 Cursor、Windsurf、VSCodium）：

打开对应的 IDE（如 VS Code）
打开集成终端
运行命令：
```
opencode
```
→ 扩展将自动安装完成

自定义 IDE 配置

若希望在 TUI 中运行 /editor 或 /export 命令时使用自定义 IDE，需执行以下配置：

设置环境变量：export EDITOR="code --wait"

（更多关于 TUI 中编辑器设置的内容可参考：/zh/docs/tui/#editor-setup）

手动安装

在 IDE 的「扩展市场」（Extensions Marketplace）中搜索 OpenCode
点击「安装」按钮完成安装

故障排除

若扩展无法自动安装，可按以下步骤排查：

确保在 IDE 的集成终端中运行 opencode 命令
验证 IDE 对应的 CLI 命令是否已安装：
- VS Code：code 命令
- Cursor：cursor 命令
- Windsurf：windsurf 命令
- VSCodium：codium 命令
若 CLI 命令未安装，执行以下操作：
- 按 Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Windows/Linux）打开命令面板
- 搜索并执行 “Shell Command: Install 'code' command in PATH”（其它 IDE 请替换为对应命令，如 Cursor 搜索 “Install 'cursor' command in PATH”）
确保 IDE 拥有安装扩展的权限