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
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.
 |
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 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! |
 |
Thanks to PatewayAI for sponsoring this project! 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! |
- Recommended:
npx zcfopens 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.
Join our Telegram group for support, discussions, and updates:
This project is inspired by and incorporates work from:
Thanks to these community contributors for sharing!
If you find this project helpful, please consider sponsoring its development. Your support is greatly appreciated!
 |
 |
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 🚀)
- 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)
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
If this project helps you, please give me a ⭐️ Star!