ccuse: Claude Code CLI 配置文件切换工具
本仓库包含 ccuse，一个为 Claude Code CLI 设计的命令行配置文件切换工具。该工具使开发者能够在三个配置范围上切换原生 Claude Code 账户/订阅模式和兼容的 API 提供商：全局、项目级别或单次临时 shell 会话。
工具功能说明
根据仓库文档，ccuse 解决了使用 Claude Code 搭配多个 AI API 提供商时的特定需求。开发者无需在每次想使用不同模型提供商时手动编辑配置文件或管理多套环境变量，ccuse 通过简单的 shell 命令创建、存储和激活配置。
文档显示支持五种 API 提供商配置：
- Claude（原生） - 直接使用 Claude Code 账户/订阅或 Anthropic API
- 火山引擎 Ark - 使用火山引擎 Ark Agent Plan
- GLM（通过 Ark Agent Plan） - 通过火山引擎 Ark Agent Plan 使用 GLM 模型
- Kimi - 使用月之暗面（Moonshot AI）的 Kimi API
- MiniMax - 使用 MiniMax API
每种配置对应特定的模型。例如，火山引擎 Ark 配置支持 doubao-seed-2-0-code-preview-260215，GLM 配置支持 GLM-5.1、GLM-4.7 和 GLM-4.7-FlashX，Kimi 配置支持 kimi-k2.6，MiniMax 配置支持 MiniMax-M2.7 和 MiniMax-M2.7-highspeed。根据各提供商的文档规格，这些模型的上下文窗口最高可达 256K。
三种配置范围
文档中描述的关键设计特性之一是能够在三个不同范围应用配置，每个范围具有不同的持久性特征。
全局范围
全局配置切换会修改 Claude Code 的主 settings.json 文件。激活后，所选配置将成为系统上任何位置启动的所有 Claude Code 实例的默认配置。工具会在切换配置前自动创建当前设置文件的备份。
此范围的命令包括：
ccuse claude或ccuse global claude- 切换到原生 Claude 配置ccuse ark或ccuse global ark- 切换到火山引擎 Ark 配置ccuse glm或ccuse global glm- 切换到 GLM 配置ccuse kimi或ccuse global kimi- 切换到 Kimi 配置ccuse minimax或ccuse global minimax- 切换到 MiniMax 配置
项目范围
项目级别的配置允许特定仓库或工作目录使用与全局默认不同的提供商。当处理具有不同模型要求的多个项目，或者想要隔离测试特定提供商而不影响全局默认配置时，这一功能非常有用。
项目范围会在当前工作目录中创建 ./.claude/settings.json 文件，而不修改全局的 ~/.claude/settings.json 文件。从该目录启动时，Claude Code 会自动读取项目级配置。
命令包括：
ccuse project <配置名>- 为当前项目持久化配置ccuse project show- 显示当前项目配置ccuse project rm- 移除项目特定配置
会话范围
会话级别的切换完全通过环境变量操作，不进行任何永久性文件更改。这对于一次性测试或临时尝试不同提供商而不更改任何持久化配置时非常有用。
使用 eval "$(ccuse local <配置名>)" 时，配置的环境变量会加载到当前 shell 会话中。ccuse start <配置名> 命令会加载环境变量并立即启动 Claude Code。
还提供了快速启动快捷方式：
ccuse cc- Claude 配置 + 启动ccuse ca- Ark 配置 + 启动ccuse ck- Kimi 配置 + 启动ccuse cg- GLM 配置 + 启动ccuse cm- MiniMax 配置 + 启动
可以添加 -c 或 --continue 标志来恢复上一次 Claude Code 对话。
配置管理功能
除了切换配置，工具还包含多个配置管理命令：
ccuse init-<提供商>- 创建或重新配置配置模板ccuse list- 列出所有可用配置并标记当前激活的配置ccuse show- 显示当前 Claude Code 配置（密钥已掩码）ccuse doctor- 检查设置、活动范围并建议后续步骤ccuse edit <名称>- 打开配置文件进行编辑ccuse remove <名称>- 确认后移除配置
文档中提到，ccuse doctor 命令对于初次使用或故障排除时特别有用，因为它会检查 Claude Code、Python、配置和项目设置是否正确配置。
安装方法
文档中记录了三种安装方法：
- 单行安装（推荐） ：直接下载脚本到
~/.local/bin/ccuse并赋予执行权限 - 通过 Claude Code Skill 安装：可以直接让 Claude Code 安装
- 手动安装：克隆仓库并创建可执行文件的符号链接
安装后，ccuse --help 可验证工具是否正常工作。
配置设置流程
文档中记录的配置设置工作流程分为五个步骤：
- 检查设置 使用
ccuse doctor验证前提条件 - 保存当前 Claude 设置 使用
ccuse init-claude创建原生 Claude 配置 - 创建其他配置 使用
ccuse init-ark、ccuse init-glm、ccuse init-kimi或ccuse init-minimax等命令 - 设置 API 密钥 编辑自动打开的配置文件
- 选择范围 为每个配置选择：一次性会话、项目特定或全局
创建配置时，init 命令会使用用户首选的编辑器（顺序：$EDITOR 环境变量、VS Code code、然后是 nano）自动打开配置文件进行编辑。
自定义配置
文档指出，开发者可以为任何与 Anthropic 兼容的 API 创建自定义配置。自定义配置以 JSON 文件形式存储在 ~/.claude/profiles/ 中，可包含 API 密钥、基础 URL、超时设置和其他环境变量的配置。
配置命名规则已指定：名称必须以字母或数字开头，可以包含字母、数字、点、下划线和连字符。某些名称是保留的，不能用于自定义配置，包括内置命令和别名。
文件结构
工具在 ~/.claude/ 下的以下目录结构中存储配置和设置：
settings.json- 活动的全局配置settings.json.bak- 自动备份profiles/- 包含各个配置 JSON 文件的目录
有多个环境变量可用于自定义这些路径，包括 CLAUDE_DIR、PROFILE_DIR、SETTINGS_FILE、BACKUP_SUFFIX、PROJECT_CLAUDE_DIR 和 PROJECT_SETTINGS_FILE。
测试
仓库包含使用 bats-core（Bash 自动化测试系统）的完整测试套件。安装 bats 后可以使用 bats tests/test_ccuse.bats 运行测试。
功能解读与使用场景
根据记录的功能，该工具似乎最适合经常使用 Claude Code 且希望在无需手动配置开销的情况下试验多个 AI API 提供商的开发者。三种范围（全局、项目、会话）提供了匹配不同工作流的灵活性。
跨多个使用不同模型要求的项目工作的开发者可能会发现项目范围的配置特别有用，允许每个仓库维护自己的默认提供商而不影响全局配置。同样，会话级别的切换非常适合在相同任务上并排测试不同的提供商。
创建自定义配置的能力也意味着该工具不仅限于五个预配置的提供商，可能将其实用性扩展到任何具有 Anthropic 兼容身份验证的 API 端点。