ZCF with Traditional Chinese support - 繁體中文增強版 | Zero-Config Code Flow - One-click configuration tool for Claude Code
📢 Note: This is a fork with Traditional Chinese (zh-TW) support. A Pull Request has been submitted to the original project. This package (
zcf-tw) serves as a temporary solution for Traditional Chinese users until the PR is merged.📢 注意：這是一個支援繁體中文（zh-TW）的分支版本。已向原專案提交 Pull Request。本套件 (
zcf-tw) 作為過渡方案，供繁體中文使用者使用，直到 PR 被合併。
English | 简体中文 | 繁體中文 | 日本語 | Changelog
✨ Quick Links: Codex Support | BMad Workflow | Spec Workflow | Open Web Search | CCR Router | CCometixLine | Output Styles | Multi-Configuration Management
Zero-config, one-click setup for Claude Code & Codex with bilingual support, intelligent agent system and personalized AI assistant
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.
npx zcf # Open interactive menu and choose operations based on your needs
Menu options include:
1 Full initialization (equivalent to zcf i)2 Import workflows (equivalent to zcf u)3 Configure API or CCR - API configuration or CCR proxy setup4 Configure MCP - MCP service configuration and management5 Configure default model - Set default model (opus/sonnet/sonnet 1m/custom)6 Configure AI memory - Configure AI output language and global output style7 Configure environment permissions - Import environment variables and permissionsR Claude Code Router management (enhanced in v2.8.1)U ccusage - Claude Code usage analysisL CCometixLine - High-performance statusline tool with Git integration and real-time usage tracking (v2.9.9+ new)+ Check updates - Check and update Claude Code, CCR and CCometixLine versions (v2.9.9+ enhanced)Model Configuration (Option 5): Configure your default Claude model with flexible options:
AI Memory Configuration (Option 6): Personalize your AI assistant:
npx zcf i # Execute full initialization directly: Install Claude Code + Import workflows + Configure API + Set up MCP services
# or
npx zcf → select 1 # Execute full initialization via menu
npx zcf u # Update workflows only: Quick add AI workflows and command system
# or
npx zcf → select 2 # Execute workflow update via menu
Note:
- Since v2.0,
zcfopens the interactive menu by default, providing a visual operation interface- You can choose operations through the menu or use commands directly for quick execution
zcf i= full initialization,zcf u= update workflows only
ZCF supports bilingual operation with automatic language switching for all commands:
# Use Chinese for all operations
npx zcf --lang zh-CN # Interactive menu in Chinese
npx zcf init --lang zh-CN # Initialize with Chinese interface
npx zcf ccr --all-lang zh-CN # Configure CCR in Chinese
# Language parameter priority (highest to lowest):
# --all-lang > --lang > saved user preference > interactive prompt
Language Parameters:
--lang, -l: ZCF interface language (applies to all commands)--all-lang, -g: Set all language parameters at once (most convenient)--config-lang, -c: Template files language (init/update commands only)--ai-output-lang, -a: AI assistant output language (init command only)For CI/CD and automated setups, use --skip-prompt with parameters:
# Using API provider preset (v3.3.0+ New - Simplified)
npx zcf i -s -p 302ai -k "sk-xxx"
# Shorthand version (traditional)
npx zcf i -s -g zh-CN -t api_key -k "sk-xxx" -u "https://xxx.xxx"
# Complete version (traditional)
npx zcf i --skip-prompt --all-lang zh-CN --api-type api_key --api-key "sk-xxx" --api-url "https://xxx.xxx"
# Using provider preset with custom models
npx zcf i -s -p 302ai -k "sk-xxx" -M "claude-sonnet-4-5" -F "claude-haiku-4-5"
# Complete version (with custom models)
npx zcf i --skip-prompt \
--api-type api_key \
--api-key "sk-xxx" \
--api-url "https://xxx.xxx" \
--api-model "claude-sonnet-4-5" \
--api-fast-model "claude-haiku-4-5"
# Multiple API configurations (JSON string)
npx zcf i -s --api-configs '[
{"provider":"302ai","key":"sk-xxx"},
{"provider":"glm","key":"sk-yyy"},
{"name":"custom","type":"api_key","key":"sk-zzz","url":"https://custom.api.com","primaryModel":"claude-sonnet-4-5","fastModel":"claude-haiku-4-5","default":true}
]'
# Multiple API configurations (JSON file)
npx zcf i -s --api-configs-file ./api-configs.json
# For Codex with multiple providers
npx zcf i -s -T cx --api-configs '[
{"provider":"302ai","key":"sk-xxx"},
{"name":"custom","type":"api_key","key":"sk-yyy","url":"https://custom.api.com","primaryModel":"gpt-5","default":true}
]'
ZCF now supports API provider presets that automatically configure baseUrl and models, simplifying configuration from 5+ parameters to just 2:
Supported Providers:
302ai - 302.AI API Serviceglm - GLM (z.ai)minimax - MiniMax API Servicekimi - Kimi (Moonshot AI)custom - Custom API endpoint (requires manual URL configuration)Usage Examples:
# Using 302.AI provider
npx zcf i --skip-prompt --provider 302ai --api-key "sk-xxx"
# or shorthand
npx zcf i -s -p 302ai -k "sk-xxx"
# Using GLM provider
npx zcf i -s -p glm -k "sk-xxx"
# Using MiniMax provider
npx zcf i -s -p minimax -k "sk-xxx"
# Using Kimi provider
npx zcf i -s -p kimi -k "sk-xxx"
# Using custom provider (requires URL)
npx zcf i -s -p custom -k "sk-xxx" -u "https://api.example.com"
# For Codex
npx zcf i -s -T cx -p 302ai -k "sk-xxx"
Benefits:
When using --skip-prompt, the following parameters are available:
| Parameter | Description | Values | Required | Default |
|---|---|---|---|---|
--skip-prompt, -s | Skip all interactive prompts | - | Yes (for non-interactive mode) | - |
--provider, -p | API provider preset (v3.3.0+ New) | 302ai, glm, minimax, kimi, custom | No | - (Simplifies configuration by auto-filling baseUrl and models) |
--lang, -l | ZCF display language (applies to all commands) | zh-CN, en | No | en or user's saved preference |
--config-lang, -c | Configuration language (template files language) | zh-CN, en | No | en |
--ai-output-lang, -a | AI output language | zh-CN, en, custom string | No | en |
--all-lang, -g | Set all language parameters (applies to all commands) | zh-CN, en, custom string | No | - (Priority: --all-lang > --lang > saved user preference > interactive prompt. Custom string sets AI output language to custom while interaction and config languages remain 'en') |
--config-action, -r | Config handling | new, backup, merge, docs-only, skip | No | backup |
--api-type, -t | API configuration type | auth_token, api_key, ccr_proxy, skip | No | skip (auto-set to api_key when --provider is specified) |
--api-key, -k | API key (for both API key and auth token types) | string | Required when api-type is not skip | - |
--api-url, -u | Custom API URL | URL string | No | official API (auto-filled when using --provider) |
--api-model, -M | Primary API model | string (e.g., claude-sonnet-4-5) | No | - (auto-filled when using --provider if available) |
--api-fast-model, -F | Fast API model (Claude Code only) | string (e.g., claude-haiku-4-5) | No | - (auto-filled when using --provider if available) |
--mcp-services, -m | MCP services to install (multi-select, comma-separated) | context7, open-websearch, spec-workflow, mcp-deepwiki, Playwright, exa, serena, or skip for none | No | all |
--workflows, -w | Workflows to install (multi-select, comma-separated) | commonTools, sixStepsWorkflow, featPlanUx, gitWorkflow, bmadWorkflow, or skip for none | No | all |
--output-styles, -o | Output styles to install (multi-select, comma-separated) | engineer-professional, nekomata-engineer, laowang-engineer, ojousama-engineer, or skip for none | No | all |
--default-output-style, -d | Default output style | Same as output styles plus built-in: default, explanatory, learning | No | engineer-professional |
--install-cometix-line, -x | Install CCometixLine statusline tool | true, false | No | true |
--code-type, -T | Target code tool type | claude-code, codex, cc, cx | No | Current active tool type from ZCF config |
--api-configs | Multiple API configurations (JSON string) | JSON array string of API configuration objects | No | - (Mutually exclusive with --api-configs-file) |
--api-configs-file | Multiple API configurations (JSON file path) | Path to JSON file containing API configuration array | No | - (Mutually exclusive with --api-configs) |
Codex is OpenAI's official code generation CLI tool. ZCF now supports complete Codex integration with the same configuration convenience as Claude Code.
Key Features:
Getting Started with Codex:
Switch to Codex mode in ZCF main menu:
npx zcf → Select S # Switch between Claude Code and Codex
Or access Codex features directly:
# Full Codex initialization
npx zcf → Select 1 (after switching to Codex mode)
# Individual Codex configuration
npx zcf → Select 3 # Configure Codex API providers
npx zcf → Select 4 # Configure Codex MCP services
Configuration Options:
API Provider Configuration:
System Prompt Styles:
Workflow Integration:
/workflow commands cannot pass parameters directly. Use /workflow first, then provide task description in follow-up messageMCP Services: Full compatibility with existing MCP services including:
File Locations:
~/.codex/config.toml~/.codex/auth.json~/.codex/AGENTS.md~/.codex/prompts/~/.codex/backup/Migration Between Tools:
ZCF allows seamless switching between Claude Code and Codex while preserving your preferences and workflow configurations. Both tools share the same MCP services and workflow templates for consistent development experience.
ZCF now supports customizable AI output styles to personalize your Claude Code experience:
Available Output Styles:
engineer-professional: Professional software engineer following SOLID, KISS, DRY, YAGNI principlesnekomata-engineer: Professional catgirl engineer UFO Nya, combining rigorous engineering with cute catgirl traitslaowang-engineer: Laowang grumpy tech style, never tolerates code errors and non-standard codeojousama-engineer: Tsundere blonde ojou-sama programmer Halley-chan, combining rigorous engineering excellence with tsundere ojou-sama traitsdefault, explanatory, learning (always available)Features:
Usage Tips:
/output-style command to switch project-level output styles anytimeImportant:
npx zcf check to update.engineer-professional output style, solving issues with excessive token usage and AI forgetting global memory.BMad (BMad-Method: Universal AI Agent Framework) is an enterprise-grade workflow system that provides:
After installation, use /bmad-init to initialize the BMad workflow in your project.
Spec Workflow is a comprehensive MCP service that provides structured feature development workflow from requirements to implementation:
The Spec Workflow MCP provides an optional dashboard for workflow visualization. Users can manually launch the dashboard using:
npx -y @pimzino/spec-workflow-mcp@latest --dashboard
Alternatively, you can install the VS Code extension for integrated workflow management.
Usage Guide: For detailed usage instructions and best practices, see the official Spec Workflow documentation.
Open Web Search is a versatile web search MCP service that provides access to multiple search engines:
CCR is a powerful proxy router that enables:
To access CCR features:
npx zcf ccr # Open CCR management menu
# or
npx zcf → select R
CCR menu options:
After CCR setup, ZCF automatically configures Claude Code to use CCR as the API proxy.
CCometixLine is a high-performance Rust-based statusline tool that provides:
CCometixLine menu options (accessible via npx zcf → L):
1 Install or Update - Install or update CCometixLine using npm2 Print Default Configuration - Display current CCometixLine configuration3 Custom Config - TUI Configuration Mode - Interactive terminal UI for customizing settingsImportant Note for v2.9.9 Users: If you have previously used ZCF v2.9.9 to set up your environment, please re-run the initialization process to ensure CCometixLine configuration is properly added. Run
npx zcfand select the appropriate setup option to update your configuration with CCometixLine support.
npx zcf check-updates # Check and update Claude Code, CCR and CCometixLine to latest versions
# or
npx zcf → select +
Full initialization (npx zcf) will automatically:
After configuration:
/init-project to generate CLAUDE.md for better AI understanding of project architecture<task description> - Execute directly without workflow, following SOLID, KISS, DRY, and YAGNI principles, suitable for small tasks like bug fixes/feat <task description> - Start new feature development, divided into plan and UI phases/workflow <task description> - Execute complete development workflow, not automated, starts with multiple solution options, asks for user feedback at each step, allows plan modifications, maximum controlPS:
- Both feat and workflow have their advantages, try both to compare
- Generated documents are located by default at
.claude/xxx.mdin project root, you can add.claude/to your project's.gitignore
ZCF provides flexible API configuration options for both Claude Code and Codex:
Quick Setup with API Provider Presets (v3.3.0+ New):
Choose from popular API providers with pre-configured settings:
When using a preset provider, you only need to:
The system automatically configures:
Traditional Configuration Methods:
Unified, incremental, interactive management for both Claude Code and Codex:
~/.claude/settings.json and restarts CCR when needed~/.ufomiao/zcf/config.toml (backups config.backup.YYYY-MM-DD_HH-mm-ss.toml)Choose tool type explicitly:
# -T accepts: claude-code|codex or short aliases cc|cx
npx zcf cs --list -T cc # List Claude Code profiles
npx zcf cs --list -T cx # List Codex providers
npx zcf cs -l -T cc # Short option for --list
npx zcf cs -l -T cx # Short option for --list
Claude Code usage:
# Quick switch
npx zcf cs official -T cc # Switch to official login
npx zcf cs ccr -T cc # Switch to CCR proxy
npx zcf cs my-profile -T cc
Codex usage:
# List and switch providers
npx zcf cs --list -T cx
npx zcf cs my-provider -T cx
# Switch to official login (interactive selection)
npx zcf config-switch -T cx
Notes:
ANTHROPIC_API_KEY, Auth Token → ANTHROPIC_AUTH_TOKEN, Base URL → ANTHROPIC_BASE_URL.-T cc/cx only when targeting a different tool than the current one.$ npx zcf
ZCF - Zero-Config Code Flow
? Select ZCF display language / 选择ZCF显示语言:
❯ 简体中文
English
Select function:
-------- Claude Code --------
1. Full initialization - Install Claude Code + Import workflow + Configure API or CCR proxy + Configure MCP services
2. Import workflow - Import/update workflow-related files only
3. Configure API - Configure API URL and authentication (supports CCR proxy)
4. Configure MCP - Configure MCP services (includes Windows fix)
5. Configure default model - Set default model (opus/sonnet/sonnet 1m/custom)
6. Configure Claude global memory - Configure AI output language and output styles
7. Import recommended environment variables and permissions - Import privacy protection environment variables and system permissions
--------- Other Tools ----------
R. CCR - Claude Code Router management
U. ccusage - Claude Code usage analysis
L. CCometixLine - High-performance statusline tool with Git integration and real-time usage tracking
------------ ZCF ------------
0. Select display language / 更改显示语言 - Change ZCF interface language
-. Uninstall - Remove Claude Code configurations and tools from system
+. Check updates - Check and update Claude Code, CCR and CCometixLine versions
Q. Exit
Enter your choice: _
zcf i)? Select Claude Code configuration language:
❯ English (en) - English (recommended, lower token consumption)
简体中文 (zh-CN) - Chinese (easier for Chinese users to customize)
日本語 (ja) - Japanese (日本のユーザー向け)
? Select AI output language:
AI will respond to you in this language
❯ English
简体中文
日本語
Custom
(Supports French, German, and more)
? Claude Code not found. Install automatically? (Y/n)
✔ Claude Code installed successfully
? Existing config detected. How to proceed?
❯ Backup and overwrite - Backup existing config to ~/.claude/backup/
Update docs only - Only update workflows and docs, keep existing API config
Merge config - Merge with existing config, preserve user customizations
Skip - Skip configuration update
? Select API authentication method
❯ Use Official Login
Use official authentication system without API configuration
Use Auth Token (OAuth authentication)
For tokens obtained via OAuth or browser login
Use API Key (Key authentication)
For API keys from Anthropic Console
Configure CCR Proxy (Claude Code Router)
Use multiple AI models via proxy routing to reduce costs and explore possibilities
Skip (configure manually later)
? Enter API URL: https://api.anthropic.com
? Enter Auth Token or API Key: xxx
? Select output styles to install:
❯ Engineer Professional - Professional software engineer following SOLID, KISS, DRY, YAGNI principles
Nekomata Engineer - Professional catgirl engineer UFO Nya, combining rigorous engineering with cute catgirl traits
Laowang Grumpy Tech - Laowang grumpy tech style, never tolerates code errors and non-standard code
Ojou-sama Engineer - Tsundere blonde ojou-sama programmer Halley-chan, combining rigorous engineering excellence with tsundere ojou-sama traits
? Select global default output style:
❯ Engineer Professional
? Select workflows to install (space to select, enter to confirm):
❯ ◉ Common Tools (init-project + init-architect + get-current-datetime) - Essential project initialization and utility commands
◉ Six Steps Workflow (workflow) - Complete 6-phase development process
◉ Feature Planning and UX Design (feat + planner + ui-ux-designer) - Structured feature development
◉ Git Commands (commit + rollback + cleanBranches + worktree) - Streamlined Git operations
◉ BMAD-Method Extension Installer - Enterprise agile development workflow
✔ Installing workflows...
✔ Installed command: zcf/workflow.md
✔ Installed command: zcf/feat.md
✔ Installed agent: zcf/plan/planner.md
✔ Installed agent: zcf/plan/ui-ux-designer.md
✔ Installed command: zcf/git/git-commit.md
✔ Installed command: zcf/git/git-rollback.md
✔ Installed command: zcf/git/git-cleanBranches.md
✔ Installed command: zcf/git/git-worktree.md
✔ Installed command: zcf/bmad-init.md
✔ Workflow installation successful
? Configure MCP services? (Y/n)
? Select MCP services to install (space to select, enter to confirm):
❯ ◉ Context7 Documentation Query - Query latest library docs and code examples
◉ DeepWiki - Query GitHub repository docs and examples
◉ Playwright Browser Control - Direct browser automation control
◉ Exa AI Search - Web search using Exa AI
◉ Serena Assistant - Semantic code retrieval and editing akin to an IDE
◯ Install all services
✔ MCP services configured
? Install CCometixLine statusline tool? (Y/n)
✔ Setup complete! Claude Code environment is ready
🎉 Setup complete! Use 'claude' command to start.
| Command | Alias | Description |
|---|---|---|
zcf | - | Show interactive menu (v2.0 default command) |
zcf init | zcf i | Initialize Claude Code configuration |
zcf update | zcf u | Update workflow-related md files with backup |
zcf ccu | - | Run Claude Code usage analysis tool - ccusage |
zcf ccr | - | Open CCR (Claude Code Router) management menu |
zcf config-switch | zcf cs | API provider/config switching for Claude Code and Codex (-T cc / -T cx) |
zcf uninstall | - | Interactive uninstall tool for Claude Code configurations and tools |
zcf check-updates | - | Check and update Claude Code, CCR and CCometixLine versions |
# Specify configuration language
npx zcf --config-lang zh-CN
npx zcf -c zh-CN # Using short option
# Force overwrite existing configuration
npx zcf --force
npx zcf -f # Using short option
# Update workflow-related md files with backup (preserve API and MCP configs)
npx zcf u # Using update command
npx zcf update # Full command
# Show help information
npx zcf --help
npx zcf -h
# Show version
npx zcf --version
npx zcf -v
# Show interactive menu (default)
npx zcf
# First-time installation, complete initialization
npx zcf i
npx zcf init # Full command
# Update workflow-related md files with backup, keep API and MCP configs
npx zcf u
npx zcf update # Full command
# Force reinitialize with Chinese config
npx zcf i --config-lang zh-CN --force
npx zcf i -c zh-CN -f # Using short options
# Update to English prompts (lower token consumption)
npx zcf u --config-lang en
npx zcf u -c en # Using short option
# Run Claude Code usage analysis tool (powered by ccusage)
npx zcf ccu # Daily usage (default), or use: monthly, session, blocks
# Codex API provider switching (v3.0.0+ New)
npx zcf config-switch # Interactive provider selection
npx zcf cs # Using alias
npx zcf cs provider-name # Direct switch to specified provider
npx zcf cs --list # List all available providers
zcf/
├── README.md # Documentation
├── package.json # npm package configuration
├── bin/
│ └── zcf.mjs # CLI entry point
├── src/ # Source code
│ ├── cli.ts # CLI main logic
│ ├── commands/ # Command implementations
│ ├── utils/ # Utility functions
│ └── constants.ts # Constant definitions
├── templates/ # Configuration templates
│ ├── CLAUDE.md # Project level config (v2.0 new)
│ ├── settings.json # Base configuration (with privacy env vars)
│ ├── en/ # English version
│ │ ├── rules.md # Core principles (formerly CLAUDE.md)
│ │ ├── output-styles/ # AI output styles (v2.12+ new)
│ │ ├── mcp.md # MCP services guide (v2.0 new)
│ │ ├── agents/ # AI agents
│ │ └── commands/ # Command definitions
│ └── zh-CN/ # Chinese version
│ └── ... (same structure)
└── dist/ # Build output
/feat): Structured new feature development/workflow): Complete six-phase development workflow/git-commit: Smart commit with automatic staging and message generation/git-rollback: Safely rollback to previous commits with backup/git-cleanBranches: Clean up merged branches and maintain repository hygiene/git-worktree: Manage Git worktrees with IDE integration and content migration/bmad-init): Initialize BMad workflow for enterprise development
# Clone the project
git clone https://github.com/UfoMiao/zcf.git
cd zcf
# Install dependencies (using pnpm)
pnpm install
# Build project
pnpm build
# Local testing
node bin/zcf.mjs
.claude/plan/ directory at the project rootIf you encounter issues:
npx zcf to reconfigure~/.claude/ directoryrg) preferentially for file searching for better performanceZCF fully supports Windows platform:
cmd /c npx format on Windows systemsIf you encounter MCP connection issues on Windows, running npx zcf will automatically fix the configuration format.
ZCF now provides comprehensive support for Windows Subsystem for Linux (WSL):
If running in WSL, ZCF will automatically detect the environment and display appropriate installation messages.
ZCF now supports running in Android Termux environment:
To protect user data security, the following operations require explicit confirmation:
git commit, git push, git reset --hardThis project is inspired by and incorporates the following open source projects:
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!
Thanks to the following authors for promoting this project:
If this project helps you, please give me a ⭐️ Star!
FAQs
ZCF with Traditional Chinese support - 繁體中文增強版 | Zero-Config Code Flow - One-click configuration tool for Claude Code
We found that zcf-tw demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Axios compromise traced to social engineering, showing how attacks on maintainers can bypass controls and expose the broader software supply chain.
Security News
Node.js has paused its bug bounty program after funding ended, removing payouts for vulnerability reports but keeping its security process unchanged.
Security News
The Axios compromise shows how time-dependent dependency resolution makes exposure harder to detect and contain.