使用 cc-switch 让 AI Agent 编程工具接入第三方模型

背景Claude Code、Codex 这类 AI Agent 编程工具默认只认自家官方模型端点api.anthropic.com/api.openai.com。但实际使用中经常需要接第三方模型DeepSeek、GLM、Kimi、Qwen、MiMo 等图便宜/图快/图白嫖额度接统一网关团队内部统一 LLM 网关带内网域名走统一账号不走公网接本地模型Ollama 跑的qwen3.5:27b之类的本地模型逐个工具手工改配置文件Claude Code 改settings.json的 env、Codex 改config.toml来回切很烦且容易改坏。cc-switch就是解决多工具 × 多模型源一键切换的 GUI 工具。本文基于实际使用 cc-switch Claude Code / Codex 的经验整理。安装部署下载渠道只从官方渠道下载官网ccswitch.ioGitHub Releasesgithub.com/farion1231/cc-switch/releases任何要求付费、充值或登录凭据的 “CC Switch” 网站 / 客户端都不是官方的。系统要求操作系统Windows 10 / macOS 12 / 主流 Linux 发行版被管理的 CLI 工具Claude Code / Codex / Gemini CLI 等依赖Node.js 18安装macOSHomebrew 或手动下载# 方式一Homebrew推荐brewinstall--caskcc-switch brew upgrade--caskcc-switch# 升级# 方式二手动下载# 从 Releases 下 CC-Switch-v{版本}-macOS.dmg拖入 Applications其他平台WindowsMSI 安装包或 Portable 免安装 zipLinuxDebian / Ubuntu 用.debFedora / RHEL 用.rpmArch 用 AURcc-switch-bin通用 AppImage首次部署启动后进 Settings打开要管理的工具开关visibleAppsclaude / codex / gemini / opencode…数据落在~/.cc-switch/cc-switch.dbSQLite settings.json偏好之后按「实操流程」加 provider、切模型即可核心原理一句话Claude Code / Codex 都支持通过环境变量 / 配置文件把模型端点指向任意 Anthropic / OpenAI 兼容网关。cc-switch 只是把改配置这件事做成了 GUI 一键切换。Claude Code 侧env 环境变量Claude Code 读~/.claude/settings.json里的env块其中几个ANTHROPIC_*变量决定请求发到哪、用什么模型环境变量作用ANTHROPIC_BASE_URL模型网关地址Anthropic 兼容端点ANTHROPIC_AUTH_TOKEN认证 tokenANTHROPIC_MODEL默认模型全量设定时用ANTHROPIC_DEFAULT_OPUS_MODEL主力模型ANTHROPIC_DEFAULT_SONNET_MODEL次主力模型ANTHROPIC_DEFAULT_HAIKU_MODEL轻量模型ANTHROPIC_REASONING_MODEL推理模型ANTHROPIC_SMALL_FAST_MODEL小快模型模型名可以是任意第三方模型 ID如deepseek-v4-flash[1m]关键是网关要提供 Anthropic 兼容协议。现在主流三方DeepSeek / GLM / Kimi / 阿里百炼 / ModelScope / SiliconFlow / OpenRouter / 小米等都提供了/anthropic兼容端点。Codex 侧config.tomlCodex 读~/.codex/config.toml通过model_provider[model_providers.custom]指定自定义网关model_provider custom model 模型ID model_reasoning_effort high disable_response_storage true model_context_window 1000000 model_auto_compact_token_limit 900000 [model_providers.custom] name custom wire_api responses requires_openai_auth true base_url OpenAI兼容网关地址/v1 [projects.项目绝对路径] trust_level trustedCodex 侧用的是OpenAI 兼容协议wire_api responses/chatbase_url 指向 OpenAI 兼容端点。cc-switch 做了什么cc-switch 本质是一个配置生成器 切换器预置/自定义一堆 provider每家 一组 env 或一段 config点一下切换 → 把选中的 provider 的配置写回对应工具的配置文件改完即生效不需要改完重启工具真实配置样例cc-switch 自身数据存~/.cc-switch/cc-switch.dbSQLitesettings.json存偏好支持多工具visibleApps里 claude / codex / gemini / opencode 可选开关实际开了 claude codexClaude Code provider样例{env:{ANTHROPIC_AUTH_TOKEN:token,ANTHROPIC_BASE_URL:网关地址/anthropic,ANTHROPIC_DEFAULT_OPUS_MODEL:deepseek-v4-flash[1m],ANTHROPIC_DEFAULT_SONNET_MODEL:deepseek-v4-flash[1m],ANTHROPIC_DEFAULT_HAIKU_MODEL:deepseek-v4-flash[1m],ANTHROPIC_REASONING_MODEL:deepseek-v4-flash[1m],MCP_TOOL_TIMEOUT:30000,API_TIMEOUT_MS:3000000,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1}}Claude provider 里存的模型源模型源网关类型模型示例统一网关团队 LLM 网关Anthropic 兼容deepseek-v4-flash[1m]、glm-5.1、claude-opus-5[1m]、kimi等靠模型 ID 切换DeepSeek 官方api.deepseek.com/anthropicdeepseek-v4-pro[1m]/deepseek-v4-flash[1m]GLM 官方open.bigmodel.cn/api/anthropicglm-4.7-flash等含 free 档Kimiapi.moonshot.cn/anthropickimi-k2.5阿里百炼dashscope.aliyuncs.com/apps/anthropicqwen3.6-plusModelScopeapi-inference.modelscope.cnZhipuAI/GLM-5.1、deepseek-ai/DeepSeek-V4-Pro等SiliconFlowapi.siliconflow.cn/v1Pro/zai-org/GLM-5.1OpenRouteropenrouter.ai/api/v1z-ai/glm-4.5-air:free等ZenMuxzenmux.ai/api/anthropicdeepseek/deepseek-v4-pro-free等免费聚合NVIDIAintegrate.api.nvidia.com/v1z-ai/glm4.7本地 Ollama127.0.0.1:3456/ 局域网11434/v1qwen3.5:27b本地模型小米 MiMotoken-plan-cn.xiaomimimo.com/anthropicmimo-v2.5-proCodex provider样例model_provider custom model gpt-5.6-sol model_reasoning_effort high disable_response_storage true [model_providers.custom] name custom wire_api responses requires_openai_auth true base_url 网关地址/v1Codex 侧还配过 NVIDIAintegrate.api.nvidia.com/v1、OpenAI Official 等。实操流程装 cc-switch见上文「安装部署」加 providerSettings → Providers → 添加选工具类型claude/codex…官方源选cn_official/official分类填 API Key 即自动生成配置自定义源选custom手动填base_url token 模型 ID聚合源如 ModelScope / ZenMux走 aggregator 分类切模型主界面点选某个 provider → 一键写入对应工具的配置文件验证启动 Claude Code / Codex看请求是否发到目标网关、模型是否正确或直接cat ~/.claude/settings.json看env.ANTHROPIC_*是否变化注意点[1m]后缀如deepseek-v4-flash[1m]表示 1M 上下文窗口变体按需选用免费档 ≠ 稳定-free/-flash档位常用于日常速刷但限流、不稳定重要任务切回主力模型CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1关掉非必要流量遥测等代理场景建议保留auth.json / tokenCodex 侧~/.codex/auth.json存登录态切 provider 一般只动config.toml统一网关团队内部网关地址属于内网信息公开场合打码common_configcc-switch 有公共配置common_config_claude / common_config_codex切 provider 时与 provider 配置合并公共项不用每个 provider 都填