cc-use-model

English | 中文

Interactively select provider and model for Claude Code, automatically writing configuration to ~/.claude/settings.json.

Credentials file is auto-discovered across multiple paths, or can be specified via flag or environment variable.

Requirements

• Node.js 18+ (see engines in package.json)

Installation

# Global install
npm install -g cc-use-model

# Or use npx (no installation needed)
npx cc-use-model

Credentials Format credentials.json

Copy the example and fill in:

cp credentials.json.example credentials.json

Each top-level key is a provider. For each provider, use one of:

• Standard provider: apiUrl + apiKey (both non-empty strings)
• env provider: an env object (string keys and non-empty string values); apiUrl / apiKey on that entry are ignored

| Field | Description | | -------- | ----------- | | apiUrl | Used with apiKey: Anthropic-compatible API endpoint | | apiKey | Used with apiUrl: authentication token | | env | Alternative to the pair above: key/value object (values must be strings); keys are written into env in ~/.claude/settings.json | | models | Optional string array; if omitted, enter the model name interactively at runtime |

Usage

# Run directly (after global install)
cc-use-model

# Specify credentials file
cc-use-model -f /path/to/credentials.json

# Via environment variable
export CC_USE_MODEL_CREDENTIALS=/path/to/credentials.json
cc-use-model

# Help
cc-use-model -h

Credentials lookup order (when -f is not specified):

1. File pointed to by CC_USE_MODEL_CREDENTIALS
2. ./credentials.json in the current working directory
3. credentials.json next to the installed tool (useful with npm link)
4. ~/.config/cc-use-model/credentials.json

Interactive menu

When run without a subcommand, the tool presents a top-level menu:

• 🎯 Select Provider / Model — pick a provider, then its model, then apply the selection to ~/.claude/settings.json. Both the provider list and model list have a ← Back option so you can navigate up. After applying, you're returned to the menu.
• ➕ Add Provider — interactively add a new provider (or overwrite an existing one) and save it to credentials.json. After saving, you're asked whether to immediately apply it.
• ⚙️ Manage credentials (edit / delete) — list every provider with details (URL / type / models) and let you edit or delete each entry. Standard providers (apiUrl / apiKey) support full editing; env providers support editing the models field and deletion (edit the env object manually for advanced changes).
• 🗑️ Clear configuration (only shown when needed) — appears only when ~/.claude/settings.json has third-party config to clear; displays the current state (e.g., "正在使用 qcloud / glm-4.5"). The option is hidden if using native credentials or no credentials at all.
• 👋 Exit

After completing any action (select / add / manage / clear), you're returned to the top-level menu, so you can perform multiple operations in one session. The menu updates dynamically after each action (e.g., "Clear configuration" appears/disappears as the state changes).

First-time experience: if credentials.json is missing or empty, the tool skips the menu and goes straight to the Add Provider flow. After saving, it asks whether to apply the new provider immediately.

Subcommand apply-envs

Prints shell variable assignment statements to stdout from the current ~/.claude/settings.json, so you can load them into your shell. Does not read credentials.json.

# bash / zsh
eval "$(cc-use-model apply-envs)"

# PowerShell
cc-use-model apply-envs | Invoke-Expression

# cmd
cc-use-model apply-envs --shell cmd

Options:

| Option | Description | | ------ | ----------- | | --shell <type> | Force output format: bash, zsh, powershell, or cmd. Auto-detected from environment if omitted. |

Outputs ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, ANTHROPIC_MODEL, and any other variables previously written by an env provider and listed in envKey. Exits with a non-zero status if nothing is configured.

Subcommand restore-login

Manually restore the native Claude login credential from the backup file created by this tool.

cc-use-model restore-login

Reads the backup at ~/.config/cc-use-model/claude-native-credentials.backup.json and writes it back to the system keychain (macOS) or ~/.claude/.credentials.json (Linux). Not supported on Windows.

Subcommand toggle-bypass

Toggle permissions.defaultMode = "bypassPermissions" in ~/.claude/settings.json. This is equivalent to launching Claude Code with the --dangerously-skip-permissions flag, but persists in the global config so every session inherits it.

