Skip to content
BranchesTags

Repository files navigation

简体中文 | English

cc-switch

cc-switch 是一个 Rust 编写的跨平台 CLI，现在同时支持两种切换模式：

  • Claude Code JSON profile 切换
  • Codex config.toml / auth.json 预设切换，并支持可选的 models_catalog.json

工具保持小而直接：

  • 使用本地预设覆盖目标配置
  • 每次覆盖前自动备份
  • 不输出敏感值
  • 在 Windows / macOS / Linux 上以单文件可执行程序运行

命令

Claude Code：

cc-switch list
cc-switch current
cc-switch use <name>
cc-switch next
cc-switch before
cc-switch doctor

Codex：

cc-switch cx list
cc-switch cx current
cc-switch cx use <name>
cc-switch cx next
cc-switch cx before

也可以使用只面向 Codex 的独立命令：

cx-switch list
cx-switch current
cx-switch use <name>
cx-switch next
cx-switch before

行为规则：

  • Claude profile 按文件名排序，通过规范化 JSON 内容识别当前项
  • Codex profile 按目录名排序，通过 ~/.cc-switch-simple/codex/current 记录当前项
  • use、next 和 before 真正切换前都会先备份现有目标文件
  • next 在当前项缺失或无法识别时，会回退到第一个 profile
  • before 使用最近一次成功切换前的 profile，不按名称排序
  • before 在没有历史记录、历史记录非法或 profile 已删除时会提示并跳过

运行时目录

默认运行时根目录：

  • Linux/macOS: ~/.cc-switch-simple/
  • Windows: 用户配置目录下的 cc-switch-simple/

Claude Code 相关文件：

  • profiles/：Claude JSON profile
  • current：当前选择记录
  • before：最近一次成功切换前的 profile 记录
  • backups/：Claude 自动备份
  • config.toml：可选配置

Claude Code 默认目标配置路径：

  • ~/.claude/settings.json

可通过 config.toml 覆盖：

[claude]
settings_path = "~/.claude/settings.json"

[backups]
max_files = 5

说明：

  • [backups].max_files 默认是 5
  • max_files 必须大于 0
  • 同时作用于 Claude 和 Codex 的自动备份保留数量；对于 Codex，会对 config.toml、auth.json 和存在的 models_catalog.json 分别保留 max_files 个备份
  • 如果 settings_path 是相对路径，会相对 config.toml 所在目录解析

Codex 相关文件：

  • 预设根目录：~/.cc-switch-simple/codex/
  • 预设配置：~/.cc-switch-simple/codex/<name>/config.toml
  • 预设认证：~/.cc-switch-simple/codex/<name>/auth.json
  • 当前选择记录：~/.cc-switch-simple/codex/current
  • 上一次切换记录：~/.cc-switch-simple/codex/before
  • 备份目录：~/.cc-switch-simple/backups/codex/
  • 当前生效配置：${CODEX_HOME:-$HOME/.codex}/config.toml
  • 当前生效认证：${CODEX_HOME:-$HOME/.codex}/auth.json
  • 当前生效模型目录（可选）：${CODEX_HOME:-$HOME/.codex}/models_catalog.json

Codex 模式会一起切换配置和认证这两个文件，并按预设处理可选模型目录：

  • 选中的预设目录必须同时包含 config.toml 和 auth.json
  • 如果预设包含 models_catalog.json，切换时会一并写入；如果不包含，切换时会先备份并删除活动目录中的旧文件
  • 覆盖或删除前会分别备份当前目标文件
  • 切换离开当前 Codex 预设前，如果 ${CODEX_HOME:-$HOME/.codex}/auth.json 有变化，会自动保存回当前预设；ChatGPT Plus 登录状态会随 profile 自动更新
  • cc-switch / cx-switch 不会输出 API Key 或 token 内容

自动创建规则：

  • Claude 相关命令会自动创建 ~/.cc-switch-simple/、profiles/、backups/
  • cc-switch cx use <name> 和 cx-switch use <name> 会自动创建 ~/.cc-switch-simple/codex/、~/.cc-switch-simple/backups/codex/，以及 ${CODEX_HOME:-$HOME/.codex}/
  • ~/.cc-switch-simple/codex/<name>/ 和其中的 config.toml、auth.json、可选 models_catalog.json 不会自动生成，仍需手动准备
  • cc-switch cx list 和 cc-switch cx current 只读取现有文件，不会初始化预设目录

Claude Profile 初始化

仓库 profiles/ 目录仍提供示例模板：

  • profiles/official.template.json
  • profiles/deepseek.template.json
  • profiles/local-test.template.json

复制到运行时目录并去掉 .template 后缀即可：

