AI Coding Guide (Claude Code + Codex)
English | 简体中文
📘 92 articles · ~520k characters of carefully-crafted tutorials — 53 for Claude Code + 39 for Codex — taking you from install to fluent, turning the command line into your fastest tool.
⚠️ The tutorial content is written in Simplified Chinese. This page is the only English entry.
📖 Read online (dark terminal theme, best experience) → https://coding.stormzhang.ai

What makes this different
- Official docs as the source of truth: every feature / command / default behavior is verified against the Claude Code docs and Codex docs — no third-party guesses, no hearsay.
- Rewritten for beginners: each new concept follows a 3-part structure (scenario → real-life analogy → concrete use case); no command-line background required.
- Real, first-hand experience: plenty of first-person gotchas and judgment calls (with concrete details and real numbers), not vague "I think" filler.
- Runnable & self-verifiable: every hands-on step gives the full command + expected output for instant feedback.
- Original dark-engineering diagrams: 81 SVG/PNG diagrams, consistent dark style, ≤ 10 nodes each.
Contents
Claude Code (53 articles)
From "what is it / install" to the agent loop, MCP, subagents, Skills, Hooks, Agent SDK, GitHub Actions — plus best practices / anti-patterns / FAQ / glossary.
→ Start here: coding.stormzhang.ai
Codex (39 articles)
The four entry points, AGENTS.md, sandbox approvals, config.toml, Chronicle memory, Worktrees, migrating from Claude Code, and more.
→ Start here: coding.stormzhang.ai
How to read
- Pick one tool (recommended: start with Claude Code).
- Read in order; each article takes 3–10 min.
- Read and do — every article has runnable commands + expected output.
- Integrate each chapter into your daily dev workflow as you go.
FAQ
| Q | A |
|---|---|
| Does it cost money? | The tutorial itself is completely free (MIT). But Claude Code / Codex themselves require a subscription or API payment — subscribe to whatever fits your needs. |
| Can I learn without command-line experience? | Yes. The first group, "Getting Started", is built for newcomers and starts from the basics. |
| Claude Code or Codex first? | The two are conceptually close, each with its strengths. Beginners: start with Codex — lower barrier and friendlier for users in mainland China; Claude Code has stricter account risk controls (higher ban risk), so it's safer to get comfortable first and switch later. The Codex section includes a "Migrating from Claude Code" comparison — the two are interchangeable. |
| Will it be updated? | Both tools iterate fast; important changes are tracked. See Commits for versions. |