鸽子中转站配置文档

OpenCode 桌面端和 CLI 共用同一个配置目录。你已经有配置文件时，直接编辑它，不要为了接入中转站再新建第二份 JSON。

1. 打开已有配置

1. 1
   完全退出 OpenCode

   桌面端请退出窗口和托盘进程，CLI 也不要保持运行。

2. 2
   打开配置目录

   按 Win + R，输入 C:\Users\你的用户名\.config\opencode 并回车。也可以从“此电脑 → C 盘 → 用户 → 你的用户名 → .config → opencode”一层层打开。

3. 3
   保留原内容

   不要把原来的 plugin、mcp、命令和其他供应商清空；只在对应位置增加或修改字段。

2. 修改原来的配置文件

右键配置文件，选择“打开方式 → 记事本”。如果里面已经有 plugin、mcp 或其他供应商，不要删除；看不懂如何合并时，把打码后的原文件发给群主协助处理。

{
  // OpenCode 配置文件格式说明。
  "$schema": "https://opencode.ai/config.json",

  // 默认使用的模型，格式为：供应商ID/模型ID。
  "model": "doveli/gpt-5.6-sol",

  // 自动压缩上下文，适合持续时间较长的对话和编程任务。
  "compaction": {
    // 开启后，在上下文即将达到限制时自动进行压缩。
    "auto": true,

    // 自动清理较早的工具调用输出，减少不必要的上下文占用。
    "prune": true
  },

  "provider": {
    // doveli 是自定义供应商 ID，可以改名，但上面的 model 前缀也要同步修改。
    "doveli": {
      "name": "鸽子中转站",

      // 使用 OpenAI 兼容接口。
      "npm": "@ai-sdk/openai-compatible",

      "options": {
        // 中转站接口地址必须保留结尾的 /v1。
        "baseURL": "https://api.doveli.top/v1",

        // 把下面的中文替换成自己在网站创建的 API Key。
        // 请勿把填写过真实 API Key 的配置文件发送给他人。
        "apiKey": "请在这里填写你的中转站API Key"
      },

      "models": {
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol",
          "limit": {
            // 上下文容量。不了解模型真实上限时，建议先使用 128000。
            "context": 128000,

            // 单次回答允许的最大输出容量。
            "output": 32768
          }
        },

        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna",
          "limit": {
            "context": 128000,
            "output": 32768
          }
        },

        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra",
          "limit": {
            "context": 128000,
            "output": 32768
          }
        },

        "claude-fable-5": {
          "name": "Claude Fable 5",
          "limit": {
            "context": 128000,
            "output": 32768
          }
        }
      }
    }
  }
}

3. 保存后确认是否成功

1. 保存原文件，重新打开 OpenCode 桌面端或 CLI。
2. 输入 /models，确认能看到 doveli / gpt-5.6-sol。
3. 发送“只回复 OK”。如果提示模型不存在，在 /models 中重新选择中转站实际显示的模型。

Hermes 不需要修改 JSON，直接在设置界面填写中转站地址、模型和 API Key。

1. 1
   打开自定义端点

   进入“设置 → 提供方 → 自定义端点”。已经有鸽子中转站就编辑原来的端点，没有才点击新增。

2. 2
   填写地址和模型

   Endpoint URL 填 https://api.doveli.top/v1；Provider ID 可填 doveli；默认模型选择中转站实际提供的模型。

3. 3
   填写 Key 并保存

   API Key 填网站创建的密钥，Context 保持 Auto；勾选“用于新对话”和“发现模型”，点击 Test，成功后 Save 和 Use。

Codex++ 是图形化客户端。已经有供应商时直接编辑原卡片；没有供应商才点击“新增”，不要反复创建同一个中转站。

1. 打开供应商配置

1. 1
   进入“供应商配置”

   左侧选择“供应商配置”，打开现有供应商；需要新增时才点击“添加供应商”。

2. 2
   类型选择“纯 API”

   配置模型填写实际模型 ID，例如 gpt-5.6-sol，不要在模型后面追加版本说明或中文名称。

3. 3
   填写 Base URL 和 Key

   Base URL 必须是 https://api.doveli.top/v1，Key 填你在鸽子中转站创建的 API Key。

2. 保存并检查模型

1. 点击“保存”，必要时点击“获取默认模型”或“获取模型列表”。
2. 如果获取不到模型，优先检查 URL 是否写成了 /v1/v1，以及分组是否开放 Responses。
3. 如果 Codex++ 的高级配置里有上下文选项，可以使用下面这组配置；没有看到这些选项就不用额外寻找。

model_context_window = 400000
model_auto_compact_token_limit = 330000
model_reasoning_effort = "xhigh"

CC Switch 是帮助 Claude Code 或 Codex 填写、切换供应商的图形化工具，它本身不是 Agent。不同上游格式的选项不能照抄，先看清楚供应商提供的是 OpenAI 格式还是 Claude 格式。

Claude Code：通过 CC Switch 接入

下面演示的是让 Claude Code 使用 OpenAI 格式中转：CC Switch 会在电脑本地进行路由转换。如果你使用的是 Claude/Anthropic 格式上游，请保留默认格式，不需要选择 OpenAI Responses。

1. 编辑或添加供应商

1. 1
   选择 Claude Code

   在 CC Switch 顶部或应用选择器中进入 Claude Code，打开已有供应商卡片编辑；没有才点击“+”新增。

2. 2
   请求地址不要写 /v1

   填写 https://api.doveli.top，不要写成 https://api.doveli.top/v1。

3. 3
   按上游格式选择 API 格式

   本教程使用 OpenAI 格式，因此在高级设置中选择“OpenAI Responses API（需开启路由）”，认证字段按默认选择 ANTHROPIC_AUTH_TOKEN。Claude/Anthropic 格式上游不要选择这一项。

2. 获取模型并映射

1. 点击“获取模型列表”，等待模型返回。
2. 把 Sonnet、Opus、Fable、Haiku 等角色映射到实际模型 ID，例如 gpt-5.6-sol、gpt-5.6-terra。
3. 只有上游明确支持 1M 上下文时才勾选“1M”；不确定时保持关闭。
4. 点击“添加”或“保存”，再启用该供应商。

3. 开启本地路由

1. 1
   进入设置 → 路由

   打开“路由总开关”。

2. 2
   启用 Claude

   在“路由应用”里只打开 Claude；Codex 如果不走本地路由，不要一起打开。

3. 3
   重新启动 Claude Code

   关闭旧终端和 Claude Code，再重新打开，让路由接管生效。

Codex：直接使用 Responses

Codex 的配置和 Claude Code 不同：地址带 /v1，选择 Responses API，不需要为 Codex 打开 Claude 路由。

1. 进入 Codex 供应商编辑界面，打开“更多选项”。
2. Base URL 填 https://api.doveli.top/v1。
3. 填写 API Key，点击获取默认模型或模型列表。
4. 上游协议选择 Responses API，保存后重新启动 Codex。