V1：每个模型独立配置文件#

最初为每个模型创建独立的 settings-模型名.json（qwen、doubao、kimi、glm、deepseek、minimax、hermes），共 7 个文件。切换时从对应文件读取 env + model，替换 settings.json 的对应字段。

问题：豆包通道的 5 个模型（doubao、kimi、glm、deepseek、minimax）Token 和 URL 完全相同，只有 model 名不同，维护了 5 个重复配置文件。

V2：三通道架构（当前）#

2026-05-09 重构为按通道分组，同一通道的模型共享 Token/URL 配置：

配置文件从 7 个精简为 4 个（doubao、qwen、ali-token、hermes），每个文件内用 modelDescriptions 记录该通道所有模型的描述文案。

V2 配置文件结构示例#

1
{
2
  "description": "豆包coding plan",
3
  "env": {
4
    "ANTHROPIC_AUTH_TOKEN": "7aab8f7f...",
5
    "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",
6
    "ANTHROPIC_MODEL": "doubao-seed-2.0-code"
7
  },
8
  "model": "doubao-seed-2.0-code",
9
  "modelDescriptions": {
10
    "doubao-seed-2.0-code": "doubao-seed-2.0-code：日常补完专家（次选）",
11
    "kimi-k2.6": "kimi-k2.6：长文本分析专家",
12
    "glm-5.1": "glm-5.1：代码生成专家",
13
    "deepseek-v3.2": "deepseek-v3.2：数学与逻辑推理专家",
14
    "minimax-m2.5": "minimax-m2.5：创意与写作专家"
15
  }
16
}

V2 switch-model.sh 核心逻辑#

所有切换统一走 switch_channel_model 函数，从通道配置文件读取 Token/URL，只替换 settings.json 的 env 和 model 字段，保留 hooks 等其他配置：

1
switch_channel_model() {
2
    local channel="$1"
3
    local model="$2"
4
    local config_file="$3"
5

6
    local auth_token=$(jq -r '.env.ANTHROPIC_AUTH_TOKEN' "$config_file")
7
    local base_url=$(jq -r '.env.ANTHROPIC_BASE_URL' "$config_file")
8
    local channel_desc=$(jq -r '.description // ""' "$config_file")
9

10
    cp "$SETTINGS_FILE" "$SETTINGS_FILE.backup"
11

12
    jq --arg token "$auth_token" \
13
       --arg url "$base_url" \
14
       --arg model "$model" \
15
       '.env.ANTHROPIC_AUTH_TOKEN = $token |
16
        .env.ANTHROPIC_BASE_URL = $url |
17
        .env.ANTHROPIC_MODEL = $model |
18
        .model = $model' \
19
       "$SETTINGS_FILE" > "${SETTINGS_FILE}.tmp" && mv "${SETTINGS_FILE}.tmp" "$SETTINGS_FILE"
20

21
    echo "已切换到${channel_desc}: $model"
22
    show_current
23

24
    local desc=$(jq -r --arg model "$model" '.modelDescriptions[$model] // ""' "$config_file")
25
    [ -n "$desc" ] && echo "$desc"
26
}

V3：豆包备用 key 通道#

2026-05-09 新增豆包 Coding Plan 的备用 API key，当主 key 限额用完时可以快速切换。

做法：创建 settings-doubao-alt.json，Token 不同但 URL、模型列表、描述文案与主 key 完全一致。脚本里新增 *-alt case 走这个配置文件。

新增 alias 命名规则：switch-doubao-alt-*，与主 key 的 switch-doubao-* 对称。

V3 .zshrc 快捷命令#

1
# 豆包 Coding Plan (主 key)
2
alias switch-doubao='~/.claude/switch-model.sh doubao'
3
alias switch-doubao-kimi='~/.claude/switch-model.sh kimi'
4
alias switch-doubao-glm='~/.claude/switch-model.sh glm'
5
alias switch-doubao-deepseek='~/.claude/switch-model.sh deepseek'
6
alias switch-doubao-minimax='~/.claude/switch-model.sh minimax'
7

8
# 豆包 Coding Plan (备用 key)
9
alias switch-doubao-alt='~/.claude/switch-model.sh doubao-alt'
10
alias switch-doubao-alt-kimi='~/.claude/switch-model.sh kimi-alt'
11
alias switch-doubao-alt-glm='~/.claude/switch-model.sh glm-alt'
12
alias switch-doubao-alt-deepseek='~/.claude/switch-model.sh deepseek-alt'
13
alias switch-doubao-alt-minimax='~/.claude/switch-model.sh minimax-alt'
14

15
# 阿里百炼 Coding Plan
16
alias switch-bailian='~/.claude/switch-model.sh bailian-qwen'
17
alias switch-bailian-coder='~/.claude/switch-model.sh bailian-coder'
18
alias switch-bailian-glm='~/.claude/switch-model.sh bailian-glm'
19

20
# 阿里 Token Plan
21
alias switch-token='~/.claude/switch-model.sh token-qwen'
22
alias switch-token-deepseek='~/.claude/switch-model.sh token-deepseek'
23
alias switch-token-glm='~/.claude/switch-model.sh token-glm'
24
alias switch-token-image='~/.claude/switch-model.sh token-image'
25

