Agent Skills
返回列表
🤖

用 CC Switch 统一管理代理 CLI 提供者

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据官方安装指南 https://skillhub.cn/install/skillhub.md,将规范名为 @user_3c6cb52e/manage-agent-cli-providers-and-mcp-settings-with-cc-switch 的技能安装到你的 AI 助手中。

技能介绍

要解决的问题

当你同时使用 Claude Code、Codex、Gemini CLI、OpenCode 或 OpenClaw 等代理 CLI 工具时,每个工具都会独立维护自己的配置目录。提供者的 API 凭证、MCP 服务器定义、自定义提示词、已安装的技能,乃至会话历史和用量统计,往往散落在各自的配置文件或环境变量中。一旦你在多个工具之间切换,或者想要统一调整某个提供者的设置,就得逐个打开对应的配置文件,手动比对、复制、粘贴。稍有不慎就会出现配置漂移:某个工具的提供者密钥过期了,另一个工具的 MCP 服务器地址还指向旧环境,而你直到运行出错时才察觉。

技能如何工作

这个技能以 CC Switch 桌面应用为核心,把分散在各个代理 CLI 中的配置收敛到一个统一入口里。它的核心能力包括:

  • 统一管理提供者配置文件:将不同工具的提供者凭证、API 端点、模型参数集中维护,避免逐个文件修改。
  • 集中定义 MCP 服务器:在同一个界面中维护 MCP 服务器列表,确保 Claude Code、Codex 等工具加载的是同一套服务器配置。
  • 同步提示词与技能:让自定义提示词和技能在多个 CLI 工具间保持一致,减少重复维护。
  • 追踪会话与用量:记录各工具的会话记录和 API 调用统计,方便审计与成本分析。

关键步骤大致是:先在本地安装 CC Switch 桌面应用,并确保目标代理 CLI(如 Claude Code、Codex、Gemini CLI、OpenCode 或 OpenClaw)已就绪;然后导入或创建提供者配置文件,按需配置 MCP 服务器定义;之后通过 CC Switch 的界面将配置分发到各个工具。提供者凭证是必需的,MCP 服务器定义则是可选的——如果你的工作流不依赖外部 MCP 服务,可以跳过这一步。

适用边界与注意点

需要注意的是,该技能的 SKILL.md 中并未提供自动化的安装或使用说明。这意味着你需要先访问上游仓库(https://github.com/1991513ccie-png/skills)审查项目代码,确认其行为符合预期后再使用。特别是在涉及敏感工作流时,建议先在测试环境中验证配置分发是否正确,避免因自动化脚本覆盖了已有配置而引发问题。

另外,CC Switch 本身是一个第三方桌面应用,其安全性和稳定性取决于上游项目的维护情况。如果你所在团队有严格的配置管理流程,建议将 CC Switch 生成的配置纳入版本控制,并通过代码评审来管理变更。

使用场景

  • 同时使用Claude Code、Codex和Gemini CLI时,需要统一调整提供者API凭证和MCP服务器地址,避免逐个工具手动修改配置文件
  • 团队协作中,成员使用不同代理CLI工具,需要同步自定义提示词和技能配置,确保输出风格一致
  • 迁移提供者服务时,需要快速将旧环境配置分发到所有代理CLI工具,减少配置漂移导致的运行错误
  • 定期审计时,需要查看各代理CLI工具的会话记录和API调用统计,汇总成本数据

适合人员

  • 同时使用多个代理CLI工具的开发者,需要统一管理配置,减少重复操作
  • 维护团队代理CLI工作流的工程师,需要确保不同成员的配置一致,避免协作问题
  • 需要频繁切换提供者服务的用户,需要快速更新所有工具的配置,降低配置错误风险
  • 负责成本审计的团队成员,需要查看各工具的用量数据,汇总成本报告