mkdir -p ~/.cc-switch-simple/profiles
cp profiles/official.template.json ~/.cc-switch-simple/profiles/official.json
cp profiles/deepseek.template.json ~/.cc-switch-simple/profiles/deepseek.json
cp profiles/local-test.template.json ~/.cc-switch-simple/profiles/local-test.json

Codex 预设初始化

仓库 codex/ 目录也提供可直接复制的 Codex 预设示例：

  • codex/openai/config.toml
  • codex/openai/auth.json
  • codex/deepseek/config.toml
  • codex/deepseek/auth.json
  • codex/deepseek/models_catalog.json
  • codex/xxxcom/config.toml
  • codex/xxxcom/auth.json

仓库内置的 codex/deepseek/ 预设已配置为直连 DeepSeek 官方 API：

model = "deepseek-v4-flash"
model_provider = "deepseek"
model_catalog_json = "models_catalog.json"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
model_reasoning_effort = "high"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com/v1"
wire_api = "responses"

codex/deepseek/models_catalog.json 用于 Codex 的模型能力和模型选择器，不是 API Key 文件。

先创建预设目录，再把示例复制过去：

mkdir -p ~/.cc-switch-simple/codex/openai
mkdir -p ~/.cc-switch-simple/codex/deepseek
mkdir -p ~/.cc-switch-simple/codex/xxxcom
cp codex/openai/config.toml ~/.cc-switch-simple/codex/openai/config.toml
cp codex/openai/auth.json ~/.cc-switch-simple/codex/openai/auth.json
cp codex/deepseek/config.toml ~/.cc-switch-simple/codex/deepseek/config.toml
cp codex/deepseek/auth.json ~/.cc-switch-simple/codex/deepseek/auth.json
cp codex/deepseek/models_catalog.json ~/.cc-switch-simple/codex/deepseek/models_catalog.json
cp codex/xxxcom/config.toml ~/.cc-switch-simple/codex/xxxcom/config.toml
cp codex/xxxcom/auth.json ~/.cc-switch-simple/codex/xxxcom/auth.json

复制后，在 ~/.cc-switch-simple/codex/deepseek/auth.json 填入你的 DeepSeek API Key，再执行 cx-switch use deepseek 或 cc-switch cx use deepseek。

复制后可按需编辑。例如 ~/.cc-switch-simple/codex/openai/config.toml：

model = "gpt-5"
model_provider = "openai"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

~/.cc-switch-simple/codex/openai/auth.json：

{
  "OPENAI_API_KEY": "<redacted>"
}

~/.cc-switch-simple/codex/xxxcom/config.toml：

disable_response_storage = true
model = "gpt-5.5"
model_reasoning_effort = "high"
model_provider = "xxxcom"
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.xxxcom]
name = "xxxcom"
base_url = "https://xxxcom.net/v1"
requires_openai_auth = true
wire_api = "responses"

~/.cc-switch-simple/codex/xxxcom/auth.json：

{
  "XXXCOM_API_KEY": "<redacted>"
}

切换时，cc-switch 或 cx-switch 会先备份，再覆盖 ${CODEX_HOME:-$HOME/.codex}/config.toml 和 ${CODEX_HOME:-$HOME/.codex}/auth.json，并按预设存在与否写入或删除 models_catalog.json。如果 Codex 或 ChatGPT Plus 登录流程更新了当前 auth.json，下次切换离开该预设时会自动写回 ~/.cc-switch-simple/codex/<name>/auth.json，无需手动同步。

使用

Claude Code：

cc-switch list
cc-switch current
cc-switch use deepseek
cc-switch next
cc-switch before
cc-switch doctor

Codex：

cc-switch cx list
cc-switch cx current
cc-switch cx use openai
cc-switch cx next
cc-switch cx before

或：

cx-switch list
cx-switch current
cx-switch use openai
cx-switch next
cx-switch before

构建与验证

在仓库根目录执行：

cargo build --release
cargo fmt
cargo clippy --all-targets --all-features -- -D warnings
cargo test

生成的单文件可执行程序位于：

  • Linux/macOS: target/release/cc-switch
  • Windows: target\\release\\cc-switch.exe
  • Codex 独立入口：target/release/cx-switch（Windows 为 cx-switch.exe）

约束

  • 不依赖 Python、Node、Bash、Zsh
  • 单文件二进制分发
  • 使用 clap、serde、toml、directories、anyhow

社区

有问题、建议，或想一起折腾？欢迎来 雪主任的工坊 社区交流反馈。

About

Cross-platform Rust CLI for switching Claude Code JSON profiles and Codex config presets.

Topics

autoswitchclaude-codecodexlinuxmacoswindows

Resources

Readme
Activity

Stars

10 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

Packages

Contributors

Languages