ccuse: Claude Code CLI 配置文件切换工具

Kevinten10

210人浏览 · 2026-07-28 00:07:12

Kevinten10 · 2026-07-28 00:07:12 发布

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 密钥 编辑自动打开的配置文件
选择范围 为每个配置选择：一次性会话、项目特定或全局