26
alias current-model='~/.claude/switch-model.sh'

坑1：直接用 sed 修改 config.yaml 导致 provider 名称错误#

一开始尝试直接用 sed 替换 provider 名称为 “volcengine”，但 Hermes 不认识这个 provider，报 404 错误。

解决：始终使用 “dashscope” provider 名称，只修改里面的配置内容（base_url、model、token）。

坑2：直接编辑 config.yaml 不如用 hermes 命令#

手动编辑 config.yaml 可能会有格式问题或者遗漏某些配置项。

解决：改用 hermes config set 命令来修改配置，这样更可靠。

坑3：.env 文件中的 token 需要同步更新#

不同模型可能使用不同的 token，切换模型时需要同步更新 Hermes 的 ANTHROPIC_AUTH_TOKEN。

解决：在 switch-model.sh 中用 sed 自动更新 .env 文件。

坑4（2026-05-09）：switch_doubao_model 覆盖了 settings.json 的全部内容#

V2 重构时，switch_doubao_model 从 settings-doubao.json 读取配置后写入 settings.json，但 settings-doubao.json 只有 env + model + modelDescriptions，没有 hooks、statusLine 等字段。写入后 settings.json 丢失了所有 hooks 配置，导致 /doctor 报 “Invalid or malformed JSON” 错误。

根因：脚本用 jq 从 doubao 模板生成完整的 settings.json 输出，覆盖了原有文件。

解决：改为用 jq 只替换 settings.json 中的 env 和 model 字段（.env.ANTHROPIC_AUTH_TOKEN = $token | .env.ANTHROPIC_BASE_URL = $url | .env.ANTHROPIC_MODEL = $model | .model = $model），保留 hooks 等其他字段不变。

教训：settings-*.json 是模板文件，不是完整的 settings 替代品。切换模型时必须只改 env + model，不能整个文件覆盖。

坑5（2026-05-09）：macOS 默认 bash 3.x 不支持 declare -A#

脚本中使用了 declare -A（关联数组），但 macOS 自带 bash 3.x 不支持。

解决：改用 case 语句 + get_doubao_model() 函数实现模型名映射。

坑6（2026-05-09）：ANTHROPIC_BASE_URL 不应包含 /messages 后缀#

阿里 Token Plan 的 URL 末尾带了 /messages，但 SDK 会自动拼接 /messages，导致实际请求的路径变成 /v1/messages/messages。

解决：ANTHROPIC_BASE_URL 只写到 /v1，去掉末尾的 /messages。

坑7（2026-06-01）：健康检查使用 OpenAI 格式导致 404#

2026-06-01 发现 switch-bailian 和 switch-doubao-kimi 切换时返回 404 错误。

根因：switch-model.sh 的健康检查使用 OpenAI 格式（/v1/chat/completions + Authorization: Bearer），但所有通道的 endpoint 都支持 Anthropic 格式，Claude Code 实际发送的也是 Anthropic 格式请求。

解决：将健康检查改为 Anthropic 格式：

1
# 改为 /v1/messages + x-api-key + anthropic-version 头
2
local probe_url="$base_url/v1/messages"
3
probe_result=$(curl -s -w "\n%{http_code}" -X POST "$probe_url" \
4
    -H "Content-Type: application/json" \
5
    -H "x-api-key: $auth_token" \
6
    -H "anthropic-version: 2023-06-01" \
7
    -d "{\"model\":\"$model\",\"max_tokens\":1,\"messages\":[{\"role\":\"user\",\"content\":\"hi\"}]}" \
8
    2>/dev/null)

坑8（2026-06-01）：kimi-k2.6 在 DashScope 端点返回 400#

switch-doubao-kimi 切到 kimi 后 Claude Code 报错 model kimi-k2.6 is not supported。

根因：settings-doubao.json 被误操作覆盖，ANTHROPIC_BASE_URL 变成了 DashScope 地址（coding.dashscope.aliyuncs.com/apps/anthropic），但 DashScope 不支持 kimi 模型。kimi 只能走 VolcEngine 端点。

解决：从备份恢复 settings-doubao.json，确保 ANTHROPIC_BASE_URL 为 https://ark.cn-beijing.volces.com/api/coding，ANTHROPIC_AUTH_TOKEN 为 ark- 开头的 VolcEngine token。

坑9（2026-06-01）：jq 误操作覆盖了 kimi 配置#

调试时用 jq 命令直接修改了 settings-doubao.json，意外把 kimi 的配置覆盖掉了。

教训：修改配置文件前必须 cp 备份，不要直接在原文件上做实验性修改。从 .bak 备份恢复后确认所有模型的 Token/URL 正确。

坑10（2026-06-01）：settings-doubao-alt.json 备用 key token 丢失 + 前缀错误#

settings-doubao-alt.json 的 token 先被恢复成了和主 key 相同的值，然后手动修正时又加错了 ark- 前缀。

正确格式：

URL 相同，token 不同。注意备用 key 的原始值不带 ark- 前缀，不要自己加。两个 kimi key 配额重置时间也不同（主 key 6-09，备用 key 6-06）。