zcf

零配置让 Claude 和 Codex 干活更靠谱，开箱即用

zcf（Zero-Config Code Flow）是一个面向 Claude Code 和 Codex 的零配置智能体工作流增强工具。它解决的是 AI 编程助手在复杂项目中缺乏结构化流程、提示词管理混乱和上下文效率低下的问题。核心能力包括：提供即插即用的零配置接入，无需复杂设置即可增强 AI 编码代理；内置基于 BMAD 方法和 CCR 的提示词模板与流程编排，引导 AI 更高效地理解代码库、规划任务和执行修改；支持多模型（Claude 4、GPT-5 等）和 CLI 环境，通过 Node.js 实现轻量级集成。它让开发者无需手动编写大量提示词，即可获得更稳定、更专业的 AI 辅助编码体验，尤其适合希望提升 AI 编码一致性和产出质量的个人开发者及小团队。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 6080

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队UfoMiao

所属国家

官网地址http://zcf.ufomiao.com

GitHubhttps://github.com/UfoMiao/zcf

定价模式free

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agent,ai,ai-agent,bmad-method,ccr,claude,claude-4,claude-ai,claude-code,cli,gpt,gpt-5,llm,llm-code,nodejs,openai,prompt,typescript,workflow,zcf

GitHub 星标★ 6080

30天Star增速

HF 下载量

上线时间2025-07-30 00:00:00

最近更新2026-09-22 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

已安装 Node.js，终端中可使用 npx 命令
可访问网络的终端环境（npx 需联网拉取包）
一个可用的模型服务 API Key（非交互式初始化时使用，如 302ai 的 sk-xxx）
建议使用支持交互式输入的终端（交互菜单需要按键选择）

安装与启动步骤

1确认 npx 可用

打开终端，确认本机已安装 Node.js 且 npx 命令可以正常执行；README 未指定版本，按要求安装 Node.js 即可。
2打开交互菜单

运行后进入 zcf 的交互式菜单，按提示选择需要的功能，这是官方推荐的使用方式。
```
npx zcf
```
3执行全量初始化

一条命令完成安装、工作流、API/CCR 与 MCP 的初始化配置，适合首次使用。
```
npx zcf i
```
4仅更新工作流

当已有配置、只想刷新提示词与工作流模板时使用该命令。
```
npx zcf u
```
5切换界面语言

通过 --lang 参数切换界面语言，例如切换为简体中文 zh-CN。
```
npx zcf --lang zh-CN
```
6非交互式初始化

适合脚本或无人值守场景，用 -s 跳过交互并指定服务商预设与 API Key。
```
npx zcf i -s -p 302ai -k "sk-xxx"
```

关键配置

配置项	必填	说明	示例
`-s`	否	非交互模式，跳过菜单直接按参数执行	`npx zcf i -s`
`-p`	是	指定服务商预设（非交互初始化时使用）	`302ai`
`-k`	是	指定模型服务的 API Key	`sk-xxx`
`--lang`	否	切换界面语言，如 zh-CN	`zh-CN`

如何确认成功

运行 npx zcf 后能正常出现交互式菜单，且 npx zcf i 初始化流程无报错完成，即表示可用。

常见问题

Q：zcf 需要先全局安装吗？

A：不需要。README 中的用法都是 npx zcf，由 npx 直接拉取并运行，无需手动全局安装。

Q：不想一步步选择菜单怎么办？

A：使用非交互模式，例如 npx zcf i -s -p 302ai -k "sk-xxx"，用参数一次性指定服务商和密钥。

Q：只想更新提示词和工作流怎么做？

A：执行 npx zcf u，该命令只更新工作流，不会重做全部初始化。

Q：界面语言怎么改成中文？

A：在命令后追加 --lang zh-CN，例如 npx zcf --lang zh-CN。

Q：初始化都包含哪些内容？

A：npx zcf i 为全量初始化，包含安装、工作流、API/CCR 以及 MCP 的配置。

注意事项

README 只提供了 npx 方式的使用说明，更多选项和工作流请查阅官方文档 https://zcf.ufomiao.com/
示例中的 sk-xxx 为占位值，请替换为你自己的真实 API Key，不要提交到代码仓库
非交互式初始化需由 -p 指定的服务商预设与 -k 的密钥配套使用
初始化会修改 Claude Code / Codex 相关配置，建议操作前先做好配置备份

核心亮点

真正零配置，安装后直接增强现有 AI 编码流程，学习成本极低
内置 BMAD 方法和 CCR 流程，显著提升 AI 对复杂任务的理解与执行连贯性
同时支持 Claude Code 和 Codex，覆盖主流 AI 编码工具，适配灵活

不足之处

文档/社区待观察
依赖特定 AI 工具版本，未来兼容性需持续跟进

适用场景

日常开发中希望减少重复提示词编写，快速获得结构化 AI 辅助
团队统一 AI 编码流程，提升代码修改质量和一致性
在大型代码库中，需要 AI 更精准地定位和修改代码的场景

替代项目

Claude Code、Codex CLI、Aider

项目介绍

zcf 是智能体领域的开源项目，由 UfoMiao 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（6,080）位列前 8%，在智能体分类的 2,517 个项目里位列前 8%。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-22。MIT许可证，完全免费，无付费版本。从国内网络环境看，可直接访问。

它主要面向的使用场景是：日常开发中希望减少重复提示词编写，快速获得结构化AI辅助。同类可对比的替代方案包括 Claude Code、Codex CLI、Aider。

上一篇：mini-swe-agent

下一篇：LobsterAI

zcf