IDE

IDE

// IDE 集成文档 // OpenCode 支持 VS Code、Cursor 等主流 IDE 的终端集成

The OpenCode extension for VS Code, Cursor, and other IDEs

OpenCode integrates with VS Code, Cursor, or any IDE that supports a terminal. Just run opencode in the terminal to get started.

---

Usage

// IDE 集成的主要功能和使用方式

• Quick Launch: Use Cmd+Esc (Mac) or Ctrl+Esc (Windows/Linux) to open OpenCode in a split terminal view, or focus an existing terminal session if one is already running.
• New Session: Use Cmd+Shift+Esc (Mac) or Ctrl+Shift+Esc (Windows/Linux) to start a new OpenCode terminal session, even if one is already open. You can also click the OpenCode button in the UI.
• Context Awareness: Automatically share your current selection or tab with OpenCode.
• File Reference Shortcuts: Use Cmd+Option+K (Mac) or Alt+Ctrl+K (Linux/Windows) to insert file references. For example, @File#L37-42.

---

Installation

// 安装 OpenCode 扩展的两种方式：自动和手动

To install OpenCode on VS Code and popular forks like Cursor, Windsurf, VSCodium:

1. Open VS Code
2. Open the integrated terminal
3. Run opencode - the extension installs automatically

If on the other hand you want to use your own IDE when you run /editor or /export from the TUI, you’ll need to set export EDITOR="code --wait".

Manual Install

// 在扩展市场手动搜索安装

Search for OpenCode in the Extension Marketplace and click Install.

---

Troubleshooting

// 扩展安装失败的排查步骤

If the extension fails to install automatically:

• Ensure you’re running opencode in the integrated terminal.
• Confirm the CLI for your IDE is installed:
  • For VS Code: code command
  • For Cursor: cursor command
  • For Windsurf: windsurf command
  • For VSCodium: codium command
  • If not, run Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux) and search for “Shell Command: Install ‘code’ command in PATH” (or the equivalent for your IDE)
• Ensure VS Code has permission to install extensions