Skip to content

OpenCode

OpenCodesst/opencode)是 SST 团队做的开源 AI 编程 CLI(终端原生体验,类似 Claude Code)。

在配置前请先准备好 PrimeRouter API Key(参考 通用准备)。

安装

bash
# 全平台(需 Node 18+)
npm install -g opencode-ai
# 或:bun install -g opencode-ai
opencode --version

配置文件位置

系统配置文件路径
macOS~/.config/opencode/opencode.json
Linux~/.config/opencode/opencode.json
Windows%APPDATA%\opencode\opencode.json(即 C:\Users\<你>\AppData\Roaming\opencode\opencode.json

创建并编辑配置

bash
mkdir -p ~/.config/opencode
vim ~/.config/opencode/opencode.json
powershell
New-Item -ItemType Directory -Force -Path "$env:APPDATA\opencode" | Out-Null
notepad "$env:APPDATA\opencode\opencode.json"

把以下内容粘进去(Key 改成你自己的):

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "primerouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "PrimeRouter",
      "options": {
        "baseURL": "https://primerouter.ai/v1",
        "apiKey": "sk-你的primerouter-key"
      },
      "models": {
        "gpt-5.5":           { "name": "GPT-5.5"           },
        "gpt-5.4":           { "name": "GPT-5.4"           },
        "claude-opus-4-8":   { "name": "Claude Opus 4.8"   },
        "claude-opus-4-7":   { "name": "Claude Opus 4.7"   },
        "claude-opus-4-6":   { "name": "Claude Opus 4.6"   },
        "claude-sonnet-4-7": { "name": "Claude Sonnet 4.7" },
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}

启动并切模型

bash
opencode
# 进入 TUI 后输入:/model
# 选 primerouter/claude-sonnet-4-6 (或其他你列出的模型)

替代:交互式登录

不想手编 JSON 也可以:

bash
opencode auth login
# 选 "Other / Custom" 或 "OpenAI Compatible"
# Base URL: https://primerouter.ai/v1
# API Key:  sk-你的primerouter-key

手工编辑 JSON 适合多模型批量配置,交互式登录适合只配单模型。