<div align="center"> <img src="./src/assets/banner.webp" alt="Banner"/> <h1> ZCF - Zero-Config Code Flow </h1> <p align="center"> <b>English</b> | <a href="README_zh-CN.md">中文</a> | <a href="README_ja-JP.md">日本語</a> | <a href="CHANGELOG.md">Changelog</a>

✨ Full Documentation: ZCF Docs

Zero-config, one-click setup for Claude Code & Codex with bilingual support, intelligent agent system and personalized AI assistant

</p> </div>

♥️ Sponsors

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-4.7 & （GLM-5 Only Available for Pro Users）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

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.

<table> <tbody> <tr> <td width="180"><a href="https://www.packyapi.com/register?aff=zcf"><img src="./src/assets/packycode.png" alt="PackyCode" width="150"></a></td> <td>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 <a href="https://www.packyapi.com/register?aff=zcf">this link</a> and enter the "zcf" promo code during recharge to get 10% off.</td> </tr> <tr> <td width="180"><a href="https://www.aicodemirror.com/register?invitecode=ZCFZCF"><img src="./src/assets/AICodeMirror.jpg" alt="AICodeMirror" width="150"></a></td> <td>Thanks to AICodeMirror for sponsoring this project! AICodeMirror provides official high-stability relay services for Claude Code/Codex/Gemini CLI, supporting enterprise-level high concurrency, fast invoicing, and 7x24 dedicated technical support. Official channels for Claude Code/Codex/Gemini at discounts as low as 38%/2%/10.9% off, with additional discounts on top-ups! AICodeMirror offers special benefits for ZCF users: users who register through <a href="https://www.aicodemirror.com/register?invitecode=ZCFZCF">this link</a> can enjoy 20% off on first top-up, and enterprise customers can get up to 25% off!</td> </tr> <tr> <td width="180"><a href="https://crazyrouter.com/?utm_source=github&utm_medium=sponsor&utm_campaign=zcf&aff=yJFo"><img src="./src/assets/crazyrouter.svg" alt="Crazyrouter" width="150"></a></td> <td>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 <a href="https://crazyrouter.com/?utm_source=github&utm_medium=sponsor&utm_campaign=zcf&aff=yJFo">this link</a> to get $2 free credit instantly!</td> </tr> </tbody> </table>

🚀 Quick Start

Recommended: npx zcf opens the interactive menu — pick what you need.
Common commands:

npx zcf i        # Full initialization: install + workflows + API/CCR + MCP
npx zcf u        # Update workflows only
npx zcf --lang zh-CN  # Switch interface language (example)

Non-interactive example (provider preset):

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

More usage, options, and workflows: see documentation.

📖 Full Documentation

https://zcf.ufomiao.com/

💬 Community

Join our Telegram group for support, discussions, and updates:

🙏 Acknowledgments

This project is inspired by and incorporates work from:

Thanks to these community contributors for sharing!

❤️ Support & Sponsors

If you find this project helpful, please consider sponsoring its development. Your support is greatly appreciated!

Our Sponsors

A huge thank you to all our sponsors for their generous support!

【Corporate Sponsors】

302.AI (first corporate sponsorship 🤠)
GLM (first AI model sponsorship 🤖)
PackyCode (first API proxy service sponsor 🧝🏻‍♀️)
AICodeMirror (official high-stability relay service sponsor 🪞)
UUCode (sponsored $100 proxy credits 💰)
Crazyrouter (AI API aggregation gateway sponsor 🚀)

【Individual Sponsors】

Tc (first sponsor)
Argolinhas (first ko-fi sponsor ٩(•̤̀ᵕ•̤́๑))
r*r (first anonymous sponsor 🤣)
**康 (first KFC sponsor 🍗)
*东 (first coffee sponsor ☕️)
炼*3 (first Termux user sponsor 📱)
chamo101 (first GitHub issue sponsor 🎉)
初屿贤 (first Codex user sponsor 🙅🏻‍♂️)
Protein (first 1688 sponsor 😏)
musistudio (first open source project author sponsor, the author of CCR 🤩)
*年 (first 100 CNY sponsor 💴)
BeatSeat (community expert 😎, provided $1000 Claude credits)
wenwen (community expert 🤓, provided daily $100 Claude&GPT credits)
16°C coffee (My best friend 🤪, offered ChatGPT Pro $200 package)

Promotion Thanks

Thanks to the following authors for promoting this project:

逛逛 GitHub, article: https://mp.weixin.qq.com/s/phqwSRb16MKCHHVozTFeiQ
Geek, tweet: https://x.com/geekbb/status/1955174718618866076

📄 License

MIT License

🚀 Contributors

⭐️ Star History

If this project helps you, please give me a ⭐️ Star!

Zcf

Install / Use

README