OpenCode 接入教程

开源的终端编程助手，在 opencode.json 里加一个自定义服务商即可

• 接口：OpenAI Chat Completions
• 地址写法：写到 /v1（https://gpt.cherrychat.org/v1）
• 推荐模型：claude-sonnet-5-5、gpt-6.1-sol
• 平台：macOS、Windows、Linux

接入步骤

1. 安装 OpenCode（装过可跳过）

   macOS / Linux 用官方脚本或 npm 安装；Windows 官方推荐在 WSL 里使用，也可以直接用 npm 安装。装好后运行 opencode --version 能看到版本号。

   macOS / Linux

   curl -fsSL https://opencode.ai/install | bash

   Windows

   npm install -g opencode-ai

2. 把 key 存进环境变量

   配置文件里用 {env:CHERRYCHAT_API_KEY} 引用 key，key 本身放在环境变量里。设完要关掉终端重新打开。

   • CHERRYCHAT_API_KEY（API Key）：sk-你的密钥

   macOS / Linux（写入 ~/.zshrc）

   echo 'export CHERRYCHAT_API_KEY="sk-你的密钥"' >> ~/.zshrc
   source ~/.zshrc

   Windows（设完重开 PowerShell）

   setx CHERRYCHAT_API_KEY "sk-你的密钥"

3. 写 opencode.json

   全局配置放在 ~/.config/opencode/opencode.json（用下面的命令打开）；原生 Windows 可以把 opencode.json 放在项目根目录，只对这个项目生效。粘进下面的内容保存。想加更多模型，照 models 里的格式再加一行。

   • options.baseURL（API 地址）：https://gpt.cherrychat.org/v1（写到 /v1 为止）
   • 模型名：claude-sonnet-5-5

   打开文件（macOS）

   mkdir -p ~/.config/opencode && touch ~/.config/opencode/opencode.json && open -e ~/.config/opencode/opencode.json

   opencode.json 内容

   {
     "$schema": "https://opencode.ai/config.json",
     "model": "cherrychat/claude-sonnet-5-5",
     "provider": {
       "cherrychat": {
         "npm": "@ai-sdk/openai-compatible",
         "name": "CherryChat",
         "options": {
           "baseURL": "https://gpt.cherrychat.org/v1",
           "apiKey": "{env:CHERRYCHAT_API_KEY}"
         },
         "models": {
           "claude-sonnet-5-5": { "name": "claude-sonnet-5-5" }
         }
       }
     }
   }

4. 启动并验证

   新开终端，进入项目文件夹运行下面的命令，能看到回复就成功了。交互使用时运行 opencode，输入 /models 可以看到并切换 CherryChat 下的模型。

   opencode run "用一句话介绍你自己"

容易踩的坑

• baseURL 写到 /v1（https://gpt.cherrychat.org/v1）；npm 用 @ai-sdk/openai-compatible，它走 Chat 接口。
• 顶层 "model" 的写法是「provider 名/模型名」，即 cherrychat/claude-sonnet-5-5；这个模型名还必须出现在 models 列表里。
• {env:…} 是 OpenCode 自己的写法（单层大括号）。也可以在 OpenCode 里运行 /connect → 选「Other」→ 填 cherrychat → 粘贴 key，这样 options 里就不用写 apiKey。
• OpenCode 2 仍然认这种写法；同一个 provider 里不要混用 2 代的 providers / package / settings 字段。
• 项目根目录的 opencode.json 优先于全局配置；两处都写了时以项目里的为准。

报错 → 原因 → 怎么办

教程核对于 2026-11-02。工具界面改版后可能和这里略有不同，以官方文档为准。

API 接入 · API 模型价格

Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 内容由 AI 生成，请仔细甄别