使用 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 都填

相关新闻

如何用Buzz免费实现离线音频转录?本地Whisper转录工具完整上手指南

如何用Buzz免费实现离线音频转录?本地Whisper转录工具完整上手指南

如何用Buzz免费实现离线音频转录?本地Whisper转录工具完整上手指南 【免费下载链接】buzz Buzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper. 项目地址: https://gitcode.com/GitHub_Trending/buz/buzz …

2026/11/20 22:14:22 阅读更多 →
Maestro 移动端自动化测试设备选型:模拟器与真机差在哪儿,3 个维度帮你快速决定

Maestro 移动端自动化测试设备选型:模拟器与真机差在哪儿,3 个维度帮你快速决定

Maestro 移动端自动化测试设备选型:模拟器与真机差在哪儿,3 个维度帮你快速决定 【免费下载链接】Maestro Painless E2E Automation for Mobile and Web 项目地址: https://gitcode.com/GitHub_Trending/ma/Maestro Maestro 主打"无痛"…

2026/11/20 22:14:22 阅读更多 →
别再让观众猜你按了什么:input-overlay 键盘手柄输入可视化直播实战指南

别再让观众猜你按了什么:input-overlay 键盘手柄输入可视化直播实战指南

别再让观众猜你按了什么:input-overlay 键盘手柄输入可视化直播实战指南 【免费下载链接】input-overlay Show keyboard, gamepad and mouse input on stream 项目地址: https://gitcode.com/gh_mirrors/in/input-overlay 被观众追问"刚才按的是什么键&…

2026/11/19 5:46:45 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/19 21:38:27 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/19 21:38:49 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/19 21:39:09 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/20 21:55:32 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/19 21:37:45 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/19 21:36:20 阅读更多 →

日新闻

周新闻

月新闻