中文
文档
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 并点击 Install


故障排除

如果扩展未能自动安装:

  • 确保你是在集成终端中运行 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 有安装扩展的权限