Appearance
OpenCode 提供 VS Code 扩展，支持在 VS Code、Cursor、Windsurf、VSCodium 等 IDE 中无缝使用 OpenCode TUI。扩展在首次运行 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 终端会话 - 上下文感知：自动将当前选中的代码或当前打开的文件分享给 OpenCode
- 文件引用快捷键：
Cmd+Option+K（Mac）/Alt+Ctrl+K（Linux/Windows）插入文件引用，格式如@File#L37-42
安装
在 VS Code 及其流行 Fork（Cursor、Windsurf、VSCodium）中安装：
- 打开 VS Code
- 打开集成终端
- 运行
opencode——扩展会自动安装
如果你需要在 TUI 的 /editor 或 /export 命令中使用 VS Code 打开文件，还需要配置环境变量：
bash
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：
- 确保 VS Code 有权限安装扩展
常见问题
Q: OpenCode 扩展和其他 AI 编程扩展（如 Copilot、Cline）有什么区别？
A: OpenCode 扩展不是一个独立的 AI Chat 面板，而是把终端中运行的 OpenCode TUI 无缝嵌入 IDE，共享编辑器上下文（当前文件、选区）。你仍然在使用完整的 OpenCode，只是体验更流畅。
Q: 能和 Cursor 的 AI 功能同时使用吗？
A: 可以，它们互不干扰。OpenCode 扩展只是在侧边终端里运行 OpenCode，与 Cursor 的内置 AI 功能完全独立。
Q: 文件引用快捷键 @File#L37-42 是怎么工作的？
A: 按下快捷键后，扩展会根据当前光标位置或选区自动生成文件引用字符串并插入到 OpenCode 的输入框中，让 AI 能精确定位到代码的特定位置。