对于国内开发者来说,使用 Claude Code 最头疼的莫过于官方API高昂的价格和API连接稳定性差的问题。一般情况下我都是配置好几套不同的 API 配置(比如 Qwen、DeepSeek、OpenRouter 等),来根据稳定、性能、性价比等不同的需求来切换API供应商。

但是每次想换个模型,都要去手动修改 ~/.claude/settings.jsonconfig.json,不仅麻烦还容易改错格式。

今天我终于找到了一个很很用的工具:一个轻量级的终端工具 CCM (Claude Config Manager),专门解决这个问题。它不占用内存,不需要图形界面,只需几条命令就能实现多套 API 配置的集中管理和秒级切换。

🛠️ CCM 是什么?

CCM 是一个运行在终端的命令行工具,它能帮你:

  • 集中存储:把 Anthropic 官方、中转站、第三方聚合平台的 Key 和 URL 存在一起。

  • 一键切换:通过 ccm use 命令瞬间切换当前 Claude Code 使用的 API,无需重启终端。

  • 安全脱敏:在终端显示配置列表时,自动隐藏 API Key 的敏感部分。

📦 安装指南

确保你的电脑已安装 Node.js 环境,直接在终端运行以下命令进行全局安装:

npm install -g claude-config-manager

安装完成后,输入以下命令验证是否成功:

ccm --version
# 如果显示版本号,说明安装成功

🚀 快速上手指南

这是你最常用的核心操作流程,建议收藏。

1. 添加配置 (Add)

你可以通过交互式向导添加,也可以直接用一行命令添加。

  • 方式一:交互式添加(推荐新手)
    输入命令后,按提示填入名称、Key 和 URL:

    ccm add
  • 方式二:命令行直接添加(高效)
    适合复制粘贴,一步到位。例如添加 Qwen 的配置:

    ccm add -n qwen-max -k sk-你的APIKey -u https://dashscope.aliyuncs.com/compatible-mode/v1
    • -n: 配置名称(自定义,如 qwendeepseek

    • -k: 你的 API Key

    • -u: Base URL 地址

2. 查看列表 (List)

添加完后,查看所有已保存的配置:

ccm ls
# 或者使用全称 ccm list

终端会以表格形式展示所有配置,当前正在使用的配置会有标记,API Key 会显示为 sk-**** 以保护隐私。

3. 切换配置 (Switch)

这是最高频的操作。

  • 交互式切换

    ccm switch

    会弹出一个列表,用上下键选择你想用的配置,回车确认。

  • 指定名称切换
    如果你记得配置名称,可以直接切换,速度最快:

    ccm use qwen-max
    # 或者
    ccm switch deepseek

4. 查看当前状态 (Current)

不确定现在用的是哪个 API 时,随时查询:

ccm current

⚙️ 进阶技巧与模板

使用预设模板
CCM 内置了常用平台的模板,不用手动输 URL。

  • Anthropic 官方ccm add --template anthropic-official

  • OpenRouterccm add --template openrouter

删除配置
不再需要的配置可以直接移除:

ccm rm qwen-max

💡 常见问题与注意事项

  • 切换后需要重启 Claude Code 吗?
    通常不需要重启终端,但建议重启 Claude Code 的会话进程,确保新配置立即生效。

  • 配置文件存在哪?
    CCM 的配置文件位于 ~/.claude-config-manager/config.json。你可以直接备份这个文件来迁移配置。

  • 安全性如何?
    所有数据仅存储在你本地,不会上传到任何服务器。

📌 总结

CCM 的逻辑非常简单:一个工具只做好一件事。它没有复杂的图形界面,也没有多余的功能,就是纯粹地帮你管理 API 配置。

如果你也是多 API 用户,强烈建议安装一个,把原本繁琐的“改文件-重启”过程变成简单的“ccm use”,开发体验会顺畅很多。

项目地址https://github.com/yangtuooc/claude-config-manager

文章作者: 嘿手大叔
本文链接:
版权声明: 本站所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 i·Space
喜欢就支持一下吧
打赏
微信 微信
支付宝 支付宝