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。

在 Cursor 中使用 OpenCode

Cursor 是 VS Code 的分支（fork），设置方式完全相同：

1. 打开 Cursor 并启动集成终端。
2. 运行 opencode——扩展会自动安装。
3. 如果自动安装失败，请确认 cursor 命令行工具可用：按 Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Windows/Linux），搜索 "Shell Command: Install 'cursor' command in PATH"。

所有快捷键与 VS Code 中一致，包括快速启动（Cmd+Esc / Ctrl+Esc）和文件引用（Cmd+Option+K / Alt+Ctrl+K）。同样的步骤也适用于 Windsurf、VSCodium 等其他 VS Code 分支。

故障排除

如果扩展未能自动安装：

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