# Toggle (flip the current state)
cc-use-model toggle-bypass

# Explicitly enable / disable
cc-use-model toggle-bypass on
cc-use-model toggle-bypass off

When disabling, only the defaultMode field is removed; any other entries under permissions (e.g. allow / deny lists) are preserved. If permissions ends up empty, the empty object is removed too.

The interactive menu also shows a 🛡️ Toggle bypassPermissions (current: on/off) entry that does the same thing.

⚠️ Bypassing all permission prompts is risky — only enable it in sandboxed / isolated environments.

Behavior

• Preserves other top-level fields in settings.json (e.g. skipDangerousModePermissionPrompt) that are not part of this update.
• After you pick a model, sets the top-level model field to that choice in addition to merging env.
• Standard provider (apiUrl / apiKey): keeps other env entries; only overwrites ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, and ANTHROPIC_MODEL.
• env provider: writes the keys from env plus ANTHROPIC_MODEL; stores envKey (list of keys from that provider) so switching back to a standard provider can remove those keys automatically.
• Clear configuration: removes ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, ANTHROPIC_MODEL, and all keys previously written via env providers (as tracked by envKey). If the previous top-level model was backed up before switching to a third-party provider, it is restored; otherwise the top-level model is removed.
• Native credential backup: before writing a third-party provider's config, the tool automatically backs up any existing native Claude credential (macOS Keychain / ~/.claude/.credentials.json on Linux) and the current top-level model to ~/.config/cc-use-model/claude-native-credentials.backup.json. The backup is restored automatically when you choose Clear configuration, or manually via restore-login.

Security

Do not commit credentials.json with real API keys to Git. Add it to .gitignore.

License

MIT

中文

交互式选择 Claude Code 的 provider 和 model，自动将配置写入 ~/.claude/settings.json。

凭据文件自动查找，支持多路径探测，也可通过参数或环境变量指定。

环境要求

• Node.js 18+（见 package.json 的 engines）

安装

# 全局安装
npm install -g cc-use-model

# 或使用 npx（无需安装）
npx cc-use-model

凭据格式 credentials.json

复制示例并填写：

cp credentials.json.example credentials.json

每个顶层 key 为一个 provider。每个 provider 二选一：

• 普通 provider：提供 apiUrl + apiKey（均为非空字符串）
• env provider：提供 env 对象（键与非空字符串值）；此时忽略该条目的 apiUrl / apiKey

| 字段 | 说明 | | -------- | -------------------------------------------------------------------- | | apiUrl | 与 apiKey 成对使用：Anthropic 兼容 API 地址 | | apiKey | 与 apiUrl 成对使用：令牌 | | env | 可选替代上述二者：键值对象（value 必须为字符串）；把这些键写入 ~/.claude/settings.json 的 env | | models | 可选，字符串数组；无则运行时手动输入 model |

使用

# 直接运行（全局安装后）
cc-use-model

# 指定凭据文件
cc-use-model -f /path/to/credentials.json

# 通过环境变量指定
export CC_USE_MODEL_CREDENTIALS=/path/to/credentials.json
cc-use-model

# 查看帮助
cc-use-model -h

凭据查找顺序（未指定 -f 时）：

1. 环境变量 CC_USE_MODEL_CREDENTIALS 指向的文件
2. 当前目录 ./credentials.json
3. 本工具所在目录下的 credentials.json（npm link 后从任意目录执行都会读到）
4. ~/.config/cc-use-model/credentials.json

交互式菜单

不带子命令运行时，工具会弹出顶层菜单：

• 🎯 选择 Provider / Model — 选择 provider，再选 model，应用到 ~/.claude/settings.json。provider 列表和 model 列表都带有 ← 返回上一层 选项，可逐级返回。应用成功后返回菜单
• ➕ 添加 Provider — 交互式新增 provider（或覆盖已有同名 provider）并保存回 credentials.json。保存后会询问是否立即使用
• ⚙️ 管理凭据（编辑 / 删除） — 列出所有 provider 及其详情（URL / 类型 / models），可对每项执行编辑或删除。标准 provider（apiUrl / apiKey）支持完整编辑；env provider 支持编辑 models 字段及删除（如需修改 env 对象请手动编辑文件）
• 🗑️ 清空配置（当前状态）（仅在需要时显示）—— 只有当 ~/.claude/settings.json 有第三方配置需要清理时才显示，菜单项文案会显示当前实际状态（例如：🗑️ 清空配置（正在使用 qcloud / glm-4.5））。正在使用官方登录凭证或无任何凭据时该选项隐藏
• 👋 退出

