真诚、友善、团结、专业，共建你我引以为荣之社区。《常见问题解答》
8月 12 日
18 / 270
8月 12 日
1 天
苗大 MiaoDa 一元复始
10 天

v1.0原贴: 【Claude code】好用的 工作流 和 MCP 一键交互式配置工具，小白也能轻松上手！

ZCF是我的第一个开源项目，目前收获了200+Star，谢谢大家的支持:tieba_095:

仓库：GitHub - UfoMiao/zcf: Zero-Config Claude-Code Flow
求求顺便点个:star:star​:star:，项目还在持续迭代更新，有想要的功能或者遇到问题都可以随时提issue:tieba_003:

最近更新了不少新功能，想单独介绍一下，另外今天是生日:tieba_044: ，开个新帖庆祝下:tada:

ZCF v2新功能介绍

1. ZCF菜单功能

image
image1536×1306 269 KB

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

2. CCR快速配置菜单

image
image1114×468 52 KB

使用方法：

如果是小白或者第一次使用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即可

ps:CCR流程里提供商预设json是从ccr 代码拿来的，@musistudio M佬别打我 :tieba_025:

附一个M佬的帖子，白嫖党必看🤣

ccr现已支持qwen-cli

:tieba_042: 使用过2.9.1的ccr流程的请注意：

:collision:ccr启动不起来的可以试试：

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

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

image
image1604×284 63 KB

image
image1408×858 152 KB

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

image
image1088×482 50.9 KB

使用方法：

npx zcf ccu     # 快速查看每日用量，可透传ccusage参数
# 或
npx zcf → 选择 U   # 打开 ccusage 管理菜单

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

image
image1028×610 52.7 KB

npx zcf check
# 或
npx zcf → 选择 +

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

image
image1522×374 49.5 KB

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

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

效果图:

image
image1048×260 20.1 KB

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

ZCF todo list (不分先后)

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

:folded_hands: 鸣谢

本项目引入的开源项目：

最后的最后，附一些Claude Code相关的极品好帖：

哈雷佬的Windows用户必看指南：《 Claude Code 终极版 FAQ 指南 》
T佬的GPT-load接入CCR教程，适合多key的佬：【T佬教程】把GPT-Load接入CCR来爽用Claude Code！！！
Claude Code使用心得与思考：好文分享：Claude Code使用心得与思考

阅读时间 18 分钟
dao wudaohk Regular
10 天

这个可以用kilocode.ai的key吗?
kilo好像打开了 :melting_face:

苗大 MiaoDa 一元复始
dao
10 天

那肯定不能直接用，可以站内搜搜kilo2api ，然后再用ccr就行了:tieba_003:

Ed Muro
10 天

所以到底怎么用？看得一脸懵

苗大 MiaoDa 一元复始
跳到帖子

第一次使用claude code嘛，直接终端运行npx zcf然后选1，跟着流程走就好啦，有不懂的再敲我:tieba_003:

苗大 MiaoDa 一元复始
Ed Muro
10 天

第一次使用claude code嘛，直接终端运行npx zcf然后选1，跟着流程走就好啦，有不懂的再敲我:tieba_003:

肉山大魔王 crolin 文化宣导员
10 天

原来已经用claude ，为什么配置会是ccr命令不存在， 能用openai 比如佬友们的公益API的站点支持不？

苗大 MiaoDa 一元复始
肉山大魔王
10 天

哪一步报的错误，ccr是需要单独安装的，如果没安装过先运行，npx zcf ccr选1
ccr里可以配置各种类型的api的，大多数公益站的都可以用

肉山大魔王 crolin 文化宣导员
苗大
10 天

安装了，ccr似乎是不是没法配置openapi 的接口的？ 也就是公益站提供的模块这些？我看都是官网的

苗大 MiaoDa 一元复始
肉山大魔王
10 天

支持的，你看到的那个是模板的供应商，可以在ccr ui里自己加其他渠道的，我试的站里的图钉公益站：

image
image1672×1720 200 KB

image
image1440×1180 70 KB

配完保存重启即可，转换器我没配，有的渠道应该要配
image
image1336×1098 116 KB

附一个配置文件~/.claude-code-router/config.json格式：

image
image1538×1488 274 KB

更推荐使用：qwen-cli 每天提供 2000 次的 qwen3-coder-plus
加上魔搭每天提供 500 次的 qwen3-coder
共2500次白嫖用起来很舒服

