ai-coding-guide : 92 articles chinois pour apprendre Codex et Claude Code
「可能是全网最全的」📘 面向小白的 AI 编程 CLI 中文教程：Claude Code + Codex 92 篇精修
En bref
- De quoi s’agit-il ?
- Un dépôt de tutoriels en chinois simplifié consacré aux CLI de codage assisté par IA. Le README annonce 92 articles, dont 39 sur Codex et 53 sur Claude Code. Le contenu est hébergé sur un site séparé, pas dans le dépôt.
- À qui s’adresse-t-il ?
- Ce dépôt convient aux développeurs sinophones qui débutent avec Codex ou Claude Code et veulent une progression balisée, ainsi qu'aux équipes qui doivent former des collègues sur ces deux CLI. Il ne convient pas à un lecteur non sinophone : le README possède une version anglaise, mais les 92 articles sont annoncés en chinois.
- Puis-je l’utiliser commercialement ?
- Oui. MIT est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
- Est-il encore maintenu ?
- Oui. Les derniers commits datent d’il y a 13 jours.
- En quel langage est-il écrit ?
- GitHub n’indique pas de langage principal pour ce dépôt.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 15 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
Un corpus de tutoriels, pas un outil
Le dépôt ne contient pas de code exécutable. C'est une collection éditoriale : 92 articles en chinois simplifié, environ 520 000 caractères selon le README, répartis en 53 articles sur Claude Code et 39 sur Codex. La lecture se fait sur coding.stormzhang.ai, avec une interface décrite comme « 暗色终端风 », un style terminal sombre. Le dépôt sert de vitrine et de sommaire, pas de moteur.
Le public visé est explicite dans le README : les débutants, y compris ceux qui ne sont pas à l'aise avec la ligne de commande. La progression annoncée va de l'installation jusqu'à des sujets d'ingénierie comme les hooks, les sous-agents, le SDK d'agent ou les GitHub Actions. La licence est MIT, ce qui autorise la réutilisation et la modification du contenu textuel, à condition de conserver l'avis de licence. Cela ne couvre pas les marques citées, ni les conditions d'utilisation des outils décrits.
La structure des deux séries et ce qu'elle révèle
Les deux séries ne sont pas symétriques. Claude Code occupe 53 articles, Codex 39, mais le README présente Codex comme le parcours principal recommandé. L'ordre des numéros le confirme : la série Claude Code va de l'introduction aux hooks, aux commandes slash, aux checkpoints, jusqu'à un article 50 sur les anti-patterns et un article 52 qui sert de glossaire. La série Codex couvre quatre points d'entrée, AGENTS.md, le sandbox et les approbations, config.toml, la mémoire Chronicle, les worktrees, et un article sur la migration depuis Claude Code.
Ce dernier point est le plus intéressant du sommaire. Un article dédié à la migration suppose que le lecteur a déjà investi du temps dans l'un des deux outils et cherche à basculer. C'est un besoin réel : les deux CLI manipulent des fichiers de configuration différents (CLAUDE.md d'un côté, AGENTS.md et config.toml de l'autre), et une équipe qui change d'outil doit reprendre ses conventions. Le README ne dit pas si cet article fournit une table de correspondance entre les deux formats. C'est précisément ce qu'il faudrait vérifier avant de s'appuyer dessus.
Ce que l'auteur met en avant comme différence
Le README consacre une section aux écarts avec les autres tutoriels. Trois engagements y figurent. D'abord, la documentation officielle comme source de vérité : les fonctions, commandes et comportements par défaut sont annoncés comme vérifiés contre developers.openai.com/codex et code.claude.com/docs. Ensuite, une réécriture pour débutants, avec une structure en trois temps par concept : mise en situation, analogie du quotidien, cas réel. Enfin, des traces d'expérience personnelle, présentées comme au moins trois par article, avec des détails concrets et des chiffres réels.
Ces engagements sont invérifiables depuis le dépôt seul. Le README affirme aussi 81 illustrations SVG ou PNG en style sombre, avec une contrainte annoncée de dix nœuds maximum par schéma. Cette contrainte, si elle est tenue, est un bon indicateur : elle oblige à découper les explications plutôt qu'à empiler des diagrammes illisibles. Mais rien dans le dépôt ne permet de compter les images ni de contrôler leur qualité.
Le problème du contenu hébergé ailleurs
C'est la limite structurelle du projet. Le dépôt ne contient pas les articles. Le README renvoie vers coding.stormzhang.ai pour chaque entrée du sommaire, et les 92 liens pointent vers ce domaine. Cela crée trois dépendances : la disponibilité du site, la stabilité des URL, et la pérennité du domaine. Une licence MIT sur le dépôt ne protège pas contre la disparition du site si le contenu n'y est pas dupliqué.
Il faut aussi noter que le dépôt n'a pas de releases publiées. La date du dernier push est le 2 septembre 2026. Un lecteur qui veut archiver le contenu pour une utilisation hors ligne, ou pour une équipe sans accès réseau externe, devra vérifier par lui-même si les articles sont récupérables. Le README ne mentionne ni export PDF, ni dépôt miroir, ni version imprimable. Pour un support de formation interne, c'est un point à trancher avant de bâtir un programme dessus.
Comment s'y mettre concrètement
Le point d'entrée recommandé par le README est la série Codex, avec un lien direct vers coding.stormzhang.ai/codex/. La série Claude Code se trouve à coding.stormzhang.ai/claude-code/. Les deux parcours commencent par le même enchaînement : définition de l'outil, installation, premier exemple, puis configuration.
Pour Codex, l'article 03 traite de l'installation et de la connexion sur Mac, Windows et Linux, l'article 04 des abonnements et de la facturation, l'article 05 de l'usage de modèles tiers comme DeepSeek, l'article 06 du premier task, puis l'article 08 entre dans le CLI. Pour Claude Code, l'article 02 couvre l'installation, l'article 04 le choix entre connexion par abonnement et clé API, l'article 05 les modèles tiers, l'article 07 le premier exemple. Les fichiers de configuration traités sont CLAUDE.md pour Claude Code, et AGENTS.md plus config.toml pour Codex. Le README ne reproduit aucune commande complète : il faut ouvrir les pages pour les obtenir. C'est une raison de plus de tester une page avant de recommander le corpus à une équipe.
Les articles de synthèse, là où se joue l'utilité réelle
Au-delà des tutoriels d'installation, deux articles portent la valeur du corpus. L'article 30 de la série Claude Code s'intitule « 功能怎么选 », comment choisir entre CLAUDE.md, Skill, Hook, MCP et Subagent. C'est le genre de question qu'un développeur se pose après deux semaines d'usage, quand il a accumulé des configurations sans savoir laquelle convient à quel besoin. L'article 50 traite des anti-patterns, et l'article 51 du dépannage.
La série Codex a une logique différente. Elle insiste sur les mécanismes propres à l'outil : le sandbox et les approbations, la mémoire Chronicle, les worktrees. Ces sujets touchent à l'isolation et à la sécurité des exécutions, ce qui les rend plus proches d'une préoccupation d'équipe que d'un tutoriel pour débutant. Le README ne précise pas le niveau requis pour ces articles. Un lecteur qui découvre la ligne de commande risque d'y arriver trop tôt s'il suit l'ordre numérique.
Alternatives et coût de maintenance
L'alternative la plus directe n'est pas un autre dépôt, c'est la documentation officielle elle-même. Claude Code dispose d'une documentation en chinois simplifié, à l'adresse code.claude.com/docs/zh-CN, citée dans le README comme source de vérification. Codex dispose de developers.openai.com/codex, en anglais. La différence d'approche est nette : la documentation officielle décrit le comportement de référence, sans progression pédagogique et sans retour d'expérience. Le corpus de stormzhang apporte l'ordre, les analogies et les cas pratiques, mais perd en autorité dès qu'il s'écarte de la source.
Le coût de maintenance est asymétrique. Les deux outils évoluent vite : les commandes, les clés de configuration et les valeurs par défaut peuvent changer entre deux versions. Un corpus de 92 articles adossé à deux produits mouvants demande une relecture continue. Le README annonce une vérification contre les documentations officielles, mais ne décrit ni fréquence de mise à jour, ni journal des changements, ni version des outils couverte. Pour une adoption en entreprise, c'est la question à poser en premier : quel article a été revu en dernier, et contre quelle version.
Conclusion éditoriale
Ce dépôt convient aux développeurs sinophones qui débutent avec Codex ou Claude Code et veulent une progression balisée, ainsi qu'aux équipes qui doivent former des collègues sur ces deux CLI. Il ne convient pas à un lecteur non sinophone : le README possède une version anglaise, mais les 92 articles sont annoncés en chinois. Avant de s'engager, vérifier deux points précis : ouvrir une page du site et comparer ses commandes avec la documentation officielle de l'outil concerné, puis lire l'article 30 de la série Claude Code, qui traite justement du choix entre CLAUDE.md, Skill, Hook, MCP et Subagent. Si ce dernier ne tranche pas clairement, le reste de la série risque d'être une compilation descriptive plutôt qu'un guide de décision.
Notes de la communauté