“零配置、一键启动”的本地工作流管理工具包

UfoMiao/zcf 是一个零配置的 Claude 代码流程工具,支持多语言操作,提供了一个交互式菜单来简化安装和配置流程,包括安装 Claude Code、导入工作流程、配置 API 或 CCR 代理、设置 MCP 服务、选择默认模型、配置 AI 记忆以及安装其他辅助工具等功能。

概要(一句话)

zcf(Zero-Config Code Flow)是一个为 Anthropic 的 Claude Code / Codex 提供“零配置、一键启动”的本地/命令行式工作流管理工具包,包含智能 agent、工作流导入、模型和代理(CCR、MCP)配置等一整套开发者工具。

主要用途与定位

  • 面向需要快速搭建基于 Claude(和 Codex)代码生成 / 执行流程的开发者,提供交互式菜单和命令行快速初始化、更新、配置能力。
  • 通过“工作流 + 代理 + 记忆/个性化配置”把 AI 助手、自动化脚本、代码生成流程等连成一个可复用的系统。

核心功能(摘要)

  • 交互式菜单 / 零配置初始化npx zcf 会打开交互菜单,支持一键完整初始化(zcf i)、只更新工作流(zcf u)等。
  • 模型与记忆配置:可设置默认 Claude 模型(例如 Opus、Sonnet 1M 或自定义模型)和 AI 输出语言/风格(记忆/个性化配置)。
  • CCR / CCometixLine / MCP 支持:内建对 Claude Code Router(CCR)、高性能状态行工具 CCometixLine、以及 MCP(Model Context Protocol)相关的配置与管理。
  • 多语言界面:支持中/英/日等界面语言,并能根据参数自动切换。

典型安装与快速上手

示例命令(README 推荐):

npx zcf          # 打开交互式菜单
npx zcf i        # 完整初始化(安装 Claude Code、导入工作流、配置 API、设置 MCP)
npx zcf u        # 只更新/导入工作流

菜单内还能直接配置 API、MCP、默认模型、AI 记忆、环境权限等。

代码与文档(仓库里你会看到的)

  • README(多语言)、CLAUDE.md、AGENTS.md、CHANGELOG、tests、src 等源码与说明文档;有大量脚本/模板和配置文件(package.json、tsconfig、工作流模板等)。

授权与社群状况

  • 仓库采用 MIT 许可证,星标约 2k,forks 147(说明有一定用户/社区关注度)。

适合谁用 / 使用场景

  • 想快速搭建基于 Claude 的编程助理、自动代码工作流或智能 agent 的开发者与团队。
  • 需要把多个 AI 工作流(搜索、记忆、路由、执行)以标准化方式管理并一键部署的场景。

Github:https://github.com/UfoMiao/zcf

油管:https://youtu.be/pR46Gi1yn4k