zcf is a zero-config code flow CLI for Claude Code and Codex that installs the tooling, workflows, API/CCR provider settings, and MCP servers in a single command, and it is aimed at developers and teams who want a working AI coding agent setup without hand-editing configuration files.

What it is

zcf (Zero-Config Code Flow) is an MIT-licensed TypeScript command-line tool distributed through npm and run with npx. It lives in the AI coding agent ecosystem, alongside the agents it configures: its topic list covers cli, agent, ai-agent, claude, claude-code, claude-4, claude-ai, gpt, gpt-5, ccr, and bmad-method. The project describes itself as zero-config, one-click setup for Claude Code and Codex with bilingual support, an intelligent agent system, and a personalized AI assistant. Full documentation is hosted at zcf.ufomiao.com, and the project carries 6,083 stars and 420 forks on GitHub.

The concrete problem it solves is setup work. Standing up Claude Code or Codex normally means installing the CLI, placing workflow files, choosing and wiring an API relay or CCR provider, and registering MCP servers, each as a separate manual step. zcf collapses that sequence into npx zcf i, which the README describes as full initialization: install plus workflows plus API/CCR plus MCP. It replaces the per-machine hand assembly of those configuration files and provider settings, and it keeps the result repeatable, since npx zcf u refreshes only the workflows when the rest of the installation is already correct.

Key capabilities

• Interactive setup menu through npx zcf, letting the user pick which pieces to install.
• Full initialization with npx zcf i, covering install, workflows, API/CCR, and MCP in one pass.
• Workflow-only update with npx zcf u, for refreshing workflows without reinstalling everything.
• Non-interactive provider preset with npx zcf i -s -p 302ai -k "sk-xxx", which skips prompts by naming a provider and passing a key.
• Interface language switching with npx zcf --lang zh-CN, alongside a README offered in English, Chinese, and Japanese.
• Configuration of API/CCR providers and MCP servers as first-class parts of initialization rather than separate chores.
• Support for the BMAD method and CCR, reflected in the project topic list.

Who uses it and how

• Individual developers running Claude Code or Codex who want a working setup without writing configuration by hand.
• Automated and scripted environments, where the -s flag with -p and -k allows setup with no interactive prompts.
• Multilingual developers, since both the tool interface and the README are available in English, Chinese, and Japanese.
• Users adopting structured agent workflows, including the BMAD method, who need workflow files installed and maintained.
• Anyone maintaining an existing setup who needs to move workflows forward with npx zcf u instead of repeating full initialization.

Getting started

Run npx zcf to open the interactive menu and select what is needed, or run npx zcf i for full initialization. A non-interactive equivalent is npx zcf i -s -p 302ai -k "sk-xxx", and the hosted documentation at https://zcf.ufomiao.com/ carries the full option and workflow reference.

How it compares

No list of paid products that zcf replaces is provided in the facts, so no licence, cost, or data-ownership comparison can be made here. The tools named in the facts, Claude Code, Codex, Cline, and Roo Code, are targets that zcf configures rather than alternatives to it, and no directly comparable setup tool is named. On the evidence given, it stands alone in this registry as a configuration and workflow layer for those agents.

When to use it — and when not to

Choose zcf when the goal is to get Claude Code or Codex running against a chosen provider with MCP servers in place, without assembling the configuration files manually. Expect to supply your own credentials, as the non-interactive example passes a provider key with -k, and expect npm and npx to be available on the machine. The README excerpt available here is largely badges, sponsor blocks, and a quick start, so anyone needing a complete command and option reference should treat the hosted docs as the real manual, and readers should note that the page promotes several sponsor programs before treating any sponsor claims as neutral.

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)

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