IDE

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

用法

• 快速启动：使用 Cmd+Esc（Mac）或 Ctrl+Esc（Windows/Linux）在分屏终端视图中打开 OpenCode，如果已有终端会话正在运行，则会自动聚焦到该会话。
• 新建会话：使用 Cmd+Shift+Esc（Mac）或 Ctrl+Shift+Esc（Windows/Linux）启动新的 OpenCode 终端会话，即使已有会话在运行也会新建。你也可以点击界面中的 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 有权限安装扩展