IDE 终端扩展

任何带终端的编辑器都可以运行 opencode。VS Code、Cursor、Windsurf 与 VSCodium 还可通过扩展获得终端启动、当前选区和文件引用集成。

安装

1. 先确保 OpenCode CLI 已安装。
2. 在编辑器的集成终端运行 opencode，支持的 VS Code 系编辑器会自动安装扩展。
3. 自动安装不可用时，在 Extension Marketplace 搜索 OpenCode 并安装。

若需要在编辑器原生 Agent 面板中工作，另看ACP 接入，它与终端扩展是不同入口。

快捷操作

也可以点击 OpenCode 按钮创建新会话。文件引用可以包含行范围，例如 @File#L37-42。扩展会将当前选区或标签页作为上下文提供给 OpenCode。

使用外部编辑器

TUI 的 /editor 与 /export 依赖 EDITOR；例如 VS Code 需要等待编辑完成：

export EDITOR="code --wait"

仅安装扩展不会代替外部编辑器配置。其他编辑器的等待方式见终端交互界面。

自动安装失败

先确认命令运行于编辑器集成终端，然后检查该编辑器 CLI 是否在 PATH：VS Code 为 code、Cursor 为 cursor、Windsurf 为 windsurf、VSCodium 为 codium。

可以从命令面板搜索安装 shell command 的操作，例如 Shell Command: Install 'code' command in PATH；其他编辑器使用对应命令。还需确认编辑器具有安装扩展的权限。