gettokens-claude-code-account-list

name	gettokens-claude-code-account-list
description	GetTokens Claude Code 账号列表：Claude Channel Routing、Anthropic 格式账号筛选、请求顺序、两模式路由、项目绑定兼容边界、路由探测、模型映射、官方默认模型 profile 与 local apply 边界。

GetTokens Claude Code Account List

当任务涉及 Claude Code 账号列表、Claude Channel Routing、Claude Code relay 账号请求顺序、Anthropic 格式账号筛选、Claude Code route mode、项目绑定、模型映射、官方默认模型 profile、~/.claude/settings.json local apply 或 Claude Code 路由探测时使用本 skill。

1. 业务边界

• Claude Code 账号列表不是 settings.json 多 key 管理器。
• 它是 GetTokens relay 可供 Claude Code 使用的 Anthropic 格式 Channel Routing 工作台。
• 总账号池只管理 Account Inventory；Claude Code 账号列表拥有 Claude 渠道顺序、渠道 route mode、渠道组状态、项目绑定、dry-run/explain 和 probe。
• Claude 渠道配置不得通过全局 UpdateAccountPriority 表达；渠道顺序必须保存到 Claude channel config。
• Claude runtime routing 的唯一主路径是 channel-routing/config.json；旧 routing.strategy 只保留作 relay / compatibility 边界，不再参与 Claude 候选排序、fallback 或 balanced 计数。balanced 模式应从 live-session tracker 读取活跃会话数，而不是从展示用 snapshot 反推。
• 新 GetTokens route mode 主路径只允许 sequential / balanced。
• project 已从可配置 route mode 下线；历史 projectBindings 只作为项目名到账号/账号组的范围约束或兼容数据保留，不能作为新的模式入口扩展。
• dedicated / prefer / ordered / weighted / canary 只作为上游兼容输入，不进入 Claude 新 UI / Wails DTO / engine policy。
• exclude 不是 route mode，只能作为请求级 deny 或 pool filter。
• 旧 allow / deny / order / fallback 只作为请求级兼容 policy，不作为新页面主配置模型。
• 禁用优先级高于 session sticky、失败降级和 retry；禁用账号或禁用组不能被 sticky / fallback 继续使用。
• 激活账号只重新进入可路由账号池，等待下一轮 route / retry，不抢占当前 stream / sticky。
• 失败冷却状态必须持久化到运行态或 guard source；401/429/5xx/model-unavailable 后续请求和 explain 都应读取同一冷却状态，自动恢复不能清 manual-disabled。
• P0 账号筛选条件：AccountRecord.supportedFormats 包含 anthropic。
• Claude Code 本地仍只写一个 relay endpoint / relay key；多账号轮换发生在 GetTokens relay 内。
• 不把 provider 名称等于 claude 作为筛选条件。

2. 账号列表语义

• 候选来源以统一 AccountRecord 为入口：
  • supportedFormats 包含 anthropic
  • 存在可用于 relay 的凭证或 auth route id
  • 请求出口优先 formatBaseUrls.anthropic，没有时回退 baseUrl
• 请求顺序使用 Claude channel config，不复用全局账号 priority：
  • 禁用或阻塞账号保留在排序中
  • 运行时请求候选只包含当前可请求账号
  • 拖拽排序写回 Claude channel config
  • 启停写回 SetAccountDisabled
• 项目绑定只限定目标账号或账号组；命中账号组后，组内选择继续使用 sequential 或 balanced。
• 浏览器 preview 必须在缺少 Wails runtime 时稳定显示 preview 数据。

3. 模型映射语义

• UI 展示方向：真实上游模型 name -> Claude Code 请求模型 alias。
• 运行时解析方向：Claude Code 请求模型 alias -> 真实上游模型 name。
• API key / openai-compatible 账号优先复用账号配置内的 models[]：
  • models[].name 是真实上游模型
  • models[].alias 是 Claude Code 请求模型
• OAuth/auth-file 账号优先复用 sidecar oauth-model-alias，Claude Code channel 默认为 claude。
• 默认同名透传，不展示或保存 model -> model。
• 保存时按 name + alias 去重，允许同一个真实模型映射到多个 Claude Code alias。

4. 官方默认模型 profile

