Cherry Studio / Continue / Roo Code / 其它 AI IDE 插件

这类工具大多是 OpenAI 兼容协议，接入套路一致。

Cherry Studio（桌面 chat + 知识库）

1. 设置 → 模型服务 → 添加 → 选 OpenAI 类型
2. 填：
   • API Host：https://api.226-ai.com（Cherry Studio 会自动拼 /v1/chat/completions）
   • API Key：sk-你的token
3. 点检查按钮验证
4. 添加模型到该 Provider：
   • claude-sonnet-4-6
   • claude-opus-4-7
   • claude-haiku-4-5-20251001
   • gemini-3-flash

在主界面左下角切模型即可。

Cherry Studio 的知识库

Cherry 的知识库用 embedding 做检索。我们 embedding 模型要等 OpenAI 渠道上线（text-embedding-3-small 等）。目前可先用本地向量（Cherry 支持 Ollama 跑 nomic-embed），对话模型接 226-ai。

Continue（VS Code / JetBrains 插件）

编辑 ~/.continue/config.yaml（新版）或 ~/.continue/config.json（旧版）：

新版 YAML：

models:
  - name: Claude Sonnet 4.6
    provider: openai
    model: claude-sonnet-4-6
    apiBase: https://api.226-ai.com/v1
    apiKey: sk-你的token
    
  - name: Claude Opus 4.7
    provider: openai
    model: claude-opus-4-7
    apiBase: https://api.226-ai.com/v1
    apiKey: sk-你的token

  - name: Haiku (autocomplete)
    provider: openai
    model: claude-haiku-4-5-20251001
    apiBase: https://api.226-ai.com/v1
    apiKey: sk-你的token
    roles: [autocomplete]

tabAutocompleteModel: Haiku (autocomplete)

旧版 JSON 结构类似，去官方文档对照。

Roo Code（VS Code 的 Claude Code 替代）

1. Roo Code 面板 → 设置 → API Provider：选 Anthropic 或 OpenAI-Compatible
2. 选 Anthropic（走 /v1/messages）：
   • Base URL：https://api.226-ai.com
   • API Key：sk-你的token
   • Model：claude-sonnet-4-6
3. 选 OpenAI-Compatible：
   • Base URL：https://api.226-ai.com/v1
   • API Key：sk-你的token
   • Model ID：claude-sonnet-4-6

推荐走 Anthropic 端点（工具调用、prompt caching 都原样转发最完整）。

Zed Editor

Zed 原生支持 Anthropic。编辑 ~/.config/zed/settings.json：

{
  "language_models": {
    "anthropic": {
      "api_url": "https://api.226-ai.com",
      "version": "2023-06-01",
      "available_models": [
        {"name": "claude-sonnet-4-6", "max_tokens": 200000},
        {"name": "claude-opus-4-7", "max_tokens": 200000}
      ]
    }
  }
}

在 Zed 的 Agent 面板右下角切模型。API Key 走 Zed 的凭据管理：Cmd+? → Claude → API Key。

JetBrains AI Assistant（IDEA / PyCharm 系）

需要 JetBrains AI 订阅才能走自定义 Base URL。不订阅时只能走 JetBrains 自家 gateway。 （对 226-ai 用户不推荐，用 Continue 插件代替更灵活。）

通用原则

一切支持"自定义 Base URL + API Key"的 OpenAI 兼容客户端都能接入，只要：

• api_base / base_url / api_host 字段填 https://api.226-ai.com/v1（注意 /v1）
• api_key 字段填 sk-你的token
• 在该客户端的模型选择里手动加我们的模型名（他家预置列表不会有）

遇到没列出的工具，找"OpenAI Compatible" / "Azure OpenAI" 配置入口照此办理基本都能通。

两个排错万能键

1. 客户端连不上：直接 curl https://api.226-ai.com/v1/chat/completions -H "Authorization: Bearer sk-xxx" -d '{...}' 从命令行先通一发。能通 → 客户端配置问题。不通 → 网络 / token 问题。
2. 客户端通了但回复很短 / 很奇怪：去 console.226-ai.com → 日志查那条请求，看 model 字段、看 max_tokens、看 finish_reason。length 就是 max_tokens 太低截了。