✨ 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

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.

🚀 Quick Start

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

npx @benbenwu/zcf i        # Full initialization: install + workflows + API/CCR + MCP
npx @benbenwu/zcf u        # Update workflows only
npx @benbenwu/zcf --lang zh-CN  # Switch interface language (example)
npx @benbenwu/zcf i -s -T codex # Non-interactive Codex setup

• Non-interactive example (provider preset):

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

• For local development validation, use the repo entrypoints instead of bare npx @benbenwu/zcf:

pnpm dev -- i -s -T codex
pnpm start -- i -s -T codex
node bin/zcf.mjs i -s -T codex

Bare npx @benbenwu/zcf resolves the published npm package, so it will not automatically use your local repository changes.

📦 Release to npm

If you want npx @benbenwu/zcf to pick up your local changes, you must publish a new npm version. Republishing the same version is not allowed.

Recommended release flow for this repository:

# 1. Create a changeset and choose version bump type
pnpm changeset

# 2. Apply the version bump
pnpm changeset version

# 3. Run validation
pnpm lint
pnpm typecheck
pnpm test:run
pnpm build

# 4. Login to npm if needed
npm login

# 5. Publish using the repo release script
pnpm release

Notes:

• package.json already sets "publishConfig": { "access": "public" }, so pnpm release / changeset publish will publish as a public package.
• If your npm account uses passkeys / WebAuthn and changeset publish still asks for a one-time password, first verify the project is using @changesets/[email protected] or newer:

pnpm exec changeset --version
pnpm list @changesets/cli

• Older Changesets releases handled OTP in-process and could not use npm's newer web-based authentication flow. If you hit that issue, upgrade Changesets and log in again with web auth:

pnpm add -D @changesets/cli@latest
npm login --auth-type=web
pnpm release

• This repository already declares @changesets/cli@^2.30.0, which is the first series that delegates OTP / web auth handling back to the package manager.
• pnpm publish --access public can still be used as a manual fallback after you run pnpm changeset version and pnpm build, but it is not the primary workflow in this repo.

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 🧝🏻‍♀️)
• 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!