OpenCode 配置

OpenCode 原生支持 OpenAI 兼容 provider。图形界面用 opencode TUI / 桌面的 Providers 页，或 CC Switch。命令行改 opencode.json / 环境变量。

官方 Providers：https://opencode.ai/docs/providers/
官方 Config：https://opencode.ai/docs/config/

快速字段

项	值
baseURL	https://api.ashpetals.com/v1（必须含 /v1）
apiKey	sk-你的APIKey
npm 适配	@ai-sdk/openai-compatible
模型示例	gpt-5.6-sol
配置里的模型引用	ashpetals/gpt-5.6-sol（provider/model）

---

图形界面

OpenCode 自己的 UI

1. 启动 OpenCode（桌面或 TUI）。
2. 打开 Settings → Providers / 模型供应商（或命令面板里的 provider 配置）。
3. 添加 OpenAI compatible / Custom。
4. 填写：
   • Base URL：https://api.ashpetals.com/v1
   • API Key：sk-你的APIKey
   • 模型 ID：先 Fetch / 刷新列表，或手填 gpt-5.6-sol
5. 把默认模型设为 ashpetals/gpt-5.6-sol（前缀是你起的 provider id）。
6. 新开一轮会话再发消息。

没有独立 GUI 时，TUI 里用 /connect 或 /models 选自定义供应商（以你安装的 OpenCode 版本菜单名为准）。

CC Switch 桌面

顶部选 OpenCode → 添加 OpenAI 兼容供应商 → 地址 https://api.ashpetals.com/v1 → 启用。见 CC Switch。

---

命令行 / 配置文件

配置读取顺序（后者覆盖前者的同名字段，具体以官方 config 文档为准）：

1. 全局：~/.config/opencode/opencode.json（Windows：%USERPROFILE%\.config\opencode\opencode.json）
2. 环境：OPENCODE_CONFIG 指向的文件
3. 项目：仓库根目录 opencode.json

接本站建议写全局文件，避免每个仓库复制 Key。

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ashpetals": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AshPetals API",
      "options": {
        "baseURL": "https://api.ashpetals.com/v1",
        "apiKey": "sk-你的APIKey"
      },
      "models": {
        "gpt-5.6-sol": { "name": "GPT-5.6 Sol" },
        "gpt-5.5": { "name": "GPT-5.5" },
        "deepseek-v4-flash": { "name": "DeepSeek V4 Flash" }
      }
    }
  },
  "model": "ashpetals/gpt-5.6-sol"
}

模型 ID 必须与 GET /v1/models 完全一致。model 顶层值是 供应商id/模型id。

环境变量（临时）

export OPENAI_BASE_URL="https://api.ashpetals.com/v1"
export OPENAI_API_KEY="sk-你的APIKey"
opencode

长期使用仍建议写 opencode.json，环境变量容易被其它工具覆盖。

CC-Switch CLI

cc-switch --app opencode provider add
cc-switch --app opencode provider list
cc-switch --app opencode provider switch <id>

---

验证

opencode
# 选 ashpetals/gpt-5.6-sol，发送：ping

curl -sS https://api.ashpetals.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"ping"}]}'

---

注意事项

• baseURL 必须带 /v1。OpenCode 会再拼 /chat/completions。
• 模型 ID 必须与 /v1/models 返回一致；配置里写了但分组没有 → model_not_found。
• 推理模型会输出 thinking，请给够 max_tokens，避免被截断。
• 不要把 Key 写进项目 opencode.json 再提交 Git；全局文件也请限制权限（chmod 600）。
• 改 provider 后开新会话。