ZCF v2新功能介绍

1. ZCF菜单功能

ZCF菜单功能

ZCF菜单功能

可以清晰地看到现在ZCF支持的所有功能

2. CCR快速配置菜单

CCR快速配置菜单

CCR快速配置菜单

使用方法：
如果是小白或者第一次使用Claude Code，推荐直接执行npx zcf选1，进入初始化流程，api配置的步骤里选CCR

单独的CCR菜单配置进入方法如下：

npx zcf ccr      # 打开 CCR 管理菜单
# 或
npx zcf → 选择 R

目前ZCF中的CCR配置只提供了基础的预设，以及全部配置一个模型，流程如下：

选择一个提供商预设：
  1. dashscope
  2. deepseek
  3. gemini
  4. modelscope
  5. openrouter
  6. siliconflow
  7. volcengine
  8. 跳过，在 CCR 中自行配置

选择一个提供商预设： 4. modelscope
✔ 请输入 modelscope 的 API 密钥： 123
? 选择 modelscope 的默认模型： (Use arrow keys)
❯ 1. Qwen/Qwen3-Coder-480B-A35B-Instruct
  2. Qwen/Qwen3-235B-A22B-Thinking-2507
  3. ZhipuAI/GLM-4.5

✔ CCR 配置已保存
✔ 代理设置已配置

📌 配置提示:
  • 您可以使用 ccr ui 命令进行更高级的配置
  • 手动修改配置文件后，请执行 ccr restart 使配置生效
  • 请使用 claude 命令启动 Claude Code（而非 ccr code）
  • CCR UI 登录密钥: sk-zcf-x-ccr
    使用此密钥登录 CCR UI 界面

确保流程跑通后可自行在CCR UI或直接编辑~/.claude-code-router/config.json进行更高级配置

:light_bulb:注意：zcf配置的ccr，最后使用的是claude命令来运行的，而不是ccr code（好处是claude code vscode插件等可以直接用），使用前需要使用ccr status确保启动成功

如果一定要使用ccr code 启动，去~/.claude/settings.json里删掉env里的ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL即可

qwen-cli每天提供2000次的qwen3-coder-plus
魔搭每天提供500次的qwen3-coder
加起来一共2500次
background路由到gemini-cli的grmini-flash(gemini-cli的频次限制要高于普通的api)
思考模型用魔搭的qwen3的thinking
websearch还是用gemini-flash
不管轻度中度还是重度一般情况(纯白嫖)是够用了

:collision:ccr启动不起来的可以试试：
我发现 ccr start 经常容易卡在 Loaded JSON config from xxx
可以先终止 3456 端口的服务：

# windows
# 1. 先这样获取到3456端口服务的pid
netstat -ano | findstr :3456
# 得到如下内容
# TCP    127.0.0.1:3456         0.0.0.0:0              LISTENING       1208
# TCP    127.0.0.1:59047        127.0.0.1:3456         TIME_WAIT       0
# 2. 然后终止它，1208不是固定值，取决于上个命令获取到的pid
taskkill //PID 1208 //F

#mac/linux 直接执行下面命令
lsof -t -i:3456 | xargs kill

然后用 ccr restart 命令启动，最后可以用 ccr status 查看状态，正常的话就能 claude 启动了

3. BMad工作流，附一个昨天发的使用流程

bmad 是项目级的，而且原项目一直在持续更新（听说 V5 版会改成 subagents 模式），就没有耦合进 zcf 里了，只做了个自动安装和更新 bmad 的 command
具体步骤：

 用 zcf 导入工作流 npx zcf后选2，走完流程
在项目目录终端运行 claude
5.claude code 中运行 /bmad-init
等待结束会有提示:

  1. 重启 claude: ctrl+c *2 + claude（agent 安装后得重启才能看到，claude command 好像不能自动重启自己:tieba_022: ）
  2. 输入 /o+tab+ help（等同于完整命令：/BMad:agents:bmad-orchestrator is running… help）
  3. 此时进入了 bmad 流程，可以根据指引进行其他操作：

4. 工作流可选安装，增加Git指令，增加安装后的详细提示


5. ccusage 集成，可方便查看各种使用量


使用方法：

npx zcf ccu # 快速查看每日用量，可透传ccusage参数

或

npx zcf → 选择 U # 打开 ccusage 管理菜单

6. 自动检查并更新Claude Code和CCR

npx zcf check
# 或
npx zcf → 选择 +

7. 集成了哈雷佬的 CCometixLine - 基于 Rust 的高性能 Claude Code 状态栏工具，集成 Git 信息和实时使用量跟踪

#初始化中最后一步会确认是否需要安装

#单独安装
npx zcf → 选择 L → 选择 1

效果图:

v2.9.9 版本用户重要提示 ：如果您之前使用过 ZCF v2.9.9 版本安装 CCometixLine，请重新运行一次安装流程，以确保 CCometixLine 配置被正确添加。运行 npx zcf → 选择 L → 选择 1 ，会自动添加 CCometixLine 配置。

ZCF todo list (不分先后)

  1. 优化全局记忆配置，增加低token消耗版本【2.12.0已改为output-style】
  2. 重构workflow工作流，改成subagents模式
  3. 研究并集成更多好用的command、agent以及hook
  4. 增加真·一键命令，参数里配置好api，一键即可直接配置完成，适合各大公益站和富可敌国使用【2.10.0已增加】
  5. 优化交互体验，每一步增加返回功能，优化提示信息
  6. 增加快速卸载功能，只删除工作流和全局记忆，或完全卸载cc和ccr
  7. 增加完整的用户操作指南和Q&A