肉山大魔王 crolin 文化宣导员
苗大
10 天

嗯嗯，感谢，我用gemini 和公益的tb 我试下配置下，感谢，有个疑问，我看ccr 有个api key配置，我配置这个就不行，但是不配置ui 又打不开

苗大 MiaoDa 一元复始
肉山大魔王
10 天

gemini在cc里效果不太好，T佬也不推荐用，推荐在kilo或者roo里用；
如果你用claude命令，ccr里的APIKEY需要和~/.claude/settings.json里env的ANTHROPIC_API_KEY一样，ANTHROPIC_BASE_URL是http://127.0.0.1:3456
如果你用ccr code就把这两个变量删掉

marginman 文化宣导员
10 天

大佬牛逼，我昨天用了bm，在切割文档的时候失败了哈哈哈哈，没用明白，这就出了中文的了

ttpy 浴火重生
10 天

支持大佬，期待持续更新

这是 Mew 首次发帖 - 让我们欢迎他/她加入社区吧！

Mew mewmew
9 天

感谢大佬，按着你的步骤进行了配置，但是进入claude code后无法正常运行，请问能帮我看看问题出在哪里吗？

我是windows系统，按照文中所提到的哈雷大佬的文章安装了cc，然后使用了你的配置工具。现在在运行cc后会提示缺失api key，需要登陆。由于不知为何无法发布图片，报错内容如下：
Invalid API key - Please run /login

感觉两位的文章中都没有提到要登陆的事情，那么是不是理论上这个api key配置是由ccr来完成的？但我现在运行ccr start就会卡在这个状态：
127.0.0.1
Loaded JSON config from: C:\Users\Admin.claude-code-router\config.json
很久都没有其他反应，是需要继续等下去吗？还是哪里出了问题呢？烦请大佬解惑 :saluting_face:

苗大 MiaoDa 一元复始
Mew
9 天

出现登录说明配置有问题
确认下你的C:\Users\Admin\.claude\setting.json里的ANTHROPIC_BASE_URL是不是http://127.0.0.1:3456,以及ANTHROPIC_API_KEY是不是sk-zcf-x-ccr
如果两个变量都没的话，说明不是走的zcf配的ccr（或者出bug了:tieba_087: ），可以直接ccr code启动claude;
如果需要claude启动或者用的是claude code IDE插件，那就手动在env里加上刚在的变量，或者用npx zcf ccr选1再配一次ccr

然后可以贴下你的.claude-code-router\config.json,记得把渠道的key去掉再粘贴进来，我看看是不是ccr配置有问题导致的启动不了

Mew mewmew
苗大
9 天

谢谢大佬回复，我看ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY两项都是正确的。ccr code启动也是同样的问题。

config.json如下：
{
“LOG”: true,
“CLAUDE_PATH”: “”,
“HOST”: “127.0.0.1”,
“PORT”: 3456,
“APIKEY”: “sk-zcf-x-ccr”,
“API_TIMEOUT_MS”: “600000”,
“PROXY_URL”: “”,
“transformers”: ,
“Providers”: [
{
“name”: “modelscope”,
“api_base_url”: “https://”,
“api_key”: “123”,
“models”: [
“Qwen/Qwen3-Coder-480B-A35B-Instruct”,
“Qwen/Qwen3-235B-A22B-Thinking-2507”,
“ZhipuAI/GLM-4.5”
],
“transformer”: {
“use”: [
[
“maxtoken”,
{
“max_tokens”: 65536
}
]
],
“Qwen/Qwen3-Coder-480B-A35B-Instruct”: {
“use”: [
“enhancetool”
]
},
“Qwen/Qwen3-235B-A22B-Thinking-2507”: {
“use”: [
“reasoning”
]
}
}
},
{
“name”: “gemini”,
“api_base_url”: “https://—/v1”,
“api_key”: “sk-***”,
“models”: [
“gemini-2.5-flash”,
“gemini-2.5-pro”
],
“transformer”: {
“use”: [
“gemini”
]
}
}
],
“Router”: {
“default”: “gemini,gemini-2.5-pro”,
“background”: “gemini,gemini-2.5-pro”,
“think”: “gemini,gemini-2.5-pro”,
“longContext”: “gemini,gemini-2.5-pro”,
“longContextThreshold”: 60000,
“webSearch”: “gemini,gemini-2.5-pro”
}
}