# 【开源自荐】ZCF - Claude Code & Codex 一键配置工具（含CCR配置、BMad和spec工作流、CCometixLine集成）

**URL:** <https://linux.do/t/topic/860998>\
**Category:** 开发调优\
**Tags:** Claude, 人工智能, 软件开发, 原创\
**Created:** [2025 年8 月 12 日 06:48 UTC](https://linux.do/t/topic/860998 "2025-08-12T06:48:27Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

作者： ![MiaoDa](https://cdn.ldstatic.com/user_avatar/linux.do/miaoda/32/907843_2.png) [@MiaoDa](https://linux.do/u/MiaoDa)\
发布日期： [2025 年8 月 12 日 06:48 UTC](https://linux.do/t/topic/860998/1 "2025-08-12T06:48:28Z")

</div>

**觉得好用给我点个`开发调优`的`认可`呗:tieba_095:**

v1.0原贴: [【Claude code】好用的 工作流 和 MCP 一键交互式配置工具，小白也能轻松上手！](https://linux.do/t/topic/836692)  
最新更新贴：[【ZCF】【Claude Code】七夕没有人陪怎么办，来跟猫娘浮浮酱聊天写代码吧(๑•̀ㅂ•́) ✧](https://linux.do/t/topic/915828)

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

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

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

## ZCF v2新功能介绍

### 1. ZCF菜单功能

 ![image](https://cdn3.ldstatic.com/original/4X/1/e/8/1e82a8a893b0ef07d69e50e211a027e06e6f7e34.png)

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

### 2. CCR快速配置菜单

 ![image](https://cdn3.ldstatic.com/original/4X/2/3/2/23215d086c302d22f5fbd98c2037f88d4a7f2d7b.png)

#### 使用方法：

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

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

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

```

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

```auto
选择一个提供商预设：
  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`进行更高级配置

**💡注意** ：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](https://linux.do/t/topic/856654)

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

> [@MiaoDa](#):
>
> 2.9.1 里面有个 bug，安装了错误的 claude-code-router 而不是 @musistudio/claude-code-router:tieba_087:  
> 2.9.5 里已修复，并会检测错误的 claude-code-router，自动卸载重装  
> **之前跑过 ccr 流程的需要重新执行一次 `npx zcf → R → 1`**
> 
> ![image](https://cdn3.ldstatic.com/original/4X/c/3/5/c35956d20f7494558c950dacd9a75b756d2b37bd.png)

💥ccr **启动不起来的可以试试：**

> [@MiaoDa](#):
>
> 我发现 `ccr start` 经常容易卡在 `Loaded JSON config from xxx`  
> 可以先终止 3456 端口的服务：
> 
> ```auto
> # 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工作流，附一个昨天发的使用流程

> [@【Claude code】好用的 工作流 和 MCP 一键交互式配置工具，小白也能轻松上手！](https://linux.do/t/topic/836692/136):
>
> bmad 是项目级的，而且原项目一直在持续更新（听说 V5 版会改成 subagents 模式），就没有耦合进 zcf 里了，只做了个自动安装和更新 bmad 的 command  
> 具体步骤：
> 
> 1. 用 zcf 导入工作流 `npx zcf`后选2，走完流程
> 2. 在 **项目目录** 终端运行 `claude`  
> 5.`claude code` 中运行 `/bmad-init`
> 3. 等待结束会有提示:
> 
> ![image](https://cdn3.ldstatic.com/original/4X/5/6/0/560bfa836a5cbf7a040e785e1d09d028e84320ee.png)
> 
> 1. 重启 claude: `ctrl+c` \*2 + `claude`（agent 安装后得重启才能看到，claude command 好像不能自动重启自己:tieba_022: ）
> 2. 输入 `/o`+`tab`+ `*help`（等同于完整命令：`/BMad:agents:bmad-orchestrator is running… *help`）
> 3. 此时进入了 bmad 流程，可以根据指引进行其他操作：
> 
> ![image](https://cdn3.ldstatic.com/original/4X/6/b/9/6b92efa1a3ef66836eb3a416e1ea95240ec413dd.png)
> 
> 具体的流程指南可以看官方的：[BMAD-METHOD/docs/user-guide.md at main · bmad-code-org/BMAD-METHOD · GitHub](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/docs/user-guide.md)  
> 我也没用两天，还没研究透，很喜欢里面的分析师头脑风暴模式:tieba_003:

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

 ![image](https://cdn3.ldstatic.com/original/4X/c/a/1/ca17d5016ff41ab189c5768eca5acd9aeaad1369.png)  
 ![image](https://cdn3.ldstatic.com/original/4X/6/8/5/685ea404f4cdf86c6f0d39466fbfabb327f156f8.png)

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

 ![image](https://cdn3.ldstatic.com/original/4X/b/7/2/b7278fe66b0e60db222f6e269c712078d2c4327c.png)

使用方法：

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

```

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

 ![image](https://cdn3.ldstatic.com/original/4X/a/2/a/a2a1465bcb3fe5dfa5f342977e4efb849ed8bcce.png)

```auto
npx zcf check
# 或
npx zcf → 选择 +

```

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

 ![image](https://cdn3.ldstatic.com/original/4X/2/6/3/263d60a2a5eb2380bfed3343ad8a5577118b54e2.png)

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

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

```

效果图:

 ![image](https://cdn3.ldstatic.com/original/4X/9/2/0/920152537bed4c181c9c9965b27b77fe37da305b.png)

> **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

## 🙏 鸣谢

本项目引入的开源项目：

- [CCR(claude-code-router)](https://github.com/musistudio/claude-code-router)
- [ccusage](https://github.com/ryoppippi/ccusage)
- [BMad Method](https://github.com/bmad-code-org/BMAD-METHOD)
- [CCometixLine](https://github.com/Haleclipse/CCometixLine)

> [@【Claude code】好用的 工作流 和 MCP 一键交互式配置工具，小白也能轻松上手！](https://linux.do/t/topic/836692/1):
>
> 本项目参考了以下 L 友的优秀 Prompt：
> 
> - [分享一个让 AI 只生成必要的代码的通用 Prompt，欢迎一起调优～](https://linux.do/t/topic/830802)
> - [claude code 降智不怕，使用 agent 与 command 结合将任务做详细的拆分大概可以帮助到你](https://linux.do/t/topic/815230)
> - [cursor 快速开发规则](https://linux.do/t/topic/697566)

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

哈雷佬的Windows用户必看指南：[《 Claude Code 终极版 FAQ 指南 》](https://linux.do/t/topic/803265)  
T佬的GPT-load接入CCR教程，适合多key的佬：[【T佬教程】把GPT-Load接入CCR来爽用Claude Code！！！](https://linux.do/t/topic/843878)  
Claude Code使用心得与思考：[好文分享：Claude Code使用心得与思考](https://linux.do/t/topic/847657)

---

<div class="post-metadata">

作者： ![Haleclipse](https://cdn.ldstatic.com/user_avatar/linux.do/haleclipse/32/1130851_2.png) [@Haleclipse](https://linux.do/u/Haleclipse)\
发布日期： [2025 年8 月 12 日 06:49 UTC](https://linux.do/t/topic/860998/2 "2025-08-12T06:49:09Z")

</div>

生日快乐~  
整挺好！

---

<div class="post-metadata">

作者： ![MiaoDa](https://cdn.ldstatic.com/user_avatar/linux.do/miaoda/32/907843_2.png) [@MiaoDa](https://linux.do/u/MiaoDa)\
发布日期： [2025 年8 月 12 日 06:51 UTC](https://linux.do/t/topic/860998/3 "2025-08-12T06:51:10Z")

</div>

好快的回，哈雷佬贴贴:tieba_022:

---

<div class="post-metadata">

作者： ![Haleclipse](https://cdn.ldstatic.com/user_avatar/linux.do/haleclipse/32/1130851_2.png) [@Haleclipse](https://linux.do/u/Haleclipse)\
发布日期： [2025 年8 月 12 日 06:55 UTC](https://linux.do/t/topic/860998/4 "2025-08-12T06:55:38Z")

</div>

安排!

![](https://cdn3.ldstatic.com/original/4X/9/8/0/98026b9885e7aff7322fa096697dc4739e08baac.webp)

---

<div class="post-metadata">

作者： ![liaowen](https://cdn.ldstatic.com/user_avatar/linux.do/liaowen/32/2458528_2.png) [@liaowen](https://linux.do/u/liaowen)\
发布日期： [2025 年8 月 12 日 06:57 UTC](https://linux.do/t/topic/860998/5 "2025-08-12T06:57:30Z")

</div>

蛋糕旋转一小时

---

<div class="post-metadata">

作者： ![AlphaCat](https://cdn.ldstatic.com/user_avatar/linux.do/alphacat/32/547640_2.png) [@AlphaCat](https://linux.do/u/AlphaCat)\
发布日期： [2025 年8 月 12 日 06:57 UTC](https://linux.do/t/topic/860998/6 "2025-08-12T06:57:46Z")

</div>

大佬太强了！Star了

---

<div class="post-metadata">

作者： ![jwzhang](https://cdn.ldstatic.com/letter_avatar/jwzhang/32/6_22734026db12803ebb3e059622ac3534.png) [@jwzhang](https://linux.do/u/jwzhang)\
发布日期： [2025 年8 月 12 日 06:58 UTC](https://linux.do/t/topic/860998/7 "2025-08-12T06:58:29Z")

</div>

支持一下大佬！ 😀

---

<div class="post-metadata">

作者： ![1670274679](https://cdn.ldstatic.com/user_avatar/linux.do/1670274679/32/55391_2.png) [@1670274679](https://linux.do/u/1670274679)\
发布日期： [2025 年8 月 12 日 06:59 UTC](https://linux.do/t/topic/860998/8 "2025-08-12T06:59:00Z")

</div>

生日快乐佬！

---

<div class="post-metadata">

作者： ![9527](https://cdn.ldstatic.com/user_avatar/linux.do/9527/32/484369_2.png) [@9527](https://linux.do/u/9527)\
发布日期： [2025 年8 月 12 日 06:59 UTC](https://linux.do/t/topic/860998/9 "2025-08-12T06:59:17Z")

</div>

生日快乐大佬，感谢分享

---

<div class="post-metadata">

作者： ![liuxixigua](https://cdn.ldstatic.com/user_avatar/linux.do/liuxixigua/32/73246_2.png) [@liuxixigua](https://linux.do/u/liuxixigua)\
发布日期： [2025 年8 月 12 日 07:02 UTC](https://linux.do/t/topic/860998/10 "2025-08-12T07:02:38Z")

</div>

大佬厉害

---

<div class="post-metadata">

作者： ![lytNotRobot](https://cdn.ldstatic.com/user_avatar/linux.do/lytnotrobot/32/711556_2.png) [@lytNotRobot](https://linux.do/u/lytNotRobot)\
发布日期： [2025 年8 月 12 日 07:03 UTC](https://linux.do/t/topic/860998/11 "2025-08-12T07:03:03Z")

</div>

佬太强了！！

---

<div class="post-metadata">

作者： ![handsome](https://cdn.ldstatic.com/user_avatar/linux.do/handsome/32/2484898_2.png) [@handsome](https://linux.do/u/handsome)\
发布日期： [2025 年8 月 12 日 07:12 UTC](https://linux.do/t/topic/860998/12 "2025-08-12T07:12:09Z")

</div>

感谢大佬 ！

---

<div class="post-metadata">

作者： ![lichong7200](https://cdn.ldstatic.com/letter_avatar/lichong7200/32/6_22734026db12803ebb3e059622ac3534.png) [@lichong7200](https://linux.do/u/lichong7200)\
发布日期： [2025 年8 月 12 日 07:12 UTC](https://linux.do/t/topic/860998/13 "2025-08-12T07:12:21Z")

</div>

收藏了，感谢佬

---

<div class="post-metadata">

作者： ![wudaohk](https://cdn.ldstatic.com/user_avatar/linux.do/wudaohk/32/1080213_2.png) [@wudaohk](https://linux.do/u/wudaohk)\
发布日期： [2025 年8 月 12 日 07:13 UTC](https://linux.do/t/topic/860998/14 "2025-08-12T07:13:17Z")

</div>

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

---

<div class="post-metadata">

作者： ![New-13](https://cdn.ldstatic.com/user_avatar/linux.do/new-13/32/681877_2.png) [@New-13](https://linux.do/u/New-13)\
发布日期： [2025 年8 月 12 日 07:15 UTC](https://linux.do/t/topic/860998/15 "2025-08-12T07:15:45Z")

</div>

佬，生日快乐！

---

<div class="post-metadata">

作者： ![MiaoDa](https://cdn.ldstatic.com/user_avatar/linux.do/miaoda/32/907843_2.png) [@MiaoDa](https://linux.do/u/MiaoDa)\
发布日期： [2025 年8 月 12 日 07:16 UTC](https://linux.do/t/topic/860998/16 "2025-08-12T07:16:06Z")

</div>

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

---

<div class="post-metadata">

作者： ![wudaohk](https://cdn.ldstatic.com/user_avatar/linux.do/wudaohk/32/1080213_2.png) [@wudaohk](https://linux.do/u/wudaohk)\
发布日期： [2025 年8 月 12 日 07:17 UTC](https://linux.do/t/topic/860998/17 "2025-08-12T07:17:54Z")

</div>

> [@MiaoDa](#):
>
> kilo2api

谢谢佬友

---

<div class="post-metadata">

作者： ![Ed\_Muro](https://cdn.ldstatic.com/user_avatar/linux.do/ed_muro/32/822505_2.png) [@Ed\_Muro](https://linux.do/u/Ed_Muro)\
发布日期： [2025 年8 月 12 日 07:21 UTC](https://linux.do/t/topic/860998/18 "2025-08-12T07:21:46Z")

</div>

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

---

<div class="post-metadata">

作者： ![fengfujie](https://cdn.ldstatic.com/user_avatar/linux.do/fengfujie/32/399783_2.png) [@fengfujie](https://linux.do/u/fengfujie)\
发布日期： [2025 年8 月 12 日 07:22 UTC](https://linux.do/t/topic/860998/19 "2025-08-12T07:22:13Z")

</div>

佬速度真快，这么快就整合了

---

<div class="post-metadata">

作者： ![scxs](https://cdn.ldstatic.com/user_avatar/linux.do/scxs/32/875898_2.png) [@scxs](https://linux.do/u/scxs)\
发布日期： [2025 年8 月 12 日 07:27 UTC](https://linux.do/t/topic/860998/20 "2025-08-12T07:27:13Z")

</div>

好贴好贴，正在研究claude code 和router.

[下一页](https://linux.do/t/topic/860998.md?page=2)