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