中文
文档
IDE 集成

IDE

VS Code、Cursor 及其他 IDE 的 OpenCode 扩展

OpenCode 可以与 VS Code、Cursor 或任何支持终端的 IDE 集成。只需在终端中运行 opencode 即可开始使用。


使用方法

  • 快速启动:使用 Cmd+Esc(Mac)或 Ctrl+Esc(Windows/Linux)在分割终端视图中打开 OpenCode,如果已有终端会话正在运行则聚焦到该会话。
  • 新会话:使用 Cmd+Shift+Esc(Mac)或 Ctrl+Shift+Esc(Windows/Linux)启动新的 OpenCode 终端会话,即使已有会话打开。你也可以点击 UI 中的 OpenCode 按钮。
  • 上下文感知:自动将当前选择或标签页与 OpenCode 共享。
  • 文件引用快捷键:使用 Cmd+Option+K(Mac)或 Alt+Ctrl+K(Linux/Windows)插入文件引用。例如 @File#L37-42

安装

在 VS Code 及流行的分支如 Cursor、Windsurf、VSCodium 上安装 OpenCode:

  1. 打开 VS Code
  2. 打开集成终端
  3. 运行 opencode - 扩展会自动安装

如果你想在从 TUI 运行 /editor/export 时使用自己的 IDE,需要设置 export EDITOR="code --wait"了解更多


手动安装

在扩展市场搜索 OpenCode 并点击 安装


故障排除

如果扩展无法自动安装:

  • 确保你在集成终端中运行 opencode
  • 确认你的 IDE 的 CLI 已安装:
    • VS Code:code 命令
    • Cursor:cursor 命令
    • Windsurf:windsurf 命令
    • VSCodium:codium 命令
    • 如果没有,运行 Cmd+Shift+P(Mac)或 Ctrl+Shift+P(Windows/Linux)并搜索"Shell Command: Install 'code' command in PATH"(或你的 IDE 对应的命令)
  • 确保 VS Code 有安装扩展的权限