← all repositories
stormzhang/ai-coding-guide

A Chinese field manual for terminal-shy AI coders

It translates the official Claude Code and Codex docs into plain Chinese for developers who would rather not guess what a blinking cursor wants.

Feature · 29 Jun 2026
A Chinese Curriculum for the Agent-Coding Era

To translate the chaos of English-only, rapidly mutating CLI agents into a verified, runnable curriculum for Chinese-speaking developers.

Read the in-depth article
ai-coding-guide
Velocity · 7d
+6.3
★ / day
Trend
accelerating
star history

What it does

This is a curated Chinese-language tutorial collection—92 articles split between Anthropic’s Claude Code and OpenAI’s Codex CLI. It walks beginners from basic command-line concepts through agent loops, MCP, sandbox approvals, and migration strategies. The author claims every feature is cross-checked against official documentation rather than third-party guesswork.

The interesting bit

The guide refuses to be a dry translation. Each article includes first-person pitfall stories with concrete details and real numbers, and teaches via a three-part structure: scenario setup, everyday analogy, then a concrete command-line task. Even the 64 custom SVG illustrations use a dark Catppuccin Mocha theme so the site mimics the actual CLI window.

Key highlights

  • 53 Claude Code articles and 39 Codex articles, covering agent loops, MCP, Skills, Hooks, sandbox approvals, and GitHub Actions integration.
  • A dedicated “basics” track for command-line novices; the FAQ explicitly says no prior terminal experience is required.
  • Content is free under MIT, though the tools themselves require a paid subscription or API access starting around $20 per month.
  • Requires proxy/VPN access for installation and login; the guide flags this upfront rather than letting users hit a wall mid-setup.
  • Packaged as a VitePress site with Shiki syntax highlighting, mermaid diagrams, and auto-generated OG cards.

Caveats

  • The entire repository and tutorial site are written in Chinese, which is great if you read the language and useless otherwise.
  • Both target tools iterate rapidly, so the guide’s accuracy decays unless the author keeps patching; the commit log doubles as the changelog.

Verdict

Grab this if you are a Chinese-speaking developer who wants to use Claude Code or Codex but needs a gentle, verified on-ramp. Skip it if you already live in a terminal and prefer to read English official docs directly.

Frequently asked

What is stormzhang/ai-coding-guide?
It translates the official Claude Code and Codex docs into plain Chinese for developers who would rather not guess what a blinking cursor wants.
Is ai-coding-guide open source?
Yes — stormzhang/ai-coding-guide is open source, released under the MIT license.
How popular is ai-coding-guide?
stormzhang/ai-coding-guide has 1.6k stars on GitHub and is currently accelerating.
Where can I find ai-coding-guide?
stormzhang/ai-coding-guide is on GitHub at https://github.com/stormzhang/ai-coding-guide.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.