ShiBin's Wiki

Appearance

Published at:

附录 E：cc-switch 配置速查卡 ​

cc-switch 是 Claude Code 的 GUI 模型切换工具，通过可视化界面管理 AI 模型配置，在 DeepSeek（省钱）和 Anthropic 官方模型（高质量）之间无缝切换。

安装 ​

项目内容
GitHubhttps://github.com/farion1231/cc-switch
下载页https://github.com/farion1231/cc-switch/releases
Windows 安装包CC-Switch-v{version}-Windows.msi
Windows 免安装CC-Switch-v{version}-Windows-Portable.zip（解压即用）

安装后启动 cc-switch，左侧应用列表中选择 Claude Code 即可开始配置。

GUI 配置步骤 ​

以下步骤来自第 3 章，在 cc-switch 中配置 DeepSeek API 接入：

步骤操作说明
1选中 Claude Code左侧应用列表中选择 Claude Code
2添加模型Anthropic 官方模型已内置，直接切换即可；此步用于添加第三方模型（DeepSeek）
3填写 API 信息API endpoint: https://api.deepseek.com/anthropic，API key: sk-xxx
4配置模型映射Haiku → deepseek-v4-flash，Sonnet → deepseek-v4-flash/deepseek-v4-pro，Opus → deepseek-v4-pro[1m]
5保存配置确保开关已开启
6拖动排序列表顶部的模型成为当前使用的模型，拖动即可切换
7验证打开 VSCode 中 Claude Code，发送消息确认模型工作正常
8切换方案为不同场景保存多套配置（如"DeepSeek 日常"和"Anthropic 重要任务"），一键切换

模型映射表 ​

cc-switch 的核心原理是将 Claude Code 内部的三个模型档位重新映射到第三方模型。

DeepSeek 映射 ​

Claude Code 档位DeepSeek 模型适用场景
Haiku（快）deepseek-v4-flash批量任务、文档生成、简单重构
Sonnet（平衡）deepseek-v4-flash日常开发主力（性价比优先）
Sonnet（平衡）deepseek-v4-pro日常开发主力（质量优先）
Opus（强推理）deepseek-v4-pro[1m]复杂架构、深度调试、安全审查

Anthropic 官方映射（内置默认） ​

Claude Code 档位Anthropic 模型适用场景
Haiku（快）claude-haiku-4-5-20250514极简任务、快速响应
Sonnet（平衡）claude-sonnet-4-6-20250514日常开发、代码审查、默认选择
Opus（强推理）claude-opus-4-7-20250514复杂架构、深度推理、安全审计

成本速算 ​

模型输出价格（每 1M tokens）相对 Sonnet 的倍数
DeepSeek V4 Flash¥2.001/53
DeepSeek V4 Pro¥6.00（补贴价）1/18
Claude Sonnet 4.6¥105.001×
Claude Opus 4.7¥525.005×

常见配置方案 ​

方案 A：DeepSeek only（预算优先） ​

配置项值
适用人群个人开发者、学生、成本敏感用户
模型数量2（V4 Flash + V4 Pro）
月成本估算¥10-50
Haiku  → deepseek-v4-flash
Sonnet → deepseek-v4-pro
Opus   → deepseek-v4-pro[1m]

方案 B：Anthropic + DeepSeek 双模型（推荐） ​

配置项值
适用人群独立开发者、小团队
模型数量3（Sonnet + V4 Flash + V4 Pro）
月成本估算¥50-200
日常开发 → DeepSeek V4 Flash（便宜够用）
代码审查 → Claude Sonnet 4.6（质量保障）
复杂推理 → DeepSeek V4 Pro 或 Claude Opus（按需切换）

方案 C：All five models（全场景） ​

配置项值
适用人群资深用户、多角色开发者
模型数量5（Opus + Sonnet + Haiku + V4 Pro + V4 Flash）
月成本估算¥100-500
场景模型选择
简单问答、批量生成Haiku / V4 Flash
日常编码Sonnet / V4 Pro
代码审查Sonnet
复杂架构、深度调试Opus
中文场景、超长上下文V4 Pro

健康的使用量分布 ​

模型建议占比红线
Opus5-10%< 20%（避免高射炮打蚊子）
Sonnet50-60%主力区间
V4 Pro15-25%—
Flash10-15%< 40%（避免降级过度）
Haiku5%—

配置文件路径 ​

层级路径用途是否提交 Git
用户全局~/.claude/settings.json个人模型偏好、cc-switch 写入目标否
项目配置.claude/settings.json团队共享的模型策略是
本地覆盖.claude/settings.local.json本地密钥、调试端点否

cc-switch 本质上是 ~/.claude/settings.json 的 GUI 编辑器。理解这一点后，手动排查配置问题会容易得多。

DeepSeek 手动配置模板 ​

不使用 cc-switch 时，可直接编辑配置文件：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "model": "haiku"
}

模型切换方式速查 ​

切换方式粒度场景
cc-switch 拖动排序切换模型服务商/映射"今天用 DeepSeek，晚上用 Opus"
/ 菜单 Switch Model在 Haiku/Sonnet/Opus 间切换同一服务商内快速换档
手动编辑 settings.json完全自由配置CI/CD、远程服务器（无 GUI）

故障处理 ​

症状可能原因解决方法
Claude Code 无响应API Key 错误或过期检查 DeepSeek 平台 API Keys 页面，确认密钥有效
模型不符合预期cc-switch 被手动编辑覆盖先用 env | grep ANTHROPIC 检查环境变量，再检查 ~/.claude/settings.json
API 连接失败端点 URL 拼写错误确认 ANTHROPIC_BASE_URL 为 https://api.deepseek.com/anthropic（注意 https:// 和末尾无斜杠）
频繁超时DeepSeek 推理较慢 + 超时设置过短将 API_TIMEOUT_MS 设为 3000000（50 分钟）
登录弹窗反复出现cc-switch 配置了认证但 VSCode 仍在弹窗在 VSCode 设置中启用 claudeCode.disableLoginPrompt: true
cc-switch 配置被重置手动编辑 settings.json 后 cc-switch 又改回去关闭 cc-switch 后再手动编辑，或完全通过 cc-switch GUI 操作
模型权限不足DeepSeek API Key 无对应模型权限在 DeepSeek 平台确认账户已开通 V4 系列模型访问权限

关键环境变量速查 ​

变量DeepSeek 值Anthropic 值
ANTHROPIC_AUTH_TOKENsk-xxx（DeepSeek API Key）sk-ant-xxx（Anthropic API Key）
ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropichttps://api.anthropic.com
ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flashclaude-haiku-4-5-20250514
ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-flashclaude-sonnet-4-6-20250514
ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m]claude-opus-4-7-20250514
ANTHROPIC_MODELdeepseek-v4-flashclaude-sonnet-4-6-20250514
API_TIMEOUT_MS3000000600000

相关章节 ​

章节内容
第 3 章：环境搭建cc-switch 安装与基础配置
第 9 章：模式切换cc-switch 与 / 菜单的配合使用
第 13 章：配置体系settings.json 完整参考、配置冲突排查
第 35 章：模型对比与选择三套高级配置方案、团队统一模型策略

Copyright © 2017-2026 Shi Bin