---
title: Quick Start
---

# Quick Start

This chapter introduces how to initialize your environment with ZCF in minutes, covering pre-installation preparation, common commands, and recommended operation sequence.

## Quick Navigation

If you're new to ZCF, we recommend following these steps:

1. **View [Installation Guide](installation.md)** - Learn about system requirements, usage methods, interactive and non-interactive initialization flows, and complete configuration steps
2. **Familiarize with core features** - Check [Features](../features/) to understand Claude Code, Codex, MCP services, CCR proxy, and other core capabilities
3. **Master CLI commands** - Refer to [CLI Commands](../cli/) to learn how to use various commands

## Recommended Workflow

### First-Time Use

1. Run `npx zcf` or `npx zcf init` for complete initialization
2. Select code tool type (Claude Code or Codex)
3. Configure API key or use API provider preset
4. Select MCP services to install
5. Select workflow templates and output styles

### Existing Environment

- Run `npx zcf update` to update workflows and templates
- Use `npx zcf` to open interactive menu for incremental configuration
- Use `npx zcf config-switch` to switch between different configurations

> 💡 **Tip**: During operation, if you need to understand specific features, feel free to jump to the corresponding feature chapter or CLI command documentation.
