很多人照着 CC Switch 安装指南装完 Node.js、装完 Claude Code、装完 CC Switch 之后才发现最难的其实是把 API Base URL 填对。CC Switch 那个小图标只是切换入口真正让 Claude Code 跑起来还得靠外部提供的接口地址和 Key。用 TaoToken 做统一接入通道先到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并创建 API Key再把 Claude Code 的 Base URL 指到 https://taotoken.net/api之后你在 CC Switch 里来回切 Claude / Codex / Gemini全程只认这一把 Key。这篇文章顺着安装路径走Node.js、CLI、CC Switch、供应商参数、托盘切换、真实调用最后把自动更新和卸载时容易留下的配置残留一起说清楚。1. 先装 Node.js给 Claude Code 和 CC Switch 垫好底座CC Switch 本身是图形界面但它管理的 Claude Code、Codex、Gemini CLI 全都跑在 Node.js 上所以这是第一步也是很多人最先翻车的地方。官方推荐 Node.js 18 LTS 或更高版本注意是 LTS不是带最新特性但稳定性未知的 Current。下面按平台给你一个能直接落地的最小方案。1.1 Windows选 LTS不要选 CurrentWindows 用户直接打开 Node.js 官网下载页上有两个按钮左侧是 LTS右侧是 Current。选 LTS。下载完成后双击 msi 安装全程 Next 就行。安装完一定要开一个新终端不要在旧 CMD 里直接敲 node --version因为旧窗口不会刷新 PATH 环境变量。如果终端提示“node 不是内部或外部命令”回到安装包选择“Repair”确认安装时勾选了 Add to PATH。运行 node --version 和 npm --version 都出来号儿再开始下一步。1.2 macOSnvm 或 Homebrew 二选一macOS 最简单的做法是 brew install node但如果你将来可能在多个 Node 大版本之间跳我更建议用 nvm。nvm 的安装脚本来自 nvm-sh 仓库装完执行 nvm install --lts再执行 nvm use --lts。用 nvm 有个额外好处npm 全局包会装进你当前用户目录而不是系统目录这能避免后面 npm install -g anthropic-ai/claude-code 时出现 EACCES permission denied。很多 Mac 用户给全局包强行 sudo其实是在给自己埋坑。1.3 Linux用 NodeSource 或 nvm别用系统老源Debian / Ubuntu 自带的 apt 源里nodejs 版本经常常年停留在 16 甚至更低。对 CC Switch 要用的几个 CLI 来说某些 npm 依赖会要求更高的 Node 版本。稳妥做法是执行 NodeSource 的 setup_lts 脚本再 sudo apt install -y nodejs。想彻底不用 sudo 操作 npm 的就还是 nvm。装完推荐检查一下 npm config get prefix确认目录在用户位置而不是 /usr 下这样后续全局安装不会打架。2. 用 npm 装 Claude Code再填 TaoToken 的 Base URLNode.js 就位之后先别急着装 CC Switch先把 Claude Code 本身的通道打通。这样待会儿 CC Switch 装好只是帮你切换供应商而不是承担任何请求转发。Claude Code 的官方安装方式很简单一条命令就行。2.1 安装命令在终端执行npm install -g anthropic-ai/claude-code安装结束后执行 claude --version能打印版本号就说明装好了。如果这里报 EACCES回到第 1 章检查 npm 全局目录是不是被 system 目录占用。不要无脑 sudoMac 和 Linux 上 sudo npm 全局安装会让后续维护很麻烦。Codex 和 Gemini CLI 的安装方式在 CC Switch 官方文档里有完整命令思路一样本文后面统一以 Claude Code 为例来写因为它的 Base URL 字段最容易写错。2.2 去 TaoToken 创建 API KeyClaude Code 默认连的是 Anthropic 官方接口但它支持用环境变量覆盖接口地址。要覆盖成哪个地址取决于你在 TaoToken 拿到的配置信息。打开网站并注册登录后找到创建 API Key 的入口点一下生成。复制出来的字符串就是本文里所有地方的 YOUR_API_KEY。注意模型广场也在这个站点后面填模型 ID 时还要回来别急着关标签页。2.3 把配置写进 ~/.claude/settings.jsonClaude Code 的配置文件只有一个地方用户主目录下的 ~/.claude/settings.json。没有这个文件就直接新建文件内容是一个标准 JSON 对象不要加注释也不要像 .env 那样写 KEYvalue。Claude Code 启动时会读取这个文件里的 env 字段把它里面的变量当作进程环境变量来用。在 env 里加入下面三项{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: YOUR_MODEL_ID } }这段代码不用加 /v1TaoToken 的 Base URL 就是根地址。ANTHROPIC_AUTH_TOKEN 填上一步复制的 Key。ANTHROPIC_MODEL 的值需要以模型广场上展示的模型 ID 为准不同时间开放的模型系列不一样凭记忆填一个可能直接报模型不存在。配置保存后在终端跑一下 claude如果能进入对话界面并正常回复说明 Claude Code 已经被指到 TaoToken。3. 安装 CC SwitchMSI、Homebrew cask、AppImageClaude Code 能独立跑通之后再装 CC Switch 就只是多一个切换层。CC Switch 负责把不同供应商的参数按需注入到终端环境里省去每次改配置文件的手工操作。它的安装方式覆盖三大平台下面按系统分开讲。3.1 WindowsMSI 与便携版CC Switch 的 Windows 安装包分为 MSI 安装版和便携版。安装版适合大多数用户下载 CC-Switch-v{version}-Windows.msi双击运行安装向导会帮你在开始菜单创建快捷方式。如果 Firefox 或 Chrome 提示下载文件不安全请返回发布页面确认文件名一致再继续。便携版则适合那种不想把各类工具装进系统的人下载 Windows-Portable.zip解压到任意目录直接运行 CC-Switch.exe。这么做的唯一代价是下次清理系统时得记得手动删除整个目录注册表里不会留下太多东西。3.2 macOStap cask 最省心macOS 推荐走 Homebrew cask 流程。先执行 brew tap farion1231/ccswitch再执行 brew install --cask cc-switch。这种方式的优势在于自动更新时能快速升级到新版本后续执行 brew upgrade --cask cc-switch 即可。不喜欢或没装 Homebrew 的可以去发布页面下载 CC-Switch-v{version}-macOS.zip解压后把 CC Switch.app 拖进「应用程序」文件夹。根据上游公告macOS 版已经做了签名和公证不会出现“无法验证开发者”那种提示如果你仍遇到打开即退出的情况多半是系统隐私设置或网络隔离属性导致右击应用选择打开再试一次。3.3 LinuxAUR / deb / AppImageArchLinux 用户可以直接用 AUR 安装paru -S cc-switch-bin或者你习惯 yay 的话 yay -S cc-switch-bin。Debian / Ubuntu 用户下载 CC-Switch-v{version}-Linux.deb 后执行 sudo dpkg -i如果报依赖缺失再执行 sudo apt-get install -f 补上。AppImage 版对几乎所有发行版通用下载后先 chmod x CC-Switch-v{version}-Linux.AppImage然后执行 ./CC-Switch-v{version}-Linux.AppImage。AppImage 的好处是不写入系统目录缺点是每次要靠命令行启动习惯用图形界面的可以自己建一个桌面快捷方式。4. 在 CC Switch 里对齐 Base URL、Key、模型 ID安装完成只是开始真正决定能不能切换成功的是供应商表单里的三项参数。CC Switch 的界面虽然看着直观但很多人的 Key 和模型 ID 都是分开存放的填起来容易张冠李戴。这一节把参数来源说清楚。4.1 添加一个自定义供应商打开 CC Switch 后会先看到一个供应商列表。刚装完时这个列表可能是空的或者只有几个预设选项。找到添加或新建供应商的按钮点击后会弹出表单。不同系统版本在按钮文案上有差异Windows 便携版和 macOS 菜单版可能叫“新增”Linux 上可能叫“Add Provider”但只要找到带加号的按钮或者“新增供应商”字样就是它。把下面表格里的值原样填进去不需要额外做格式转换。配置项填写值供应商名称TaoTokenBase URL / API 地址https://taotoken.net/apiAPI KeyYOUR_API_KEY模型 ID以模型广场上展示的 ID 为准注意 Base URL 这一栏一定不要从官网落地页复制地址再粘过来落地页地址和接口地址是两个用途。工具里只认接口地址也就是表格里的 https://taotoken.net/api末尾不要自行添加 /v1。4.2 模型 ID 去模型广场抄不要自己编填表格的时候最容易出错的是模型 ID因为这张表里只有它没有固定值。TaoToken 模型广场页面更新得比软件版本快不同时期开放的模型会有调整。你直接在那个页面里找到你计划使用的模型复制它展示的完整 ID回到 CC Switch 填进模型 ID 栏。尽量不要凭印象写也别拿别人教程里的模型名硬套因为同一个名字的模型在不同接入方那里的 ID 可能完全不同。ID 填错时 CC Switch 不会立即报错通常要等到你真正发起一次调用才会看到模型不存在的错误所以这一步值得多花 10 秒确认。5. 验证安装托盘图标切一次Claude Code 回一句话所有参数填好并保存后验证就变得很直观打开系统托盘里的 CC Switch 图标。Windows 上如果托盘区一片空白先点一下托盘箭头把 CC Switch 图标显示出来。macOS 上则看菜单栏右侧的 CC 图标。点击后列表中会出现刚才添加的 TaoToken 供应商选中它作为当前激活项。注意切换动作本身很快也不会弹任何成功提示你要看的是当前选中项旁边是否显示 TaoToken。如果列表里没有它说明第 4 步保存没成功回到配置界面检查 Base URL 和 Key 是否为空。5.1 托盘图标与供应商选择选中之后打开终端输入 claude。正常情况下会先加载 ~/.claude/settings.json然后进入交互对话框。这时候问它一句「请回复 hello world」如果它正常给出回答说明请求已经通过 TaoToken 通道发到模型并返回。若出现认证相关的错误优先看 ANTHROPIC_AUTH_TOKEN 是不是复制掉了空格若提示模型不存在去模型广场核对一下 ANTHROPIC_MODEL 的拼写若网络连接超时或找不到主机则是 Base URL 少了字符或误加了 /v1。因为这一路只跟三个环境变量打交道排查范围并不大。5.2 一次真实调用与常见报错顺带提醒CC Switch 只是在启动 Claude Code 前把供应商参数注入到终端环境里真正发起网络请求、消耗 Token 的是 Claude Code 这个进程。所以验证时不要重复点 CC Switch 图标改成在终端里连续跑两三个问题确认响应稳定。如果中途切换了供应商重新打开一个终端再启动 claude避免旧终端的进程还持有上一份环境变量。6. 自动更新与卸载CC Switch 卸了配置别留坑CC Switch 的自动更新做得比较省心每次启动时会向发布地址检查一次版本有新版本时界面上会显示更新提示点下载并安装即可。如果当前网络环境比较稳你也可以在“设置 - 关于”里手动触发检查。建议保持自动更新打开因为 CC Switch 的迭代会适配新版 CLI 的供应商逻辑忽略更新往往会导致某天切换失灵。更新不会覆盖你已填写的供应商参数正常情况下升级完列表里仍然保留 TaoToken 那条记录。卸载方面Windows 走“设置 - 应用”找到 CC Switch 卸载macOS 把 CC Switch.app 拖进废纸篓顺便删除它的配置目录 ~/.cc-switch/Linux 用包管理器移除。需要留意的是CC Switch 卸载后Claude Code 的 ~/.claude/settings.json 不会被自动清理你在第 2 步写入的 ANTHROPIC_BASE_URL 依然指向 TaoToken。如果只是为了试一段时间建议保留这些配置如果想彻底恢复官方通道把 env 里那三行删掉即可。很多人会有这种困惑CC Switch 卸载了但 Claude Code 还是连不上官方原因就在这里。之后想核对历史调用记录或补一次新 Key 做最小验证回 TaoToken 的控制台就能看到。