尧图网页设计 
原文https://mp.weixin.qq.com/s/amVcgz2sjnabpf_Dbba9BQClaude Code 是目前最顺手的 AI 编程工具之一但它默认只认 Anthropic 官方账号。想换成第三方模型——无论是为了更低的成本、可用的免费额度还是网络可达性——传统做法是手改~/.claude/settings.json、来回设置环境变量切一次供应商折腾一次。本文介绍开源工具CC Switch并以Agnes-3.0-flash为示例模型把「接入 → 调参 → 免登录 → 多端使用 → 排错」完整走一遍。Claude Code CC Switch 自定义模型接入 Agnes-3.0-flash① 为什么需要 CC Switch痛点与价值把第三方模型接进 Claude Code技术上并不神秘——Claude Code 支持通过环境变量把请求指到任意兼容端点。麻烦的是过程管理配置分散命令行读环境变量桌面端有自己的配置文件VS Code 插件又是另一套改一处不代表处处生效。切换成本高多供应商来回切每次都要手动编辑 JSON、清环境变量、重开终端。容易改坏手改配置文件没有备份一个逗号写错整个工具就起不来。CC Switch开源GitHubfarion1231/cc-switch就是为此而生的一站式管理工具基于 Tauri 2 Rust 构建的原生桌面应用用一个可视化界面统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI 等 10 个 AI 编程工具的供应商配置内置 90 供应商预设配置落盘走 SQLite 数据库 原子写入并自动保留备份。Claude Code 还支持热切换——换供应商不用重启会话托盘菜单里点一下就完成。图 1 · CC Switch 位于三端与供应商之间对内统一写配置对外按供应商的接口协议转发请求直观对比一下两种方式的工作量步骤数按本文给出的操作计数说明步骤数为本文所述操作步骤的计数——「手动配置」按登出官方账号、设置地址、设置密钥、指定模型、重开终端共 5 步「CC Switch」按安装、添加供应商、一键切换共 3 步「配置文件」指 settings.json、shell 配置、IDE 配置三处。一句话总结CC Switch 把「改配置」变成了「点一下」并且只替换请求地址、Key、模型名等关键字段你的插件、Hook、权限、MCP 等设置原样保留。② 环境准备安装与添加自定义供应商2.1 安装 CC Switch三平台都有原生安装包Windows 10、macOS 12、Linuxglibc 2.35均可使用系统安装方式说明WindowsReleases 下载.msi或绿色版.zip另有 ARM64 版本绿色版免安装macOSbrew install --cask cc-switch推荐也可下载.dmg已签名公证Linux.deb/.rpm/.AppImageArch 用户可paru -S cc-switch-bin服务器 / 无桌面环境还可以用社区版CC Switch CLI与桌面版共用~/.cc-switch数据目录本文以桌面版为主讲解。2.2 添加自定义供应商Provider安装后首次启动CC Switch 会把现有配置自动导入为名为default的供应商。接下来点工具栏的「添加新供应商」 按钮选择「创建自定义配置」逐项填写下表字段以 Agnes-3.0-flash 为例字段填什么Agnes-3.0-flash 示例应用类型目标工具选 ClaudeClaude即 Claude Code名称自定义方便识别切换Agnes-3.0-flash请求地址服务商 API 根地址裸地址不带/v1/messages以服务商控制台为准【待核实】API Key服务商签发的密钥在服务商控制台创建后粘贴模型名主模型必填Haiku / Sonnet / Opus 三档建议都填Agnes-3.0-flash三档可同名接口协议高级选项供应商原生兼容什么格式就选什么Anthropic Messages若兼容【待核实】✅两个省事技巧① 添加前先在 90 预设里搜一下供应商名命中预设只需粘贴 Key② 模型名四档Haiku / Sonnet / Opus / 自定义建议统一填同一个模型——Claude Code 后台会用 Haiku 档跑标题生成等小任务漏填会让这些后台调用失败。如果服务商是 OpenAI 兼容格式而非 Anthropic 原生格式「接口协议」选OpenAI Chat Completions并开启 CC Switch 的本地路由做协议转换——开启后 Claude Code 侧的请求地址会指向http://127.0.0.1:15721密钥写成占位符PROXY_MANAGED由 CC Switch 在本地完成格式转换。③ 关键参数思考程度必须选「低」供应商设置里有一个最容易踩坑的参数——推理 / 思考程度thinking 档位。这里直接给结论⚠️实测强制要求thinking 等级必须选择「低」。选择中 / 高档位后思考reasoningtoken 的消耗会成倍增加极易触发服务商的速率限制——请求被 429 拒绝。后果不只是单次报错编程会话中途断流、任务进行到一半报废反复触发还可能被服务商限流排队甚至冻结额度。接 Agnes-3.0-flash 这类第三方模型时请先把这一档调到「低」再开始干活。为什么高档位容易撞墙第三方服务商通常按并发数 / 每分钟请求数设限而高档思考意味着每次请求都要先产生大量不可见的推理 token单请求耗时长、占用并发窗口久Claude Code 的 agent 循环又是连续高频调用——两者叠加429 几乎是必然。「低」档位在保留基本推理能力的同时把请求负担压到了服务商限额之内实测可以稳定长时间会话。如果任务确实需要更深的推理更稳妥的做法是保持「低」档位改在提示词里要求模型「先列出计划再动手」用更可控的方式换取推理深度而不是硬拉 thinking 档位。④ 免登录配置不登录官方账号直接用Claude Code 启动时默认会引导 OAuth 登录官方账号。接第三方模型后这一步可以完全跳过原理是只要请求地址 密钥两个环境变量就位Claude Code 就会把所有请求发往你指定的端点官方登录流程彻底不参与。先在 Claude Code 里执行一次登出清掉残留的官方凭据# 登出官方账号清除本地 OAuth 凭据 claude /logout # 会话内斜杠命令或终端执行 claude logout方法 A推荐交给 CC Switch 自动写入在 CC Switch 里选中刚添加的 Agnes-3.0-flash 供应商点「切换」即可。CC Switch 会把请求地址、Key、模型名写入 Claude Code 的配置文件~/.claude/settings.json的 env 段Claude Code 重启后支持热切换时无需重启即以第三方身份运行全程不需要登录。另外建议在「设置 → 小工具」里开启「跳过 Claude Code 初次安装确认」新环境首次启动也不会被登录引导拦住。方法 B手动设置环境变量不用图形工具时比如临时在 CI 或服务器上跑直接设置以下变量后启动# macOS / Linuxbash/zsh export ANTHROPIC_BASE_URLhttps://你的服务商请求地址 export ANTHROPIC_AUTH_TOKENsk-你的密钥 export ANTHROPIC_API_KEY # 置空避免与 AUTH_TOKEN 冲突 export ANTHROPIC_MODELAgnes-3.0-flash # 主模型 export ANTHROPIC_SMALL_FAST_MODELAgnes-3.0-flash # 后台小任务模型 claude --model Agnes-3.0-flash# Windows PowerShell当前会话生效 $env:ANTHROPIC_BASE_URL https://你的服务商请求地址 $env:ANTHROPIC_AUTH_TOKEN sk-你的密钥 $env:ANTHROPIC_API_KEY $env:ANTHROPIC_MODEL Agnes-3.0-flash $env:ANTHROPIC_SMALL_FAST_MODEL Agnes-3.0-flash claude --model Agnes-3.0-flash环境变量作用注意事项ANTHROPIC_BASE_URL把所有 API 请求指到第三方端点填裸地址不要带/v1/messages路径ANTHROPIC_AUTH_TOKEN以 Bearer 方式发送的鉴权令牌第三方接入优先用这个ANTHROPIC_API_KEY官方 SDK 的密钥变量用第三方时建议置空两者并存易冲突ANTHROPIC_MODEL默认主模型填服务商支持的实际模型名ANTHROPIC_SMALL_FAST_MODEL后台小任务标题、分类模型漏填会让后台调用打到不存在的模型名上验证是否生效启动后在 Claude Code 里随便发起一次对话同时在 CC Switch 的用量面板或服务商后台看请求数是否增长——涨了就说明流量已经走第三方端点。⑤ 多端接入Desktop / CLI / VS Code 插件同一个供应商配置三种使用方式的配置入口和注意点各不相同使用方式配置入口关键差异与注意点Desktop 桌面端CC Switch 切换写入配置文件GUI 应用不继承 shell 环境变量手动 export 对它无效——必须靠 CC Switch 写配置或在应用设置里单独指定端点。支持托盘热切换。CLI 命令行环境变量或 settings.json手动 export 只对当前终端会话生效重开终端要重设想持久化写进 shell 配置文件或直接用 CC Switch 管理。会话内可用/model临时换模型但重启后回到供应商默认。VS Code 插件CC Switch「小工具」开启跟随插件默认读自己的一套配置。在 CC Switch 设置 → 小工具里开启「让 VS Code 的 Claude Code 插件随本软件切换供应商」之后插件自动跟随 CC Switch 的当前供应商无需单独配置。✅推荐姿势三端全部交给 CC Switch 统一管理——桌面端靠配置写入、CLI 靠 settings.json、VS Code 插件靠小工具跟随。切换供应商只在一个地方操作三端同时生效彻底告别「改了终端忘了桌面」。⑥ 常见问题排查现象可能原因解决办法连接失败 / 超时请求地址写错带了/v1/messages尾巴、少了协议头或接口协议选错填裸地址确认协议与供应商实际格式一致原生兼容选 Anthropic MessagesOpenAI 格式需开本地路由401 / 403 鉴权报错Key 填错或过期ANTHROPIC_API_KEY与AUTH_TOKEN并存冲突重新复制 Key第三方接入用ANTHROPIC_AUTH_TOKEN把API_KEY置空429 限流thinking 档位过高实测主因或并发超出服务商限额思考程度调回「低」减少并行任务稍后重试避免连续触发模型不可用 / 名称报错模型名拼写错误Haiku 档后台任务没配模型按服务商文档逐字核对模型名主模型与三档Haiku/Sonnet/Opus都填上切换后没生效终端缓存了旧环境变量插件未重载重开终端 / 重载 VS Code 窗口Claude Code 在 CC Switch 下支持热切换其他端注意重启VS Code 插件不跟随切换未开启对应小工具CC Switch 设置 → 小工具 → 开启「VS Code 插件随本软件切换」想回官方账号——在 CC Switch 切到 Claude Official再按/login流程重新登录还有一个兜底技巧CC Switch 在首次改写配置前会自动备份原文件~/.cc-switch/backups/配置改坏了可以从这里恢复不必手慌。⑦ 配置速查表与要点总结配置项推荐值 / 填写规则供应商名称Agnes-3.0-flash自定义便于识别请求地址服务商 API 裸地址不带/v1/messages【以控制台为准】API Key服务商控制台签发粘贴即可模型名四档统一填 Agnes-3.0-flash接口协议原生兼容选 Anthropic MessagesOpenAI 格式开本地路由转换思考程度 ⚠️必须选「低」高档位触发 429 限流实测免登录变量ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKENAPI_KEY置空登出官方claude /logout或claude logoutVS Code 插件小工具开启「随本软件切换供应商」本地路由开启后地址为http://127.0.0.1:15721密钥占位PROXY_MANAGED三句话带走全文接入 请求地址 Key 模型名三件套CC Switch 负责把它们一键写进三端配置。thinking 档位锁死「低」这是第三方模型稳定长会话的生命线。排错先看三样地址对不对、Key 通不通、档位低不低——绝大多数问题都出在这三处。结语CC Switch 的价值不止于「能接入」而在于把多供应商、多工具、多端的配置管理收敛到一个界面里。按本文流程走完你就能在不登录官方账号的情况下让 Claude Code 的桌面端、CLI 和 VS Code 插件全部跑在 Agnes-3.0-flash 上。文中标注【待核实】的字段请以你的服务商控制台为准如果你也在用其他模型欢迎在评论区聊聊你的接入配置。相关阅读CC Switch · GitHub 仓库 官方文档Claude Code Docs 别再手改配置了：用 CC Switch 把自定义模型接进 Claude Code
原文https://mp.weixin.qq.com/s/amVcgz2sjnabpf_Dbba9BQClaude Code 是目前最顺手的 AI 编程工具之一但它默认只认 Anthropic 官方账号。想换成第三方模型——无论是为了更低的成本、可用的免费额度还是网络可达性——传统做法是手改~/.claude/settings.json、来回设置环境变量切一次供应商折腾一次。本文介绍开源工具CC Switch并以Agnes-3.0-flash为示例模型把「接入 → 调参 → 免登录 → 多端使用 → 排错」完整走一遍。Claude Code CC Switch 自定义模型接入 Agnes-3.0-flash① 为什么需要 CC Switch痛点与价值把第三方模型接进 Claude Code技术上并不神秘——Claude Code 支持通过环境变量把请求指到任意兼容端点。麻烦的是过程管理配置分散命令行读环境变量桌面端有自己的配置文件VS Code 插件又是另一套改一处不代表处处生效。切换成本高多供应商来回切每次都要手动编辑 JSON、清环境变量、重开终端。容易改坏手改配置文件没有备份一个逗号写错整个工具就起不来。CC Switch开源GitHubfarion1231/cc-switch就是为此而生的一站式管理工具基于 Tauri 2 Rust 构建的原生桌面应用用一个可视化界面统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI 等 10 个 AI 编程工具的供应商配置内置 90 供应商预设配置落盘走 SQLite 数据库 原子写入并自动保留备份。Claude Code 还支持热切换——换供应商不用重启会话托盘菜单里点一下就完成。图 1 · CC Switch 位于三端与供应商之间对内统一写配置对外按供应商的接口协议转发请求直观对比一下两种方式的工作量步骤数按本文给出的操作计数说明步骤数为本文所述操作步骤的计数——「手动配置」按登出官方账号、设置地址、设置密钥、指定模型、重开终端共 5 步「CC Switch」按安装、添加供应商、一键切换共 3 步「配置文件」指 settings.json、shell 配置、IDE 配置三处。一句话总结CC Switch 把「改配置」变成了「点一下」并且只替换请求地址、Key、模型名等关键字段你的插件、Hook、权限、MCP 等设置原样保留。② 环境准备安装与添加自定义供应商2.1 安装 CC Switch三平台都有原生安装包Windows 10、macOS 12、Linuxglibc 2.35均可使用系统安装方式说明WindowsReleases 下载.msi或绿色版.zip另有 ARM64 版本绿色版免安装macOSbrew install --cask cc-switch推荐也可下载.dmg已签名公证Linux.deb/.rpm/.AppImageArch 用户可paru -S cc-switch-bin服务器 / 无桌面环境还可以用社区版CC Switch CLI与桌面版共用~/.cc-switch数据目录本文以桌面版为主讲解。2.2 添加自定义供应商Provider安装后首次启动CC Switch 会把现有配置自动导入为名为default的供应商。接下来点工具栏的「添加新供应商」 按钮选择「创建自定义配置」逐项填写下表字段以 Agnes-3.0-flash 为例字段填什么Agnes-3.0-flash 示例应用类型目标工具选 ClaudeClaude即 Claude Code名称自定义方便识别切换Agnes-3.0-flash请求地址服务商 API 根地址裸地址不带/v1/messages以服务商控制台为准【待核实】API Key服务商签发的密钥在服务商控制台创建后粘贴模型名主模型必填Haiku / Sonnet / Opus 三档建议都填Agnes-3.0-flash三档可同名接口协议高级选项供应商原生兼容什么格式就选什么Anthropic Messages若兼容【待核实】✅两个省事技巧① 添加前先在 90 预设里搜一下供应商名命中预设只需粘贴 Key② 模型名四档Haiku / Sonnet / Opus / 自定义建议统一填同一个模型——Claude Code 后台会用 Haiku 档跑标题生成等小任务漏填会让这些后台调用失败。如果服务商是 OpenAI 兼容格式而非 Anthropic 原生格式「接口协议」选OpenAI Chat Completions并开启 CC Switch 的本地路由做协议转换——开启后 Claude Code 侧的请求地址会指向http://127.0.0.1:15721密钥写成占位符PROXY_MANAGED由 CC Switch 在本地完成格式转换。③ 关键参数思考程度必须选「低」供应商设置里有一个最容易踩坑的参数——推理 / 思考程度thinking 档位。这里直接给结论⚠️实测强制要求thinking 等级必须选择「低」。选择中 / 高档位后思考reasoningtoken 的消耗会成倍增加极易触发服务商的速率限制——请求被 429 拒绝。后果不只是单次报错编程会话中途断流、任务进行到一半报废反复触发还可能被服务商限流排队甚至冻结额度。接 Agnes-3.0-flash 这类第三方模型时请先把这一档调到「低」再开始干活。为什么高档位容易撞墙第三方服务商通常按并发数 / 每分钟请求数设限而高档思考意味着每次请求都要先产生大量不可见的推理 token单请求耗时长、占用并发窗口久Claude Code 的 agent 循环又是连续高频调用——两者叠加429 几乎是必然。「低」档位在保留基本推理能力的同时把请求负担压到了服务商限额之内实测可以稳定长时间会话。如果任务确实需要更深的推理更稳妥的做法是保持「低」档位改在提示词里要求模型「先列出计划再动手」用更可控的方式换取推理深度而不是硬拉 thinking 档位。④ 免登录配置不登录官方账号直接用Claude Code 启动时默认会引导 OAuth 登录官方账号。接第三方模型后这一步可以完全跳过原理是只要请求地址 密钥两个环境变量就位Claude Code 就会把所有请求发往你指定的端点官方登录流程彻底不参与。先在 Claude Code 里执行一次登出清掉残留的官方凭据# 登出官方账号清除本地 OAuth 凭据 claude /logout # 会话内斜杠命令或终端执行 claude logout方法 A推荐交给 CC Switch 自动写入在 CC Switch 里选中刚添加的 Agnes-3.0-flash 供应商点「切换」即可。CC Switch 会把请求地址、Key、模型名写入 Claude Code 的配置文件~/.claude/settings.json的 env 段Claude Code 重启后支持热切换时无需重启即以第三方身份运行全程不需要登录。另外建议在「设置 → 小工具」里开启「跳过 Claude Code 初次安装确认」新环境首次启动也不会被登录引导拦住。方法 B手动设置环境变量不用图形工具时比如临时在 CI 或服务器上跑直接设置以下变量后启动# macOS / Linuxbash/zsh export ANTHROPIC_BASE_URLhttps://你的服务商请求地址 export ANTHROPIC_AUTH_TOKENsk-你的密钥 export ANTHROPIC_API_KEY # 置空避免与 AUTH_TOKEN 冲突 export ANTHROPIC_MODELAgnes-3.0-flash # 主模型 export ANTHROPIC_SMALL_FAST_MODELAgnes-3.0-flash # 后台小任务模型 claude --model Agnes-3.0-flash# Windows PowerShell当前会话生效 $env:ANTHROPIC_BASE_URL https://你的服务商请求地址 $env:ANTHROPIC_AUTH_TOKEN sk-你的密钥 $env:ANTHROPIC_API_KEY $env:ANTHROPIC_MODEL Agnes-3.0-flash $env:ANTHROPIC_SMALL_FAST_MODEL Agnes-3.0-flash claude --model Agnes-3.0-flash环境变量作用注意事项ANTHROPIC_BASE_URL把所有 API 请求指到第三方端点填裸地址不要带/v1/messages路径ANTHROPIC_AUTH_TOKEN以 Bearer 方式发送的鉴权令牌第三方接入优先用这个ANTHROPIC_API_KEY官方 SDK 的密钥变量用第三方时建议置空两者并存易冲突ANTHROPIC_MODEL默认主模型填服务商支持的实际模型名ANTHROPIC_SMALL_FAST_MODEL后台小任务标题、分类模型漏填会让后台调用打到不存在的模型名上验证是否生效启动后在 Claude Code 里随便发起一次对话同时在 CC Switch 的用量面板或服务商后台看请求数是否增长——涨了就说明流量已经走第三方端点。⑤ 多端接入Desktop / CLI / VS Code 插件同一个供应商配置三种使用方式的配置入口和注意点各不相同使用方式配置入口关键差异与注意点Desktop 桌面端CC Switch 切换写入配置文件GUI 应用不继承 shell 环境变量手动 export 对它无效——必须靠 CC Switch 写配置或在应用设置里单独指定端点。支持托盘热切换。CLI 命令行环境变量或 settings.json手动 export 只对当前终端会话生效重开终端要重设想持久化写进 shell 配置文件或直接用 CC Switch 管理。会话内可用/model临时换模型但重启后回到供应商默认。VS Code 插件CC Switch「小工具」开启跟随插件默认读自己的一套配置。在 CC Switch 设置 → 小工具里开启「让 VS Code 的 Claude Code 插件随本软件切换供应商」之后插件自动跟随 CC Switch 的当前供应商无需单独配置。✅推荐姿势三端全部交给 CC Switch 统一管理——桌面端靠配置写入、CLI 靠 settings.json、VS Code 插件靠小工具跟随。切换供应商只在一个地方操作三端同时生效彻底告别「改了终端忘了桌面」。⑥ 常见问题排查现象可能原因解决办法连接失败 / 超时请求地址写错带了/v1/messages尾巴、少了协议头或接口协议选错填裸地址确认协议与供应商实际格式一致原生兼容选 Anthropic MessagesOpenAI 格式需开本地路由401 / 403 鉴权报错Key 填错或过期ANTHROPIC_API_KEY与AUTH_TOKEN并存冲突重新复制 Key第三方接入用ANTHROPIC_AUTH_TOKEN把API_KEY置空429 限流thinking 档位过高实测主因或并发超出服务商限额思考程度调回「低」减少并行任务稍后重试避免连续触发模型不可用 / 名称报错模型名拼写错误Haiku 档后台任务没配模型按服务商文档逐字核对模型名主模型与三档Haiku/Sonnet/Opus都填上切换后没生效终端缓存了旧环境变量插件未重载重开终端 / 重载 VS Code 窗口Claude Code 在 CC Switch 下支持热切换其他端注意重启VS Code 插件不跟随切换未开启对应小工具CC Switch 设置 → 小工具 → 开启「VS Code 插件随本软件切换」想回官方账号——在 CC Switch 切到 Claude Official再按/login流程重新登录还有一个兜底技巧CC Switch 在首次改写配置前会自动备份原文件~/.cc-switch/backups/配置改坏了可以从这里恢复不必手慌。⑦ 配置速查表与要点总结配置项推荐值 / 填写规则供应商名称Agnes-3.0-flash自定义便于识别请求地址服务商 API 裸地址不带/v1/messages【以控制台为准】API Key服务商控制台签发粘贴即可模型名四档统一填 Agnes-3.0-flash接口协议原生兼容选 Anthropic MessagesOpenAI 格式开本地路由转换思考程度 ⚠️必须选「低」高档位触发 429 限流实测免登录变量ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKENAPI_KEY置空登出官方claude /logout或claude logoutVS Code 插件小工具开启「随本软件切换供应商」本地路由开启后地址为http://127.0.0.1:15721密钥占位PROXY_MANAGED三句话带走全文接入 请求地址 Key 模型名三件套CC Switch 负责把它们一键写进三端配置。thinking 档位锁死「低」这是第三方模型稳定长会话的生命线。排错先看三样地址对不对、Key 通不通、档位低不低——绝大多数问题都出在这三处。结语CC Switch 的价值不止于「能接入」而在于把多供应商、多工具、多端的配置管理收敛到一个界面里。按本文流程走完你就能在不登录官方账号的情况下让 Claude Code 的桌面端、CLI 和 VS Code 插件全部跑在 Agnes-3.0-flash 上。文中标注【待核实】的字段请以你的服务商控制台为准如果你也在用其他模型欢迎在评论区聊聊你的接入配置。相关阅读CC Switch · GitHub 仓库 官方文档Claude Code Docs