stormzhang/ai-coding-guide

What it solves

This project provides a comprehensive, beginner-friendly Chinese guide for mastering AI coding tools, specifically Codex and Claude Code. It addresses the challenge of learning complex AI development workflows by providing verified, step-by-step tutorials that bridge the gap between official documentation and practical, real-world application.

How it works

The guide is structured into 92 detailed articles across two main tracks: Codex (39 articles) and Claude Code (53 articles). Each article follows a consistent three-part structure: a scenario introduction, a relatable analogy, and a practical application. The content is based strictly on official documentation, supplemented by the author's personal experience, including specific troubleshooting tips, complete command-line instructions, and expected outputs for hands-on practice.

Who it’s for

This guide is designed for anyone interested in AI-assisted programming, from absolute beginners with no command-line experience to experienced developers looking to integrate AI agents into their professional workflows. It is particularly useful for Chinese-speaking users who want to navigate the setup, configuration, and advanced features of these tools without relying on rumors or unverified third-party advice.

Highlights

• Fact-Based Content: All commands and behaviors are verified against official Codex and Claude Code documentation.
• Actionable Learning: Every tutorial includes complete, copy-pasteable commands with expected results for immediate feedback.
• Real-World Experience: Includes personal "pitfall" notes and practical tips gained from actual usage, not just theoretical explanations.
• Beginner Friendly: Concepts are explained with simple, everyday analogies and include a glossary to translate technical jargon into plain language.
• Visual Aids: Features 81 original, dark-themed diagrams to help visualize complex workflows without clutter.