CC Run

Appearance

配置文件与路径 ​

CC Run 的配置、元数据、运行时产物分布在以下路径。

配置与数据文件 ​

路径作用谁写
~/.ccr/profiles/*.json自定义 profile（每个文件一个配置，文件名即配置名）用户（ccr edit）
~/.ccr/overlay.json别名映射 + 默认配置ccr alias / ccr default
~/.ccr/state.json上次使用的配置（供 ccr - 重跑）自动
~/.ccr/config.json路径覆盖（db 位置、profiles 目录）用户手动
~/.cc-switch/*.dbcc-switch 管理的 provider 数据库cc-switch（只读）
~/.cc-switch/cc-switch.db默认 cc-switch 数据库路径cc-switch（只读）
.ccr-chain/verdict审查段判定，单独一行 pass 或 needs-work审查段（review: true）
.ccr-chain/findings.md审查段写出的问题清单审查段（review: true）

环境变量覆盖 ​

路径的优先级：环境变量 > ~/.ccr/config.json > 默认值。

环境变量用途默认值
CCR_DB覆盖 cc-switch 数据库路径~/.cc-switch/cc-switch.db
CCR_PROFILES_DIR覆盖自定义 profiles 目录~/.ccr/profiles/
EDITORccr edit 使用的编辑器vi（Unix）/ notepad（Windows）

config.json ​

路径覆盖也可以写到文件——适合想固定路径但不想每次设环境变量的场景：

json
{
  "db": "/custom/path/cc-switch.db",
  "profilesDir": "/my-profiles"
}

两个键都可选，只写需要覆盖的即可。

Profile JSON 格式 ​

~/.ccr/profiles/ 下的每个 .json 文件就是一个 profile。格式：

json
{
  "model": "sonnet",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.example.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-FAKE-example-token"
  }
}
字段必填说明
model否模型名，如 sonnet、opus、haiku
env是键值对，注入为环境变量。至少需要 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN

用 ccr edit <名字> 新建时会自动带入模板，填好键值保存即可。

overlay.json ​

别名和默认配置的存储格式：

json
{
  "default": "deepseek",
  "aliases": {
    "prod": "deepseek",
    "g": "glm"
  }
}

state.json ​

上次使用的记录，格式简洁：

json
{
  "last": "cc-switch:deepseek"
}

限定名（来源:名字）确保 ccr - 重放时精确命中。

chain 产物 ​

.ccr-chain/ 目录由 ccr chain 在工作目录里创建，存放审查段的判定（verdict）和问题清单（findings.md）。注意 PreToolUse 守卫的 --settings 不在这里——它写在工作目录之外的临时目录，agent 够不着，改不了自己头上的红线钩子。隔离与成果交回机制见 chain 隔离与成果交回。

更多信息 ​