Repolode
Submit
UfoMiao

UfoMiao/zcf

A CLI that one-command sets up Claude Code and Codex with bilingual prompts, workflows, API provider presets and MCP configuration.

View on GitHubWebsite
Stars
6,080
Forks
420
Open issues
45
Last commit
2 months ago

What is it?

ZCF (Zero-Config Code Flow) is a command-line tool that prepares Claude Code and Codex for use without manual setup. Running `npx zcf` opens an interactive menu, and `npx zcf i` performs a full initialization covering installation, workflow files, API or CCR (Claude Code Router) configuration, and MCP setup.

The tool supports non-interactive use with provider presets, for example passing a preset name and API key on the command line. It also offers an update command that refreshes workflows without reinstalling everything, and a language switch for its interface. The project is written in TypeScript and distributed through npm.

It is aimed at developers who use Claude Code or Codex and want a consistent, ready-to-use environment across machines, including those who prefer Chinese-language prompts and workflows.

Key features

  • 01One-command full initialization of Claude Code and Codex
  • 02Interactive menu and non-interactive mode with provider presets
  • 03Workflow updates without reinstalling
  • 04API and CCR (Claude Code Router) configuration
  • 05MCP setup and bilingual interface language switching

Use cases

  • Setting up Claude Code or Codex on a new machine in one step
  • Keeping workflow prompts consistent across a team's development environments
  • Switching between API providers without editing config files by hand

Quick start

  1. 1

    Run the interactive menu via npx

    npx zcf
  2. 2

    Run full initialization (install, workflows, API/CCR, MCP)

    npx zcf i

Things to know

  • Relies on sponsor-linked API relay providers for some preset options.

Topics

#claude-code#codex#cli#llm#developer-tools#mcp#prompt-engineering#typescript#agent#ai

FAQ

What is zcf?
A CLI that one-command sets up Claude Code and Codex with bilingual prompts, workflows, API provider presets and MCP configuration. ZCF (Zero-Config Code Flow) is a command-line tool that prepares Claude Code and Codex for use without manual setup. Running `npx zcf` opens an interactive menu, and `npx zcf i` performs a full initialization covering installation, workflow files, API or CCR (Claude Code Router) configuration, and MCP setup.
Is zcf free to use? What license does it have?
zcf is open source under the MIT license. Check the license terms before using it in commercial products.
Is zcf still maintained?
Updated within 6 months. The last commit to zcf was on Aug 31, 2026.
What can I use zcf for?
Setting up Claude Code or Codex on a new machine in one step Keeping workflow prompts consistent across a team's development environments Switching between API providers without editing config files by hand
How do I install zcf?
Run the interactive menu via npx: npx zcf Run full initialization (install, workflows, API/CCR, MCP): npx zcf i
Where can I get zcf?
The source code and installation instructions are on GitHub: https://github.com/UfoMiao/zcf

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects