1. 多工具并行时Skill 和 MCP 的配置为什么会失控如果你同时用 Claude Code、Codex、Gemini CLI 这几个 AI 编程工具大概率经历过这样的循环在 Claude Code 里调好一个 code-review 的 Skill换到 Codex 发现目录里空空如也在 Claude Code 里配好一个 MCP 服务器切到 Gemini CLI 又得照着文档重填一遍 URL 和 token。工具越多这种重复劳动越像滚雪球。问题的根源不在于工具本身而在于每个工具都有一套自己的配置约定。Skill 的存放路径不同MCP 的配置格式不同——Claude Code 用 JSON、Codex 用 TOML、Hermes 用 YAML连 JSON 和 JSON 之间的内部结构都不一样。你手动同步一次两次还行工具一多、Skill 一多就变成了纯粹的体力活。CC Switch 这个用 Rust 写的工具思路是把 Skill 和 MCP 都收敛到一个单一事实源SSOT再按需投影到各个应用目录。上篇聊了它的代理接管和用量统计这篇聚焦更实际的问题Skill 和 MCP 怎么统一管理以及怎么用 TaoToken 把 API Key 这条链路也一起打通让切换工具时不用逐工具重填 Key。这篇适合已经在用两个以上 AI 编程工具、被配置同步折磨过的人。下面会给出可复制的 settings.json、config.toml 骨架以及 CC Switch 的配置片段最后附上验证动作——切换工具后确认 Skill 和 MCP 都生效、Key 不用重填。2. 前置准备TaoToken 统一 Key 与 CC Switch 的定位在动手之前先把两个东西的角色分清楚。TaoToken 在这里承担的是「统一 API 通道」的角色。你可以在它的控制台创建一个 Key然后让多个 AI 工具都指向同一个 API 地址和同一个 Key。这样切换工具时改的是工具侧的配置而不是每个工具都去申请、填写一套独立的凭证。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。CC Switch 承担的是「配置分发」的角色。它把 Skill 和 MCP 的配置集中管理再同步到各个应用的本地目录。它本身不生产 Key但它可以把「用哪个 Key、走哪个 API 地址」这件事连同 Skill、MCP 一起作为一套配置投影到不同工具。两者配合的逻辑是TaoToken 解决「凭证统一」CC Switch 解决「配置统一」。你只需要在 TaoToken 控制台维护一个 Key在 CC Switch 里维护一份 Skill 和 MCP 清单剩下的分发交给工具。需要提前准备的东西一个 TaoToken 账号并在控制台创建一个 API Key模型对话入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。安装好 CC Switch并确认它已经能识别你本机的 AI 工具目录。至少两个 AI 编程工具用来验证同步效果。注意CC Switch 的 Skill 和 MCP 同步是本地文件操作不涉及把配置上传到云端。你的 Key 存在本地配置文件里这一点在排查问题时很重要。3. 可复制配置settings.json 与 config.toml 骨架这一节给出实际能用的配置骨架。不同工具的字段名有差异下面按工具分别列。3.1 Claude Code 的 settings.json 骨架Claude Code 的 MCP 配置通常写在~/.claude.json里Skill 放在~/.claude/skills/。一个包含 MCP 服务器和 API 通道指向的骨架大致如下{ mcpServers: { taotoken-gateway: { command: npx, args: [-y, modelcontextprotocol/server-filesystem, /Users/you/projects], env: { API_BASE: https://taotoken.net/api, API_KEY: sk-your-taotoken-key } } }, env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-your-taotoken-key } }这里的关键是ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY两个字段。把 base URL 指向 TaoToken 的 API 地址Key 填你在控制台创建的那一个Claude Code 就会走统一通道。MCP 服务器里的env是给 MCP 进程自己用的如果你的 MCP 需要访问模型也指向同一个地址。3.2 Codex 的 config.toml 骨架Codex 用 TOMLMCP 配置嵌在~/.codex/config.toml的[tools.mcp]段里。这里要特别注意Codex 的 config.toml 里通常还有 model、web_search 等其他配置写入 MCP 时不能覆盖它们。CC Switch 用toml_edit而不是toml来读写就是为了保留注释和格式。# ~/.codex/config.toml model gpt-5 [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY [tools.mcp.taotoken-gateway] command npx args [-y, modelcontextprotocol/server-filesystem, /Users/you/projects] [tools.mcp.taotoken-gateway.env] API_BASE https://taotoken.net/apienv_key TAOTOKEN_API_KEY表示 Codex 会从环境变量里读 Key而不是硬编码在文件里。这样你只需要在 shell 里 export 一次多个工具都能复用。3.3 CC Switch 的 Skill 同步配置片段CC Switch 的 Skill 采用 SSOT 架构所有 Skill 统一存在~/.cc-switch/skills/再按启用状态投影到各应用目录。同步策略有三种Auto默认先试符号链接失败回退复制、Symlink强制符号链接、Copy强制复制。一个典型的 Skill 投影结果长这样SSOT (~/.cc-switch/skills/code-review/) ├── symlink → ~/.claude/skills/code-review/ (Claude Code) ├── symlink → ~/.codex/skills/code-review/ (Codex) ├── symlink → ~/.gemini/skills/code-review/ (Gemini CLI) └── copy → ~/.config/opencode/skills/code-review/ (OpenCode)如果你之前在 Claude Code 里已经装过 Skill可以用 CC Switch 的import_from_apps()反向导入——它会扫描各应用的本地 skills 目录发现不在 SSOT 管理中的 Skill提示你导入。导入后其他应用也能用这个 Skill不用从零配。3.4 MCP 的跨格式映射MCP 的难点在于 5 个应用 5 种格式。CC Switch 的services/mcp.rs加上mcp/子模块负责格式转换和双向同步。核心映射关系如下应用配置位置格式Claude Code~/.claude.jsonJSONClaude 特有结构Codex~/.codex/config.toml的[tools.mcp]TOMLGemini CLI~/.gemini/settings.jsonJSONGemini 特有结构OpenCode~/.config/opencode/opencode.jsonJSONHermes~/.hermes/config.yamlYAML你在 CC Switch 里勾选「这个 MCP 服务器在 Claude Code 和 Codex 上启用」它会分别写入两个应用的配置文件互不影响。取消勾选时它不只是从数据库删一行而是从对应应用的本地配置文件里真正删除该条目不留残留。4. 验证请求切换工具后确认 Skill 与 MCP 均生效配置写完不算完得验证。下面给出一套可复制的验证动作。4.1 验证 API 通道是否走通先用 curl 直接打 TaoToken 的 API确认 Key 有效curl -s https://taotoken.net/api/v1/messages \ -H x-api-key: sk-your-taotoken-key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: ping}] }返回里带content字段就说明通道正常。如果返回 401检查 Key 是否复制完整返回 404检查 base URL 是否多了或少了/v1。4.2 验证 Skill 是否投影到目标工具在 CC Switch 里启用一个 Skill 后去目标工具的目录确认ls -la ~/.claude/skills/code-review/ ls -la ~/.codex/skills/code-review/如果看到的是符号链接-指向~/.cc-switch/skills/code-review/说明 Symlink 策略生效。如果是普通目录说明走了 Copy 策略。两种都算成功区别只是磁盘占用和更新联动方式。4.3 验证 MCP 是否被目标工具识别以 Claude Code 为例启动后输入/mcp查看已加载的 MCP 服务器列表确认taotoken-gateway在列。Codex 侧可以检查 config.toml 是否被正确写入grep -A 5 tools.mcp ~/.codex/config.toml确认[tools.mcp.taotoken-gateway]段存在且你原有的model、web_search等配置没有被覆盖。这是toml_edit保留格式的价值所在。4.4 验证 Key 无需逐工具重填这是最关键的一步。在 Claude Code 里跑一次对话然后在 Codex 里跑一次对话两边都不需要重新输入 Key。如果 Codex 报「API key not found」检查环境变量TAOTOKEN_API_KEY是否 export 了export TAOTOKEN_API_KEYsk-your-taotoken-key echo $TAOTOKEN_API_KEY把这一行写进~/.zshrc或~/.bashrc新开终端就自动生效。这样多个工具共享同一个环境变量切换时不用重填。5. 本篇常见错排查配置链路出问题时症状往往相似但原因不同。下面按现象归类。5.1 Skill 投影后目标工具读不到最常见的原因是符号链接指向了不存在的路径。CC Switch 的 SSOT 目录如果被移动或删除符号链接就成了死链。用ls -la看链接指向再用readlink -f解析真实路径确认目标存在。另一个原因是目标工具不支持符号链接。少数工具在扫描 skills 目录时会跳过符号链接。这种情况把同步策略从 Auto 改成 Copy强制复制文件。5.2 MCP 写入后 Codex 配置被覆盖如果你手动编辑过~/.codex/config.toml又用 CC Switch 写入 MCP理论上toml_edit会保留你的注释和其他字段。但如果你的 CC Switch 版本较旧可能用的是toml库会重写整个文件。升级到最新版确认它用的是toml_edit。排查方法写入前后各diff一次 config.toml看除了[tools.mcp]段之外有没有其他变化。5.3 切换工具后 Key 失效先确认 Key 本身没过期。去 TaoToken 控制台 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 看 Key 状态。如果 Key 正常检查各工具的 base URL 是否都指向https://taotoken.net/api——有的工具默认走官方地址你改了 Key 但没改地址请求还是打到官方自然失败。5.4 MCP 服务器启动超时CC Switch 安装 Skill 时有 60 秒超时保护MCP 服务器启动也可能因为网络问题卡住。如果你的 MCP 是npx拉起的第一次运行需要下载包可能超过工具的等待时间。先在终端手动跑一次npx -y modelcontextprotocol/server-filesystem /path把包缓存下来再让工具拉起。5.5 同名 Skill 冲突两个仓库都有code-review这个 Skill 时CC Switch 会提示冲突并要求先卸载。这是设计上的保护不是 bug。解决办法是保留你需要的那个来源卸载另一个。如果你确实需要两个版本给其中一个改个目录名再导入。6. 把 Key 和配置一起收敛才是真正的省事Skill 和 MCP 的同步解决的是「配置分发」TaoToken 统一 Key 解决的是「凭证分发」。两者合起来你切换工具时改的东西从「每个工具各改一遍」变成「改一处投影到多处」。如果你还在逐个工具填 Key、逐个工具配 MCP可以先从 TaoToken 的 Key 管理入手把 API 通道统一了再用 CC Switch 把 Skill 和 MCP 收敛到 SSOT。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各工具的 base URL 填法。如果你主要做长期编码或 Agent 类任务可以看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它针对高频调用场景做了额度设计。最后留一个实用技巧把TAOTOKEN_API_KEY写进 shell 的 rc 文件所有支持环境变量读 Key 的工具都能复用。这样即使你新装一个工具也只需要在它的配置里指向https://taotoken.net/apiKey 那一步直接跳过。
Skill 和 MCP 不该是“每个工具配一遍”的体力活——CC Switch 深度拆解（下）：用 TaoToken 统一 Key 打通配置链路
1. 多工具并行时Skill 和 MCP 的配置为什么会失控如果你同时用 Claude Code、Codex、Gemini CLI 这几个 AI 编程工具大概率经历过这样的循环在 Claude Code 里调好一个 code-review 的 Skill换到 Codex 发现目录里空空如也在 Claude Code 里配好一个 MCP 服务器切到 Gemini CLI 又得照着文档重填一遍 URL 和 token。工具越多这种重复劳动越像滚雪球。问题的根源不在于工具本身而在于每个工具都有一套自己的配置约定。Skill 的存放路径不同MCP 的配置格式不同——Claude Code 用 JSON、Codex 用 TOML、Hermes 用 YAML连 JSON 和 JSON 之间的内部结构都不一样。你手动同步一次两次还行工具一多、Skill 一多就变成了纯粹的体力活。CC Switch 这个用 Rust 写的工具思路是把 Skill 和 MCP 都收敛到一个单一事实源SSOT再按需投影到各个应用目录。上篇聊了它的代理接管和用量统计这篇聚焦更实际的问题Skill 和 MCP 怎么统一管理以及怎么用 TaoToken 把 API Key 这条链路也一起打通让切换工具时不用逐工具重填 Key。这篇适合已经在用两个以上 AI 编程工具、被配置同步折磨过的人。下面会给出可复制的 settings.json、config.toml 骨架以及 CC Switch 的配置片段最后附上验证动作——切换工具后确认 Skill 和 MCP 都生效、Key 不用重填。2. 前置准备TaoToken 统一 Key 与 CC Switch 的定位在动手之前先把两个东西的角色分清楚。TaoToken 在这里承担的是「统一 API 通道」的角色。你可以在它的控制台创建一个 Key然后让多个 AI 工具都指向同一个 API 地址和同一个 Key。这样切换工具时改的是工具侧的配置而不是每个工具都去申请、填写一套独立的凭证。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。CC Switch 承担的是「配置分发」的角色。它把 Skill 和 MCP 的配置集中管理再同步到各个应用的本地目录。它本身不生产 Key但它可以把「用哪个 Key、走哪个 API 地址」这件事连同 Skill、MCP 一起作为一套配置投影到不同工具。两者配合的逻辑是TaoToken 解决「凭证统一」CC Switch 解决「配置统一」。你只需要在 TaoToken 控制台维护一个 Key在 CC Switch 里维护一份 Skill 和 MCP 清单剩下的分发交给工具。需要提前准备的东西一个 TaoToken 账号并在控制台创建一个 API Key模型对话入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。安装好 CC Switch并确认它已经能识别你本机的 AI 工具目录。至少两个 AI 编程工具用来验证同步效果。注意CC Switch 的 Skill 和 MCP 同步是本地文件操作不涉及把配置上传到云端。你的 Key 存在本地配置文件里这一点在排查问题时很重要。3. 可复制配置settings.json 与 config.toml 骨架这一节给出实际能用的配置骨架。不同工具的字段名有差异下面按工具分别列。3.1 Claude Code 的 settings.json 骨架Claude Code 的 MCP 配置通常写在~/.claude.json里Skill 放在~/.claude/skills/。一个包含 MCP 服务器和 API 通道指向的骨架大致如下{ mcpServers: { taotoken-gateway: { command: npx, args: [-y, modelcontextprotocol/server-filesystem, /Users/you/projects], env: { API_BASE: https://taotoken.net/api, API_KEY: sk-your-taotoken-key } } }, env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-your-taotoken-key } }这里的关键是ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY两个字段。把 base URL 指向 TaoToken 的 API 地址Key 填你在控制台创建的那一个Claude Code 就会走统一通道。MCP 服务器里的env是给 MCP 进程自己用的如果你的 MCP 需要访问模型也指向同一个地址。3.2 Codex 的 config.toml 骨架Codex 用 TOMLMCP 配置嵌在~/.codex/config.toml的[tools.mcp]段里。这里要特别注意Codex 的 config.toml 里通常还有 model、web_search 等其他配置写入 MCP 时不能覆盖它们。CC Switch 用toml_edit而不是toml来读写就是为了保留注释和格式。# ~/.codex/config.toml model gpt-5 [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY [tools.mcp.taotoken-gateway] command npx args [-y, modelcontextprotocol/server-filesystem, /Users/you/projects] [tools.mcp.taotoken-gateway.env] API_BASE https://taotoken.net/apienv_key TAOTOKEN_API_KEY表示 Codex 会从环境变量里读 Key而不是硬编码在文件里。这样你只需要在 shell 里 export 一次多个工具都能复用。3.3 CC Switch 的 Skill 同步配置片段CC Switch 的 Skill 采用 SSOT 架构所有 Skill 统一存在~/.cc-switch/skills/再按启用状态投影到各应用目录。同步策略有三种Auto默认先试符号链接失败回退复制、Symlink强制符号链接、Copy强制复制。一个典型的 Skill 投影结果长这样SSOT (~/.cc-switch/skills/code-review/) ├── symlink → ~/.claude/skills/code-review/ (Claude Code) ├── symlink → ~/.codex/skills/code-review/ (Codex) ├── symlink → ~/.gemini/skills/code-review/ (Gemini CLI) └── copy → ~/.config/opencode/skills/code-review/ (OpenCode)如果你之前在 Claude Code 里已经装过 Skill可以用 CC Switch 的import_from_apps()反向导入——它会扫描各应用的本地 skills 目录发现不在 SSOT 管理中的 Skill提示你导入。导入后其他应用也能用这个 Skill不用从零配。3.4 MCP 的跨格式映射MCP 的难点在于 5 个应用 5 种格式。CC Switch 的services/mcp.rs加上mcp/子模块负责格式转换和双向同步。核心映射关系如下应用配置位置格式Claude Code~/.claude.jsonJSONClaude 特有结构Codex~/.codex/config.toml的[tools.mcp]TOMLGemini CLI~/.gemini/settings.jsonJSONGemini 特有结构OpenCode~/.config/opencode/opencode.jsonJSONHermes~/.hermes/config.yamlYAML你在 CC Switch 里勾选「这个 MCP 服务器在 Claude Code 和 Codex 上启用」它会分别写入两个应用的配置文件互不影响。取消勾选时它不只是从数据库删一行而是从对应应用的本地配置文件里真正删除该条目不留残留。4. 验证请求切换工具后确认 Skill 与 MCP 均生效配置写完不算完得验证。下面给出一套可复制的验证动作。4.1 验证 API 通道是否走通先用 curl 直接打 TaoToken 的 API确认 Key 有效curl -s https://taotoken.net/api/v1/messages \ -H x-api-key: sk-your-taotoken-key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: ping}] }返回里带content字段就说明通道正常。如果返回 401检查 Key 是否复制完整返回 404检查 base URL 是否多了或少了/v1。4.2 验证 Skill 是否投影到目标工具在 CC Switch 里启用一个 Skill 后去目标工具的目录确认ls -la ~/.claude/skills/code-review/ ls -la ~/.codex/skills/code-review/如果看到的是符号链接-指向~/.cc-switch/skills/code-review/说明 Symlink 策略生效。如果是普通目录说明走了 Copy 策略。两种都算成功区别只是磁盘占用和更新联动方式。4.3 验证 MCP 是否被目标工具识别以 Claude Code 为例启动后输入/mcp查看已加载的 MCP 服务器列表确认taotoken-gateway在列。Codex 侧可以检查 config.toml 是否被正确写入grep -A 5 tools.mcp ~/.codex/config.toml确认[tools.mcp.taotoken-gateway]段存在且你原有的model、web_search等配置没有被覆盖。这是toml_edit保留格式的价值所在。4.4 验证 Key 无需逐工具重填这是最关键的一步。在 Claude Code 里跑一次对话然后在 Codex 里跑一次对话两边都不需要重新输入 Key。如果 Codex 报「API key not found」检查环境变量TAOTOKEN_API_KEY是否 export 了export TAOTOKEN_API_KEYsk-your-taotoken-key echo $TAOTOKEN_API_KEY把这一行写进~/.zshrc或~/.bashrc新开终端就自动生效。这样多个工具共享同一个环境变量切换时不用重填。5. 本篇常见错排查配置链路出问题时症状往往相似但原因不同。下面按现象归类。5.1 Skill 投影后目标工具读不到最常见的原因是符号链接指向了不存在的路径。CC Switch 的 SSOT 目录如果被移动或删除符号链接就成了死链。用ls -la看链接指向再用readlink -f解析真实路径确认目标存在。另一个原因是目标工具不支持符号链接。少数工具在扫描 skills 目录时会跳过符号链接。这种情况把同步策略从 Auto 改成 Copy强制复制文件。5.2 MCP 写入后 Codex 配置被覆盖如果你手动编辑过~/.codex/config.toml又用 CC Switch 写入 MCP理论上toml_edit会保留你的注释和其他字段。但如果你的 CC Switch 版本较旧可能用的是toml库会重写整个文件。升级到最新版确认它用的是toml_edit。排查方法写入前后各diff一次 config.toml看除了[tools.mcp]段之外有没有其他变化。5.3 切换工具后 Key 失效先确认 Key 本身没过期。去 TaoToken 控制台 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 看 Key 状态。如果 Key 正常检查各工具的 base URL 是否都指向https://taotoken.net/api——有的工具默认走官方地址你改了 Key 但没改地址请求还是打到官方自然失败。5.4 MCP 服务器启动超时CC Switch 安装 Skill 时有 60 秒超时保护MCP 服务器启动也可能因为网络问题卡住。如果你的 MCP 是npx拉起的第一次运行需要下载包可能超过工具的等待时间。先在终端手动跑一次npx -y modelcontextprotocol/server-filesystem /path把包缓存下来再让工具拉起。5.5 同名 Skill 冲突两个仓库都有code-review这个 Skill 时CC Switch 会提示冲突并要求先卸载。这是设计上的保护不是 bug。解决办法是保留你需要的那个来源卸载另一个。如果你确实需要两个版本给其中一个改个目录名再导入。6. 把 Key 和配置一起收敛才是真正的省事Skill 和 MCP 的同步解决的是「配置分发」TaoToken 统一 Key 解决的是「凭证分发」。两者合起来你切换工具时改的东西从「每个工具各改一遍」变成「改一处投影到多处」。如果你还在逐个工具填 Key、逐个工具配 MCP可以先从 TaoToken 的 Key 管理入手把 API 通道统一了再用 CC Switch 把 Skill 和 MCP 收敛到 SSOT。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各工具的 base URL 填法。如果你主要做长期编码或 Agent 类任务可以看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它针对高频调用场景做了额度设计。最后留一个实用技巧把TAOTOKEN_API_KEY写进 shell 的 rc 文件所有支持环境变量读 Key 的工具都能复用。这样即使你新装一个工具也只需要在它的配置里指向https://taotoken.net/apiKey 那一步直接跳过。
