IDE 集成

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

---

用法 Usage

• Quick Launch (快速启动): 使用 Cmd+Esc (Mac) 或 Ctrl+Esc (Windows/Linux) 在拆分终端视图中打开 OpenCode，或者如已有终端会话正在运行则聚焦于它。
• New Session (新会话): 使用 Cmd+Shift+Esc (Mac) 或 Ctrl+Shift+Esc (Windows/Linux) 启动新的 OpenCode 终端会话，即使已有一个已打开。你也可以点击 UI 中的 OpenCode 按钮。
• Context Awareness (上下文感知): 自动与 OpenCode 分享你当前的选择或标签页。
• File Reference Shortcuts (文件引用快捷键): 使用 Cmd+Option+K (Mac) 或 Alt+Ctrl+K (Linux/Windows) 插入文件引用。例如，@File#L37-42。

---

安装 Installation

要在 VS Code 以及像 Cursor、Windsurf、VSCodium 这样的流行 fork 上安装 OpenCode：

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

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

---

手动安装 Manual Install

在扩展市场中搜索 OpenCode 并点击 Install。

---

故障排除 Troubleshooting

如果扩展自动安装失败：

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