• 官网给出的默认值就是 ProviderDefaultModelProfile 的权威值。
• 官网列出的其他模型只叫“官方可切换模型”，不叫默认候选。
• 本地 cc-switch / GetTokens 旧预设只用于迁移差异提示，不参与已有官网来源厂商的默认值决策。
• 远端 /models 只能刷新可切换模型集合，不能覆盖官网默认值或用户已保存映射。
• profile 可一键填充 Claude Code local apply 字段，也可生成 relay 映射草稿；保存仍走 models[] 或 oauth-model-alias。
• 已保存的用户映射优先级最高；profile 更新只能提示，不能自动覆盖。
• 官方默认值表维护在 docs-linhay/spaces/20260519-claude-code-account-list/plans/official-model-profiles.md。
• 官方模型 profile 和 local apply 不并入共享 channel routing 模型；它们仍属于 Claude Code 领域逻辑。
• DeepSeek、Kimi、MiniMax、Doubao、StepFun、Xiaomi MiMo API / Token Plan 与 Zhipu GLM Coding Plan 是已验证的 Claude Code 官方直连模板：local apply 写账号自身 API Key 与 formatBaseUrls.anthropic，auth field 使用 ANTHROPIC_AUTH_TOKEN；不得写 GetTokens 本地 relay URL。Xiaomi Token Plan 默认示例为 https://token-plan-cn.xiaomimimo.com/anthropic，但用户订阅页专属 Base URL 优先。Zhipu 默认示例为 https://open.bigmodel.cn/api/anthropic，并写 API_TIMEOUT_MS=3000000；MiniMax 中国区默认示例为 https://api.minimaxi.com/anthropic，并写 API_TIMEOUT_MS=3000000。

5. 当前官方校准结论

• DeepSeek：deepseek-v4-pro[1m] 为 main/sonnet/opus，deepseek-v4-flash 为 haiku；CLAUDE_CODE_SUBAGENT_MODEL / CLAUDE_CODE_EFFORT_LEVEL 只属于 local apply extra env。
• 百炼：按 Token Plan / Coding Plan / Pay-as-you-go 分 profile，默认模型为 qwen3.6-plus，haiku 视官方场景为 qwen3.6-plus 或 qwen3.6-flash。
• MiniMax：MiniMax-M3，中国区 Anthropic Base URL 为 https://api.minimaxi.com/anthropic，国际区为 https://api.minimax.io/anthropic，local apply 需写 API_TIMEOUT_MS=3000000。
• Xiaomi MiMo：默认值为 mimo-v2.5-pro，main/haiku/sonnet/opus 都写 mimo-v2.5-pro；mimo-v2.5-pro[1m] 是官方长上下文变体，mimo-v2.5 / mimo-v2.5-tts 是官方可切换模型。
• Zhipu GLM Coding Plan：ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic，auth field 为 ANTHROPIC_AUTH_TOKEN，API_TIMEOUT_MS=3000000；默认 profile 按官方模型切换示例使用 main/sonnet/opus=glm-5.2[1m]、haiku=glm-4.5-air。
• Kimi：当前已确认官方 Claude Code env 示例为 kimi-k2.7-code；本地 kimi-k2.6 / kimi-k2.5 只作旧预设差异提示。
• Doubao：默认按官网 ark-code-latest 或用户选择的具体 Model_Name；本地 doubao-seed-2-0-code-preview-latest 只作迁移提示。
• StepFun：当前已确认官方 Step Plan Claude Code env，ANTHROPIC_BASE_URL=https://api.stepfun.com/step_plan，默认模型采用 step-3.7-flash。

6. 验证

• 文档或需求调整后运行：
  • docs-linhay/scripts/check-docs.sh
• 前端实现后至少覆盖：
  • Anthropic 格式筛选
  • 禁用保留排序但不参与运行候选
  • formatBaseUrls.anthropic 优先级
  • 模型映射同名透传
  • 同一真实模型多个 Claude alias
  • 官方默认 profile 不覆盖用户映射
  • Claude channel config 保存不影响 Codex channel config
  • ChannelRouteMode 只接受 sequential / balanced；project 输入必须降级或标记为旧兼容输入
  • 上游兼容模式不进入 Claude 新配置保存