zcf

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

开源 🏷️完全免费 ✅ 目前可打开 智能体 🍴 复刻 420 🐛 待处理 38 👀 关注 27
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 6071
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,无付费版本。

项目预览

zcf 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类智能体
开发团队UfoMiao
定价模式🏷️完全免费
价格说明开源项目,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 星标★ 6071
上线时间2025-07-30 00:00:00
代码更新2026-10-29
仓库体积26.9 MB
本站数据更新2026-11-09
维护状态较活跃
收录时间2026-08-09
浏览次数6

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 6071

使用教程

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

环境要求

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

安装与启动步骤

  1. 1确认 npx 可用

    打开终端,确认本机已安装 Node.js 且 npx 命令可以正常执行;README 未指定版本,按要求安装 Node.js 即可。

  2. 2打开交互菜单

    运行后进入 zcf 的交互式菜单,按提示选择需要的功能,这是官方推荐的使用方式。

    npx zcf
  3. 3执行全量初始化

    一条命令完成安装、工作流、API/CCR 与 MCP 的初始化配置,适合首次使用。

    npx zcf i
  4. 4仅更新工作流

    当已有配置、只想刷新提示词与工作流模板时使用该命令。

    npx zcf u
  5. 5切换界面语言

    通过 --lang 参数切换界面语言,例如切换为简体中文 zh-CN。

    npx zcf --lang zh-CN
  6. 6非交互式初始化

    适合脚本或无人值守场景,用 -s 跳过交互并指定服务商预设与 API Key。

    npx zcf i -s -p 302ai -k "sk-xxx"

关键配置

配置项必填说明示例
-s否非交互模式,跳过菜单直接按参数执行npx zcf i -s
-p是指定服务商预设(非交互初始化时使用)302ai
-k是指定模型服务的 API Keysk-xxx
--lang否切换界面语言,如 zh-CNzh-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

上一篇:mini-swe-agent

下一篇:LobsterAI

同类项目推荐

b2b-sdr-agent-template 开源

一键部署AI外贸销售员,自动跑完10阶段销售流程

Open-source AI SDR template for B2B export. 10-stage sales pipeline, 10 cron jobs, 4···

★ 191 2026-08-09
feynman 开源

一句话提问,自动查 arXiv 并写出文献综述

The open source AI research agent.

★ 10097 2026-10-11
OpenSwarm 开源

在 Discord 里指挥 AI 团队自动接 Linear 工单写代码

OpenSwarm — Autonomous AI dev team orchestrator powered by Claude Code CLI. Discord···

★ 872 2026-09-16
sage 开源

多模型AI评审团,实时把关编码代理每一步操作。

An LLM council that reviews your coding agent's every move

★ 106 2026-08-09
houtini-lm 开源

把杂活交给便宜模型,省下 Claude 的 token 钱

MCP server that saves Claude Code tokens by delegating bounded tasks to local or clo···

★ 122 2026-08-09
LightAgent 开源

轻量框架,快速构建带工具和记忆的 OpenAI 兼容智能体

LightAgent: Lightweight Python framework for OpenAI-compatible agents with tools, me···

★ 1244 2026-08-09
growth-engineer 开源

把增长工作流写成 Markdown,智能体直接照着干

Open-source catalog of go-to-market tools and workflows, written as markdown files a···

★ 217 2026-11-05
loushang 开源

统一调度多模型,让 AI 编码流程可控可追踪

AI-native agent harness for coding workflows by python: multi-model LLM orchestratio···

★ 2018 2026-08-09
Open-Interface 开源

让大模型直接操控你的电脑,一句话完成复杂操作。

Control Any Computer Using LLMs.

★ 2734 2026-08-09