任意操作（选择 / 添加 / 管理 / 清空）完成后都会返回顶层菜单，可在一次会话中连续执行多个操作。每次回到菜单都会根据当前配置动态调整选项（例如：应用第三方配置后会出现"清空配置"，清空后该选项消失）。

首次使用：当 credentials.json 不存在或为空时，工具会跳过菜单直接进入"添加 Provider"流程；保存后会询问是否立即使用刚添加的 provider。

子命令 apply-envs

根据当前 ~/.claude/settings.json 中的配置，向标准输出打印环境变量赋值语句，便于在当前 shell 中生效。不读取 credentials.json。

# bash / zsh
eval "$(cc-use-model apply-envs)"

# PowerShell
cc-use-model apply-envs | Invoke-Expression

# cmd
cc-use-model apply-envs --shell cmd

选项：

| 选项 | 说明 | | ---- | ---- | | --shell <type> | 指定输出格式：bash、zsh、powershell 或 cmd。不指定时自动检测。 |

会输出 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL，以及此前由 env provider 写入且记录在 envKey 中的其它变量。若当前无任何配置，命令会以非零退出码结束。

子命令 restore-login

手动从本工具创建的备份文件恢复原生 Claude 登录凭据。

cc-use-model restore-login

读取 ~/.config/cc-use-model/claude-native-credentials.backup.json 中的备份，并写回系统 Keychain（macOS）或 ~/.claude/.credentials.json（Linux）。Windows 暂不支持。

子命令 toggle-bypass

切换 ~/.claude/settings.json 中的 permissions.defaultMode = "bypassPermissions"。等价于以 --dangerously-skip-permissions 启动 Claude Code，区别在于它会持久写入全局配置，之后每次会话都默认生效。

# 切换当前状态
cc-use-model toggle-bypass

# 显式开启 / 关闭
cc-use-model toggle-bypass on
cc-use-model toggle-bypass off

关闭时仅移除 defaultMode 字段，保留 permissions 下的其它配置（如 allow / deny 列表）；若 permissions 因此变空，会一并删除该空对象。

交互菜单中也有 🛡️ 切换 bypassPermissions（当前：已开启/已关闭） 选项，效果一致。

⚠️ 跳过权限校验存在风险，请仅在沙盒 / 隔离环境中开启。

行为说明

• 会保留 settings.json 里除本次写入涉及的字段外的其它顶层字段（如 skipDangerousModePermissionPrompt）。
• 每次选定 model 后，除合并 env 外，还会将顶层 model 设为当前选择的 model。
• 使用普通 provider（apiUrl / apiKey）时：其它 env 变量会保留，仅覆盖 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL。
• 使用 env provider 时：会覆盖写入 env 中提供的键，以及 ANTHROPIC_MODEL；并记录 envKey（写入过的 env 键列表），用于下次切换到无 env 的 provider 时自动清理这些键。
• 选择 清空配置 选项时：会删除 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL，以及之前通过 env provider 写入并由 envKey 记录的所有键；如果切换到第三方 provider 前备份过顶层 model，会恢复该 model，否则删除顶层 model。
• 原生凭据自动备份：切换到第三方 provider 之前，工具会自动将系统中的原生 Claude 凭据（macOS Keychain / Linux 的 ~/.claude/.credentials.json）和当前顶层 model 备份到 ~/.config/cc-use-model/claude-native-credentials.backup.json。选择清空配置时自动恢复备份，也可通过 restore-login 手动恢复。

安全

请勿将含真实密钥的 credentials.json 提交到 Git；建议加入 .gitignore。

License

MIT