ZCF - Zero-Config Code Flow

English | 中文 | 日本語 | Changelog

✨ Full Documentation: ZCF Docs

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

♥️ 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

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 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 this link can enjoy 20% off on first top-up, and enterprise customers can get up to 25% 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!

🚀 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:

• LINUX DO - New Ideal Community
• CCR
• CCometixLine
• ccusage
• BMad Method

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 🧝🏻‍♀️)
• APIKEY.FUN (enterprise AI relay sponsor 🎁)
• AICodeMirror (official high-stability relay service sponsor 🪞)
• UUCode (sponsored $100 proxy credits 💰)
• Crazyrouter (AI API aggregation gateway sponsor 🚀)
• PatewayAI (official direct-connect relay service 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!