stormzhang/ai-coding-guide を読む前に確認したいこと
「可能是全网最全的」📘 面向小白的 AI 编程 CLI 中文教程：Claude Code + Codex 92 篇精修
ひと目でわかる
- これは何？
- Claude Code 53 篇と Codex 39 篇、合計 92 篇の中国語チュートリアルを MIT ライセンスで公開するリポジトリ。コードではなく文書を配るタイプのプロジェクトで、読者層と更新コストの見極めが導入判断の中心になる。
- 誰に向いている？
- 中国語で Claude Code と Codex をこれから学ぶ個人、特にコマンドラインに不慣れな読者には出発点として使える。逆に、公式ドキュメントを読める英語話者、あるいは API リファレンスやバージョン固定の情報を求める読者には不要である。
- 商用利用できる？
- できます。MIT は寛容なライセンスで、著作権表示とライセンス表示を残せば、使用・改変・販売が可能です。
- 今もメンテナンスされている？
- されています。最後のコミットは 13 日前です。
- 何の言語で書かれている？
- GitHub はこのリポジトリの主な言語を示していません。
回答はプロジェクトの GitHub データ（最終同期：2026年9月15日）と当サイトの分析に基づくもので、法的助言ではありません。
オープンソース詳細解説
このリポジトリが配っているのはコードではなく文章である
stormzhang/ai-coding-guide は、AI コーディング CLI の使い方を解説する中国語チュートリアル集である。README の冒頭には「92 篇 · 约 52 万字」とあり、主力として Codex 39 篇、併せて Claude Code 53 篇を収録すると書かれている。ソフトウェアライブラリではなく、学習教材のリポジトリだ。README に書かれた対象読者は「0 基础」、つまりプログラミング経験がない層である。想定読者は、Claude Code や Codex というツールの名前は聞いたことがあるが、ターミナルでの操作に慣れていない中国語話者ということになる。英語の公式ドキュメントを読む負荷を下げるために存在する教材であり、ツールそのものの代替ではない。
公式ドキュメントを事実源に据えるという方針
README は他教材との差異として「以官方文档为事实来源」を最初に挙げ、Codex 公式と Claude Code 公式のドキュメントに照らして機能やコマンド、既定の挙動を確認したと説明している。第三者による推測を写していないという主張である。この方針は、AI コーディング CLI のように仕様変更が速い領域では合理的だ。ただし、公式ドキュメントを参照して書かれた二次資料である以上、公式側が更新されれば内容は古くなる。README には記事の最終更新日や、どのバージョンの公式ドキュメントを参照したかの記載が見当たらない。読む側は、書かれているコマンドが現在のバージョンでも有効かを自分で確かめる必要がある。
Claude Code 篇 53 本の並びが示す学習順序
Claude Code 篇の目次は、単なる機能一覧ではなく学習順序として組まれている。01 の「Claude Code 简介」から 02 のインストール、03 の動作原理、04 の API 設定、07 の「第一次使用」と進み、その後は VS Code や JetBrains の統合、CLAUDE.md によるプロジェクト初期化、コンテキスト管理、権限設定、セキュリティ境界といった実務寄りの話題に移る。後半は MCP、Subagents、Plugins、memory、Agent Skills、Hooks、Agent SDK、GitHub Actions と、拡張の仕組みを一つずつ扱う構成だ。30 番に「CLAUDE.md vs Skill vs Hook vs MCP vs Subagent」という機能選択の回が置かれている点は、似た役割の機能が増えた現在の Claude Code では実用的な位置づけと言える。49 番のベストプラクティス、50 番の反模式、51 番の FAQ と、締めの並びも教材として整っている。
Codex 篇 39 本と README に残った穴
Codex 篇は 01 の「認識 Codex 与四种入口」に始まり、AGENTS.md、サンドボックスと承認、config.toml、Chronicle による記憶、Worktrees、Claude Code からの移行を扱うと README に記されている。ここで注意したいのは、README 上で Codex 篇の一覧が 09 番「IDE 拡張（VS Code 等）」の途中で切れていることだ。39 篇あるという記述はあるが、10 番以降のタイトルは提示された資料からは確認できない。リポジトリの構成を評価する際、Codex 篇の後半がどういう順序で並んでいるかは、Web サイト側を見ないと判断できない。Claude Code 篇のように全 53 篇のタイトルが展開されている状態と比べると、README の情報量に偏りがある。
読み方の入口は 2 つある
README は閲覧方法として、リポジトリ内の Markdown と、coding.stormzhang.ai の 2 つを案内している。Web 版は暗色のターミナル風デザインで、README いわく「体验更佳」とのことである。Claude Code 篇の各記事には coding.stormzhang.ai/claude-code/01-what-is-claude-code のような URL が振られており、記事単位で直接リンクできる。リポジトリを clone して手元で読むか、Web サイトを読むかで、得られるものは同じではない。Web 版には 81 枚の SVG/PNG による配図があると README は説明しており、リポジトリ側に同じ図が同梱されているかは資料からは判断できない。オフライン環境や社内ネットワークで読ませたい場合は、先に図の有無を確認したほうがよい。
MIT ライセンスが意味する範囲
ライセンスは MIT である。教材として MIT が付いているということは、社内研修資料への転載や改変、再配布といった用途の障壁が低いことを意味する。ただし MIT が及ぶのはこのリポジトリのコンテンツに対してであり、記事が説明している Claude Code や Codex 本体の利用条件とは無関係だ。ツール側の利用規約、API の課金、モデルの利用ポリシーは別途それぞれの提供元に従う。また、記事中で引用されている公式ドキュメントの文章や、第三者の商標がどう扱われているかは、提示された資料からは確認できない。転載を検討する場合は、ライセンス表記の保全と出典の扱いを自組織で確認する作業が残る。
この教材が向かない読者と、代わりに読むべきもの
第一の限界は言語である。コンテンツは簡体字中国語で書かれており、README には英語版として README.en.md へのリンクがあるが、92 篇の本文が英語化されているとは書かれていない。中国語を読めない読者にとって、このリポジトリの価値はほぼ失われる。第二に、これは二次資料である。正確な引数や設定キーを確認したい場面では、Codex 公式や Claude Code 公式のドキュメントを直接参照するほうが確実だ。第三に、記事は概念の説明と手順の提示に重心があり、リファレンスとして引く用途には向かない。代替としては、各ツールの公式ドキュメントそのものが最も近い存在である。公式は一次情報で更新も早いが、中国語話者にとって読みにくく、概念の導入説明は薄い。このリポジトリは、公式にたどり着くまでの足場として使うのが正しい位置づけになる。
維持コストと採用判断
維持コストの観点で見ると、このリポジトリは読者側にコストを移す構造になっている。92 篇、約 52 万字という規模は、公式仕様の変更に追従する作業がそれだけ大きいことを意味する。最終 push は 2026-09-02 と記録されているが、リリースは取得されておらず、記事単位の更新履歴も資料からは見えない。読者として採用するなら、読む前に coding.stormzhang.ai の Codex 篇一覧で 10 番以降のタイトルを確認し、自分の知りたい話題が 39 篇の中に含まれているかを見る。次に、Claude Code 篇の 04「API 配置」など課金や認証に関わる回を開き、記述が現在の公式ドキュメントと食い違っていないかを照合する。この 2 段階を踏まずに学習の主軸を置くと、古い既定値や廃止されたコマンドを覚える危険がある。
編集部の結論
中国語で Claude Code と Codex をこれから学ぶ個人、特にコマンドラインに不慣れな読者には出発点として使える。逆に、公式ドキュメントを読める英語話者、あるいは API リファレンスやバージョン固定の情報を求める読者には不要である。採用前に確認すべきなのは、coding.stormzhang.ai の Codex 篇 39 篇の一覧が README 上で途中までしか展開されていない点と、リポジトリ内の記事ファイルと Web サイト側の記述がどちらを正とするかである。この 2 点が決まらない限り、社内の学習資料として固定リンクを張る判断はできない。
コミュニティノート