Skip to main content
OpenCode uses local opencode. Open Settings → CLI configuration → OpenCode CLI to detect the version, install, and configure credentials.

​
How to connect

  1. Use local config: read ~/.config/opencode/opencode.json (.jsonc is also supported). $OPENCODE_CONFIG wins
  2. Add provider: name, base URL, API key, model list
  3. You can override the opencode executable path
  4. You can move this engine to Disabled so it no longer appears in the input
  5. If it is not installed, click Install on that page, or install with the terminal commands below
OpenCode hosted providers use env injection and do not change opencode.json. Login and sessions still follow OpenCode’s own config.
Config stays on this computer. The app does not upload keys to a CC GUI server.

​
Add a provider

Click Add and fill in:
  • Name, base URL, API key
  • Model list (comma-separated; leave empty for no limit)
  • Optional: notes
Quick preset: OpenCode Zen (official).

​
Install

Alternative:
In-app Install previews the fallback npm install -g opencode-ai. The app does not uninstall OpenCode, so you do not delete login and session data by accident. Docs: https://opencode.ai/docs/

​
Capability differences

Compared with Claude Code:
  • No plan mode
  • Does not use desktop MCP
  • Supports session continue and image input
  • Stop ends the opencode child process
  • History is isolated per runtime

​
When detect fails

See Detect and install.

​
Next steps