ByteNoteByteNote
字

字节笔记本

2026年2月22日

ZCF：Claude Code 零配置一键设置工具

#Claude Code
API中转
¥120

本文介绍 ZCF（Zero-Config Code Flow），一个专为 Claude Code 和 Codex 设计的零配置一键设置工具。ZCF 提供双语支持、智能代理系统和个性化 AI 助手功能，帮助开发者快速搭建 AI 编程环境，目前在 GitHub 上已获得近 6000 stars。

项目简介

ZCF 是由 Miao Da（WitMiao）开发维护的开源项目，使用 TypeScript 编写，采用 MIT 许可证。该项目的核心价值在于将 Claude Code 和 Codex 的复杂配置流程简化为一键操作，让开发者无需手动编辑配置文件即可完成环境搭建。

ZCF 的 GitHub 仓库地址为 https://github.com/UfoMiao/zcf ，截至目前已获得 5998 stars 和 419 forks，社区活跃度较高。项目自 2025 年 7 月创建以来，持续更新迭代，当前 npm 最新版本为 3.6.5。

核心特性

Claude Code 配置能力

ZCF 为 Claude Code 提供全面的配置管理，包括：

  • 一键初始化 Claude Code 环境
  • 智能代理系统（CCR）配置
  • API 密钥和提供商预设管理
  • 个性化 AI 助手设置
  • 输出风格和模板定制

Codex 支持

ZCF 不仅支持 Claude Code，还提供对 Codex 的完整配置支持，覆盖：

  • Codex 环境初始化
  • 模型选择和 API 配置
  • 代理路由设置

工作流系统

ZCF 内置多种开发工作流模板，支持：

  • ZCF 六阶段工作流：从需求分析到代码交付的完整流程
  • 功能开发工作流：面向功能迭代的标准流程
  • BMad 敏捷流程：基于 BMad Method 的敏捷开发流程
  • Spec 工作流集成：规格驱动开发流程
  • Git 智能命令：增强版 Git 操作命令

MCP 服务集成

ZCF 支持一键安装和配置 MCP（Model Context Protocol）服务，简化 AI 模型与外部工具的交互配置。

Claude Code Router（CCR）

CCR 是 ZCF 的核心组件之一，提供智能代理路由功能，支持多个 AI API 提供商之间的负载均衡和故障转移。

ccusage 使用分析

集成 ccusage 工具，实时监控 Claude Code 的使用量和消耗情况，帮助开发者合理规划 API 调用。

CCometixLine 状态栏

提供终端状态栏显示，实时展示当前会话的模型、用量等关键信息。

多配置与备份

支持多套配置文件的管理和切换，方便在不同项目和环境之间快速切换，同时提供配置备份和恢复功能。

安装与快速开始

前置要求

  • Node.js >= 18
  • npm 或 pnpm

安装与初始化

ZCF 无需全局安装，直接通过 npx 运行：

bash
# 打开交互式菜单，选择所需功能
npx zcf

# 完整初始化：安装 + 工作流 + API/CCR + MCP
npx zcf i

# 仅更新工作流
npx zcf u

# 切换界面语言
npx zcf --lang zh-CN

非交互式使用

ZCF 支持非交互式命令，适合自动化脚本和 CI/CD 场景：

bash
# 使用提供商预设进行非交互式初始化
npx zcf i -s -p 302ai -k "sk-xxx"

CLI 命令一览

命令说明
npx zcf打开交互式主菜单
npx zcf i / npx zcf init完整初始化
npx zcf u / npx zcf update更新工作流和模板
CCR 代理管理配置和管理 AI 代理路由
使用分析 ccu查看用量和消耗统计
卸载与清理移除 ZCF 配置和文件
配置切换在多套配置间切换
版本检查检查和更新 ZCF 版本

工作流详解

ZCF 六阶段工作流

ZCF 的核心工作流将开发过程分为六个阶段，从需求理解到最终交付，每个阶段都有明确的输入、输出和验证标准。这种结构化的方法确保了代码质量和开发效率。

BMad 敏捷流程

基于 BMad Method 的敏捷开发流程，强调商业分析驱动的开发方式。ZCF 提供了 BMad Analyst Agent 等智能代理，辅助需求分析和项目规划。

Spec 工作流

规格驱动开发流程，先定义清晰的规格说明，再进行实现。这种方式减少了返工和沟通成本。

Git 智能命令

增强版 Git 操作，提供更直观的分支管理、提交规范和合并策略。

进阶配置

API 提供商预设

ZCF 支持多个 API 提供商的预设配置，包括 302.AI、PackyCode、AICodeMirror、Crazyrouter 等，开发者只需选择提供商并输入 API 密钥即可完成配置。

模板与输出风格

支持自定义 AI 输出风格和模板，让 Claude Code 的回复更符合个人偏好和项目规范。

国际化与语言

ZCF 支持中文、英文、日文三种界面语言，方便不同地区的开发者使用。

配置管理

提供配置文件的导入、导出、备份和恢复功能，支持在多台设备间同步配置。

最佳实践

Worktree 并行开发

利用 Git Worktree 实现多任务并行开发，每个 worktree 使用独立的 ZCF 配置，避免任务间相互干扰。

输出风格策略

根据项目类型选择合适的输出风格，例如技术文档项目偏好详细解释，而快速迭代项目偏好简洁输出。

致谢

ZCF 的开发受到以下项目和社区的启发和支持：

项目链接

Claude Code
上一篇

Gemini Next Chat - 开源 Gemini AI 聊天应用框架

下一篇

ZCF：Claude Code 零配置一键设置工具

分享: