快速启动不同配置的 Claude Code 命令行工具。
npm i -g @zphhpzzph/cc-cli@latest项目地址： https://github.com/zphhpzzph/cc-cli — 可下载源码查看或参与贡献
zcc add glm51 # 默认保存到当前项目 ./claude/models.yaml
zcc add glm51 -g # 推荐保存到全局 ~/.claude/models.yaml注意：
zcc add默认作用域为当前项目目录。推荐使用-g参数将配置添加到全局，这样在任意目录下都可以使用该配置。
按提示输入：
ANTHROPIC_BASE_URL: API 地址ANTHROPIC_AUTH_TOKEN: API 密钥ANTHROPIC_MODEL: 模型名称（可留空）- 权限配置（可留空）
- 其他环境变量（支持 autocomplete 搜索，覆盖 ~200 个 Claude Code 内置变量）
zcc glm51 # 生成 settings.glm51.json，以 --settings 方式启动zcc use strict # 写入 .claude/settings.local.json
zcc use strict -g # 写入 ~/.claude/settings.json（全局）| 命令 | 说明 |
|---|---|
zcc <id> |
启动 Claude Code，自动生成 settings 文件并通过 --settings 传入 |
zcc add <id> |
添加配置方案（-b 编辑 base） |
zcc edit <id> |
编辑配置方案（-b 编辑 base） |
zcc remove <id> |
删除配置方案 |
zcc parse <settings-path> [profile-id] |
从 settings JSON 文件导入为 profile（-b 写入 base，-c 仅复制到剪贴板） |
zcc list |
列出所有配置方案 |
zcc use [profile-id] |
将配置写入 settings 文件（不启动，-b 应用 base） |
zcc restore |
恢复 settings 备份 |
zcc alias [name] |
修改 CLI 命令别名 |
zcc serve [profile-id] |
启动本地模型代理服务（-b 基于 base 启动，--run 启动代理后启动 Claude Code） |
zcc serve list |
列出运行中的代理 |
zcc serve stop [profile-id] |
停止指定代理（--all 停止所有） |
zcc serve log <profile-id> |
查看代理请求日志（-n 指定行数，默认 20） |
所有命令支持 -g（全局）和 -t <file>（自定义配置文件）选项。
配置文件位置：~/.claude/models.yaml（全局）或 ./.claude/models.yaml（项目级）
settings:
alias: zcc # CLI 命令别名
base: # 所有 profiles 共享的默认配置（可选）
env: # profile 中同名字段会覆盖 base
ANTHROPIC_AUTH_TOKEN: <shared-key>
permissions:
deny:
- "Bash(rm -rf *)"
profiles: # 统一的配置方案
<id>:
env: # 环境变量（可选）
ANTHROPIC_BASE_URL: <url>
ANTHROPIC_MODEL: <model-name>
permissions: # Claude Code 设置（可选）
allow: [...]
deny: [...]
hooks: {...} # 其他 Claude Code settings 字段
# 以下字段由 zcc serve 自动管理，无需手动编辑
proxy: # 代理服务信息（自动生成）
url: http://localhost:34567
pid: 12345
port: 34567
token: a1b2c3d4
modelOverride: # 可选：模型名称映射表
claude-sonnet-4-20250514: claude-opus-4-20250514base 配置具有跨文件传导能力，合并顺序为 全局 base → 本地 base → profile：
- 当 profile 在本地
./.claude/models.yaml中找到时，全局~/.claude/models.yaml的base也会被加载 - 同名字段的优先级：profile > 本地 base > 全局 base
- 当 profile 仅在全局配置中时，只应用全局 base
示例：全局 base 定义共享 token，本地 base 覆盖 URL，profile 指定模型——三层配置自动合并。
zcc <id> 的工作方式：
- 加载全局 base + 本地 base（传导链）
- 从
profiles[id]读取配置，仅使用 profile 自身内容生成 settings 文件（不合并 base，避免覆盖全局用户设置） - 生成
settings.<id>.json到 models.yaml 所在的.claude/目录下 - 使用
claude --settings settings.<id>.json启动
为什么 launch 不合并 base？ Claude Code 本身会自动加载
~/.claude/settings.json。如果--settings传入的文件中已包含 base 内容，base 配置项会以最高优先级覆盖用户的全局 settings，导致全局配置失效。因此zcc <id>只传入 profile 自身配置，让 base 通过 Claude Code 自然加载的全局 settings 文件生效。
zcc <id> 通过 --settings 传入 profile 配置，但 Claude Code 仍会自动加载以下三个内置层级：
| 层级 | 文件路径 | 说明 |
|---|---|---|
| 1（最高） | --settings 传入的文件 |
zcc <id> 生成的 settings.<id>.json（仅 profile 内容） |
| 2 | .claude/settings.local.json |
项目本地设置（不提交到 git） |
| 3 | .claude/settings.json |
项目共享设置（提交到 git） |
| 4（最低） | ~/.claude/settings.json |
全局用户设置 |
合并规则：
- 标量值（如
model、theme）：高优先级覆盖低优先级，--settings传入的 profile 会覆盖项目级和全局设置 - 数组值（如
permissions.allow、permissions.deny）：所有层级合并拼接并去重，不会互相覆盖。例如全局允许Bash(npm run *)，profile 允许Bash(git:*)，两者同时生效 - 对象值：深度合并，同路径的键高优先级覆盖
注意：
permissions.deny的规则在运行时优先于allow。即使 profile 的allow允许了某操作，如果其他层级的deny包含该操作，仍会被拒绝。
| models.yaml 来源 | settings 文件路径 |
|---|---|
本地 ./.claude/models.yaml |
./.claude/settings.<id>.json |
全局 ~/.claude/models.yaml |
~/.claude/settings.<id>.json |
自定义 -t path/models.yaml |
path/settings.<id>.json |
通过 --base（-b）参数可以直接编辑 base 节点，无需手动修改 YAML。
# 添加/更新 base 配置（本地）
zcc add base -b
# 添加/更新 base 配置（全局）
zcc add base -b -g
# 编辑 base 配置（交互式引导，预填现有值）
zcc edit base -b
# 将 base 配置应用到 settings 文件
zcc use -b
zcc use -b -g
# 从 JSON 文件导入到 base
zcc parse ./settings.json -bzcc serve 为 profile 启动一个本地 HTTP 反向代理，用于模型路由和名称映射。
- 将请求路由到第三方 API（如智谱、OpenAI、Ollama）
- 按需重映射模型名称（
claude-sonnet→claude-opus） - 无模型映射时，强制所有请求走指定模型
# 启动代理（profile 需配置 env.ANTHROPIC_BASE_URL）
zcc serve my-profile
# 启动代理并直接启动 Claude Code
zcc serve my-profile --run
# 基于 base 配置启动代理
zcc serve --base
# 查看运行中的代理
zcc serve list
# 停止代理
zcc serve stop my-profile
zcc serve stop --all
# 查看代理请求日志
zcc serve log my-profile # 最近 20 条
zcc serve log my-profile -n 50 # 最近 50 条按以下优先级决定如何处理请求中的 model 字段：
- profile 有
modelOverride映射表 → 按映射替换（如claude-sonnet-4-20250514→claude-opus-4-20250514） - 无
modelOverride，但 profile 有env.ANTHROPIC_MODEL→ 强制所有请求使用该模型 - 两者都没有 → 透传原始 model
profiles:
my-proxy:
modelOverride:
claude-sonnet-4-20250514: claude-opus-4-20250514
env:
ANTHROPIC_BASE_URL: https://api.anthropic.com
ANTHROPIC_AUTH_TOKEN: sk-xxx
ANTHROPIC_MODEL: claude-sonnet-4-20250514注意： 代理启动后会在 profile 中自动写入
proxy字段（url/pid/port/token），无需手动编辑。zcc <id>检测到proxy字段且进程存活时，会自动通过代理地址启动。
配置不存在。先使用 zcc add xxx 创建配置，或用 zcc list 查看可用配置。
zcc <id>：生成临时 settings 文件并启动 Claude Code（不合并 base）zcc use <id>：将配置合并写入.claude/settings.local.json（不启动，合并 base）
zcc restore # 恢复 .claude/settings.local.json
zcc restore -g # 恢复 ~/.claude/settings.jsonzcc parse /path/to/settings.json myprofile # 导入到 profile
zcc parse /path/to/settings.json myprofile -g # 导入到全局 profile
zcc parse /path/to/settings.json -b # 导入到 base
zcc parse /path/to/settings.json myprofile -c # 复制 YAML 到剪贴板，不写入配置文件修改别名：
zcc alias ccl # 改用 ccl 命令代理启动后会自动写入 proxy 字段。直接 zcc <id> 即可，launch 命令会检测到代理并通过代理地址启动。代理停止后会自动降级为直连。
npm uninstall -g @zphhpzzph/cc-cli
# 删除配置文件（可选）
rm ~/.claude/models.yaml