跳转到内容

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:Cmd+Shift+Esc
    • Windows / Linux:Ctrl+Shift+Esc 即使已有 OpenCode 终端,也会再启动一个新会话。你也可以点击 IDE 中的 OpenCode 按钮。
  • 上下文感知: 插件可以自动将当前选中的代码或当前激活的文件上下文传给 OpenCode。

  • 文件引用快捷键

    • macOS:Cmd+Option+K
    • Windows / Linux:Alt+Ctrl+K 快速在输入中插入类似 @File#L37-42 的文件/行号引用,让 OpenCode 精确定位到当前编辑位置。

安装

在 VS Code / Cursor / Windsurf / VSCodium 中使用:

  1. 打开 IDE;

  2. 打开集成终端;

  3. 运行:

    Terminal window
    opencode

    首次运行时,插件会自动安装。

如果你希望在 TUI 中使用 /editor/export 时直接调用 IDE 编辑器,需要在 Shell 中设置:

Terminal window
export EDITOR="code --wait"

更多说明见 TUI 文档的编辑器设置


手动安装

也可以在扩展市场中搜索 OpenCode 并手动点击 Install 安装。


故障排查

如果自动安装失败,可以检查:

  • 是否在“集成终端”而不是外部终端中运行了 opencode
  • IDE 的命令行工具是否已安装:
    • VS Code:code
    • Cursor:cursor
    • Windsurf:windsurf
    • VSCodium:codium
  • 如果命令不存在,可以在 IDE 中按 Cmd+Shift+P(Mac)或 Ctrl+Shift+P(Windows/Linux),搜索:
    • “Shell Command: Install ‘code’ command in PATH” 或对应 IDE 的命令
  • 确认 IDE 具有安装扩展的权限(某些企业环境可能对此有限制)。