UfoMiao/zcf：适用于 Claude code 和 Codex 的零配置代码

项目介绍

UfoMiao/zcf 是一个托管在 GitHub 上的开源项目，主要使用 TypeScript 编写，采用 MIT License 许可证，目前获得 6.1k 个 Star、420 次 Fork。

仓库全名: UfoMiao/zcf

README 摘要

ZCF - Zero-Config Code Flow English | 中文 | 日本語 | Changelog ✨ Full Documentation: ZCF Docs One config for all your AI coding tools. ZCF installs the tools you pick and writes each one's own settings. [!IMPORTANT] This is ZCF v5, a rewrite that is not published yet. Until it is, npx zcf still installs v3 (source at the [email protected] tag), and zcf.ufomiao.com describes v3. To try v5 from source, see Contributing. 🚀 Quick…

完整内容见 GitHub 原始 README 或本页。

常见问题

zcf 用什么语言开发？

主要使用 TypeScript 编写，采用 MIT License 许可证，目前有 6.1k 个 Star。

zcf 可以免费商用吗？

如何获取 zcf 的源码？

可以直接克隆仓库：git clone https://github.com/UfoMiao/zcf.git，默认分支为 main；安装与运行步骤见仓库 README。

zcf 最近还在维护吗？

仓库最近一次更新为 1 周前，当前有 38 个未关闭 Issue；Star 数为 6.1k，可作为社区活跃度的参考。

关于

GitHub 原始描述（英文）

Zero-Config Code Flow for Claude code & Codex

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

MIT License
6.1k Stars
420 Forks
27 Watching

描述取自 GitHub 官方 API，保持仓库作者书写的原文。

简要分析

热度分

6938

价值分

3769

活跃状态

活跃

GitHub

语言占比

CSS

HTML

JavaScript

Shell

TypeScript

Release

贡献者

ZCF - Zero-Config Code Flow

English | 中文 | 日本語 | Changelog

✨ Full Documentation: ZCF Docs

One config for all your AI coding tools. ZCF installs the tools you pick and writes each one’s own settings.

Important 重要

This is ZCF v5, a rewrite that is not published yet. Until it is, npx zcf still installs v3 (source at the [email protected] tag), and zcf.ufomiao.com describes v3. To try v5 from source, see Contributing.

🚀 Quick Start

You keep one ZCF config: your provider, your MCP servers and your skills. ZCF installs the tools you pick and writes each tool’s own settings with the tool’s own commands, such as claude mcp add-json and npx skills add.

Supported tools: Claude Code, Codex, Gemini CLI, OpenCode, Cursor CLI, Pi and DeepSeek Harness.

Once v5 is published:

npx zcf            # edit the config in the terminal
npx zcf ui         # or in the browser
npx zcf plan       # see every command and a diff of each file ZCF would edit
npx zcf apply -y   # install missing tools and write their settings
npx zcf update     # update the tools with their own updaters

Nothing changes before you apply. ZCF edits only the keys it manages, keeps your comments and formatting, backs up each file before changing it, and never prints your keys. Coming from v3? See Coming from v3.

📖 Full Documentation

Getting started, Config file, Commands and Agent tools
Architecture: ADR 002

♥️ Sponsors

Thanks to AICodeMirror for sponsoring this project! AICodeMirror provides highly reliable official relay services for Claude, Codex, and Gemini, supporting enterprise-grade concurrency, fast invoice issuance, and dedicated 24/7 technical support. Official Codex access is available for as little as 7% of the standard price, with additional discounts on account top-ups! AICodeMirror also offers an exclusive benefit to users of the ZCF project: register through this link to receive 20% off your first top-up.

This project is sponsored by Z.ai, supporting us with their GLM CODING PLAN. GLM CODING PLAN is a subscription service designed for AI coding, starting at just $10/month. It provides access to their flagship GLM-5.2 model across 10+ popular AI coding tools (Claude Code, Cline, Roo Code, etc.), offering developers top-tier, fast, and stable coding experiences. Get 10% OFF GLM CODING PLAN：https://z.ai/subscribe?ic=8JVLJQFSKB

Thanks to code0.ai for sponsoring this project! code0.ai is an AI coding workspace for developers and technical teams, bringing together mainstream Agent coding capabilities such as Claude Code and Codex. It supports common development scenarios including code generation, project understanding, debugging, code review, and documentation. It is suitable for independent developers, Agent engineers, open-source maintainers, and enterprise R&D teams, with invoicing and team onboarding supported. Register through the exclusive link and contact customer support to claim free test credits and experience a more efficient AI coding workflow.

Thanks to Claude API for sponsoring this project! Claude API is an official-channel API provider focused on Claude models. Built on Anthropic official keys and AWS Bedrock official channels, it provides a stable integration experience for Claude Code and Agent applications, supports the full Claude model family, and preserves official capabilities such as Tool Use and long context. The service is not reverse-engineered and does not downgrade model capabilities, making it suitable for heavy Claude Code users, Agent engineers, and enterprise technical teams. Register through the exclusive link and contact customer support to claim free test credits. Invoicing and team onboarding are also supported.

PatewayAI is a high-quality model API relay service provider focused on official direct connections for serious AI developers, offering the full range of Claude and Codex series models. 100% official source supply with no adulteration — open to inspection. Transparent billing with token-level invoices auditable line by line. Enterprise-grade concurrency support with a dedicated management platform for enterprise customers, including formal contracts and invoicing. PatewayAI offers an exclusive benefit for ZCF users: register via this link to get $3 free trial credit, recharges as low as 60% off, with bilateral invite rewards up to $150!

302.AI is a pay-as-you-go enterprise AI resource hub that offers the latest and most comprehensive AI models and APIs on the market, along with a variety of ready-to-use online AI applications.

	Thanks to PackyCode for sponsoring this project! PackyCode is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. PackyCode provides special discounts for our software users: register using this link and enter the "zcf" promo code during recharge to get 10% off.
	Thanks to APIKEY.FUN for sponsoring this project! APIKEY.FUN is a professional enterprise-grade AI relay platform dedicated to providing stable, efficient, and low-cost API access for both companies and individual developers. The platform supports popular models including Claude, OpenAI, and Gemini, with pricing as low as 7% of official rates. Register via this link to enjoy an exclusive offer of up to permanent 95% recharge pricing (5% off).
	Thanks to Crazyrouter for sponsoring this project! Crazyrouter is a high-performance AI API aggregation gateway — one API key for 300+ models (GPT, Claude, Gemini, DeepSeek, and more). All models at 55% of official pricing with auto-failover, smart routing, and unlimited concurrency. Fully OpenAI-compatible, works seamlessly with Claude Code, Codex, and Gemini CLI. Crazyrouter offers an exclusive deal for ZCF users: register via this link to get $2 free credit instantly!
	Thanks to AIHub for sponsoring this project! AIHub is a high-availability AI model API relay platform for individual developers and enterprise teams, supporting Codex and Claude Code at prices below ~10% of official rates. Register via this link and enter the promo code ZCF to claim $3 trial credit.
	Thanks to Sublyx for sponsoring this project! Sublyx is a reliable AI API aggregation gateway, providing unified access to popular models including GPT, Claude, Gemini, Grok, and more through a single API key. It is compatible with Codex, Claude Code, OpenAI SDK, and other common AI development tools. Sublyx offers an exclusive benefit for our users: register via this link and use the promo code ZCF to receive an additional $10 in credit.