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

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

项目简介

ZCF（Zero-Config Code Flow）是一个开源的 CLI 工具，由 UfoMiao 开发维护。它旨在简化 Claude Code 和 Codex 的配置流程，让开发者能够一键完成环境搭建，无需繁琐的手动配置。

该项目核心理念是"零配置"，通过智能化的配置管理系统，自动处理 API 设置、工作流配置、MCP 集成等复杂任务，让开发者可以专注于代码本身。

核心特性

• 零配置部署：一键完成 Claude Code / Codex 的完整环境配置
• 双语支持：支持中文和英文界面，满足不同用户需求
• 智能代理系统：内置智能代理管理，优化 AI 交互体验
• API 提供商预设：支持 302.AI、PackyCode、AICodeMirror 等多家 API 服务商
• 自动更新机制：内置工作流自动更新功能，保持配置始终最新
• MCP 集成：支持 Model Context Protocol (MCP) 服务端配置
• 个性化输出风格：提供多种输出风格模板，适配不同使用场景

技术栈

• TypeScript - 主要开发语言，提供类型安全
• Node.js - 运行时环境，支持 18+ 版本
• Vitest - 单元测试框架
• ESLint - 代码质量检查
• pnpm - 包管理工具（推荐）

安装指南

前置要求

• Node.js >= 18
• pnpm >= 8（推荐）或 npm / yarn

快速安装

ZCF 无需全局安装，直接使用 npx 运行即可：

# 交互式安装（推荐）
npx zcf

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

# 仅更新工作流
npx zcf u

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

非交互式安装（使用提供商预设）

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

参数说明：

• -s：跳过交互式提示
• -p：指定 API 提供商预设
• -k：设置 API 密钥

使用示例

场景 1：首次初始化

# 运行交互式安装向导
npx zcf

# 根据提示选择：
# 1. 选择语言（中文/英文）
# 2. 选择 API 提供商
# 3. 输入 API 密钥
# 4. 配置 Claude Code 或 Codex
# 5. 设置 MCP 服务（可选）

场景 2：更新现有配置

# 仅更新工作流到最新版本
npx zcf u

# 更新并保留自定义配置
npx zcf u --preserve-config

场景 3：切换 API 提供商

# 重新配置 API 设置
npx zcf i

# 选择新的提供商并输入密钥

支持的 API 提供商

ZCF 内置多家 API 服务商的预设配置：

项目结构

zcf/
├── src/              # 源代码目录
├── templates/        # 输出风格模板
├── docs/             # 文档
├── tests/            # 测试文件
├── bin/              # CLI 入口
├── .zcf/             # ZCF 配置目录
└── .claude/          # Claude Code 配置

社区与支持

• Telegram 群组: https://t.me/ufomiao_zcf
• 完整文档: https://zcf.ufomiao.com/
• GitHub Issues: 问题反馈和功能建议

致谢与赞助

ZCF 项目感谢以下赞助商的支持：

企业赞助商：

• 302.AI - 首个企业赞助商
• GLM - 首个 AI 模型赞助商
• PackyCode - API 中继服务赞助商
• AICodeMirror - 官方高稳定性中继服务

技术 inspiration：

• LINUX DO 社区
• CCR (Claude Code Router)
• CCometixLine
• ccusage
• BMad Method

开源协议

本项目基于 MIT License 开源。

项目链接

• GitHub 仓库：https://github.com/UfoMiao/zcf
• 官方文档：https://zcf.ufomiao.com/
• npm 包：https://npmjs.com/package/zcf
• JSDocs：https://www.jsdocs.io/package/zcf