Skip to content

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 具有安装扩展的权限。