De nombreux articles expliquent comment utiliser Claude Code, mais la plupart s’arrêtent à « l’installer et le lancer une première fois ». Les véritables difficultés commencent ensuite — écrire les mêmes instructions à chaque fois, gérer trop de boîtes de dialogue de confirmation et atteindre la limite d’utilisation de 5 heures en cours de travail. Cette page commence là où les articles d’introduction s’arrêtent et traite ces 3 problèmes dans l’ordre.
Pour commencer, Claude Code n’est pas un « outil où l’on colle du code dans un chat », mais un agent qui vit dans le dépôt, au sein du terminal. Il lit les fichiers, les modifie, exécute les tests et peut même effectuer des commits. La première chose à faire n’est donc pas d’apprendre à l’utiliser, mais de lui transmettre les règles du projet.
Les 3 premières étapes — démarrer, /init, demander quelque chose de précis
Après l’installation, ces 3 étapes sont les seules qui valent la peine d’être effectuées. En particulier, si vous ignorez la deuxième, /init, vous devrez répéter les mêmes explications à chaque session suivante.
# 1. プロジェクトのディレクトリで起動する（ここが全ての前提）
cd ~/work/my-app
claude
# 2. 最初の一手は /init — リポジトリを読んで CLAUDE.md を書き出す
> /init
# 3. 以降は普通の日本語で頼む。ファイル名を添えるほど精度が上がる
> src/api/user.ts のバリデーションを zod に置き換えて、テストも直して/init lit le dépôt et génère CLAUDE.md. Le contenu généré n’est qu’un brouillon : ne le laissez pas tel quel et corrigez-le toujours manuellement. La section suivante explique ce qu’il doit contenir.
CLAUDE.md — écrire une seule fois ce que vous expliquez à chaque session
CLAUDE.md est un fichier Markdown placé à la racine du projet et chargé automatiquement à chaque session. Vous ne devez y écrire que les éléments « impossibles à comprendre en lisant le code ».
# CLAUDE.md — プロジェクトのルート、git にコミットする
## コマンド
- テスト: npm test（1 ファイルだけなら npm test -- path/to/file）
- 型チェック: npx tsc --noEmit
- Lint: npm run lint
## 決めごと
- 日付は必ず date-fns。moment は使わない。
- API ハンドラは app/api/**/route.ts のみ。lib に書かない。
- コミットメッセージは日本語、prefix は feat / fix / docs。
## 触ってはいけない場所
- db/migrations/ — 生成物。手で編集しない。Les éléments qu’il vaut mieux ne pas y écrire sont tout aussi clairs. La structure des répertoires et la description des fonctions sont compréhensibles à la lecture du code et sont donc inutiles. Comme CLAUDE.md est inclus dans chaque requête, il consomme inévitablement des tokens s’il devient long — faites court et limitez-vous aux règles. Un commit git permet d’appliquer les mêmes règles à toute l’équipe.
Autorisations — réduire le nombre de confirmations, sans trop les supprimer
Une confirmation est demandée à chaque modification de fichier ou exécution de commande. C’est un dispositif de sécurité ; en pratique, la bonne solution consiste à ne pas tout supprimer, mais à « n’autoriser que les commandes de lecture et de vérification ». Si vous sélectionnez « Toujours autoriser » pendant la session, le choix est mémorisé ; vous pouvez le fixer au niveau du projet dans .claude/settings.json.
Il existe aussi un indicateur qui ignore toutes les confirmations, mais les suppressions et les push vers le dépôt distant seront alors exécutés sans confirmation. Ne l’utilisez que dans un conteneur jetable ou un espace de travail temporaire qui peut être abandonné sans conséquence. Les critères de décision et l’utilisation sûre sont regroupés dans Quand utiliser --dangerously-skip-permissions.
Commandes personnalisées — ne pas répéter la même demande à chaque fois
Les tâches pour lesquelles vous formulez presque toujours la même demande, comme les revues, les vérifications avant une publication ou la mise en forme des messages de commit, peuvent être transformées en commandes. Il suffit de placer du Markdown dans .claude/commands/.
# .claude/commands/review.md — 置くだけで /review として使える
指定されたファイルをレビューして、次の 3 点だけ指摘してください。
1. 実際に落ちる条件があるバグ（再現手順を添える）
2. 既存のユーティリティで置き換えられる重複
3. テストが無い分岐
スタイルの好みは指摘しないでください。Vous obtiendrez ainsi une revue selon les mêmes critères en saisissant /review src/api/user.ts. En le commitant dans git, vous pouvez le partager avec l’équipe et placer les critères de revue eux-mêmes dans le dépôt. Les modèles de commandes efficaces en pratique sont expliqués en détail en anglais dans Claude Code workflows.
Comment continuer lorsque la fenêtre de 5 heures est fermée
Le quota de l’abonnement est géré sur une fenêtre glissante de 5 heures et se ferme souvent l’après-midi, lorsque le travail s’accélère. Passer à un forfait supérieur ne la rouvre pas immédiatement. Il existe en pratique 3 options.
| Option | Situation adaptée |
|---|---|
| Attendre l’ouverture de la fenêtre | Aucune échéance ; vous pouvez attendre quelques heures |
| Passer à une offre supérieure | Cela m’arrive tous les jours. Le quota est constamment insuffisant |
| Basculer vers une clé API uniquement pour cette tâche | La tâche doit être terminée aujourd’hui ; la limite n’est atteinte que quelques fois par mois |
La troisième option est possible sans résilier l’abonnement. Tant que les 2 lignes suivantes sont configurées, la facturation se fait à l’usage ; supprimez les variables pour revenir à l’abonnement.
# 5 時間ウィンドウが閉じても作業を続けるための 2 行。
# この変数が設定されている間だけ従量課金になり、消せば元のサブスクに戻る。
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
# Claude Code の既定モデルと opus エイリアスは最新の Opus を、sonnet エイリアスは
# Kunavo が提供していない Sonnet 5.5 を指す。/model sonnet や opusplan の実行
# フェーズ、sonnet 指定のサブエージェントが 404 にならないようモデルを固定する。
# opus は Opus 5.5 に固定（Claude Code v2.1.280 以降が必要。古ければ claude update）。
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
# 補助的な処理を一番安いモデルに逃がす 1 行（毎セッション効く）
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5Nous chargeons directement les tarifs depuis le catalogue : Claude Sonnet 5 coûte $1.40 / $7.00 par 1M tokens, et Claude Haiku 4.5 coûte $0.70 / $3.50. Le montant est déduit du solde prépayé, donc la facture des mois sans utilisation est de 0. Nous calculons le coût réel par étape et le seuil de rentabilité pour déterminer l’option la moins chère entre abonnement et facturation à l’usage dans Tarifs de Claude Code. Le fonctionnement de la fenêtre est expliqué dans Limites de Claude Pro, et le choix du modèle par défaut dans Différences entre Opus et Sonnet.
Les façons de formuler une demande qui améliorent ou réduisent la précision
Enfin, c’est là que la qualité d’utilisation fait le plus de différence. Ajoutez les noms et chemins des fichiers pour réduire les tokens consacrés à l’exploration et obtenir un résultat plus rapide et plus précis — plutôt que « Corrige la validation », dites « Remplace la validation de src/api/user.ts par zod ».
Ensuite, ne soumettez pas une grande demande en une seule fois. En la découpant en modification → test → modification suivante, le point de reprise reste clair même en cas d’échec. Le diagnostic des erreurs est regroupé sur des pages dédiées, comme Erreur 401 de Claude Code.
Pour essayer la même méthode avec l’agent d’OpenAI, Utiliser Codex explique comment l’exécuter avec une clé API, sans forfait ChatGPT.
Questions fréquentes
Que faut-il faire en premier pour apprendre à utiliser Claude Code ?
Lancez claude dans le répertoire du projet, puis exécutez /init en premier. /init lit le dépôt et génère CLAUDE.md. Il s’agit du fichier qui décrit les règles du projet (comment exécuter les tests, quelles bibliothèques utiliser, quels fichiers ne pas modifier) et qui est ensuite chargé automatiquement à chaque session. Si vous commencez sans le renseigner, vous devrez répéter les mêmes instructions à chaque fois.
Que dois-je écrire dans CLAUDE.md ?
Écrivez uniquement ce que vous expliquez « à chaque fois ». Concrètement : les commandes d’exécution des tests et de vérification des types, les règles propres au projet (utiliser cette bibliothèque de dates, ne pas placer de logique dans cette couche) et les chemins des artefacts générés à ne pas modifier. À l’inverse, n’écrivez pas ce que la lecture du code permet de comprendre. Un long CLAUDE.md entraîne inévitablement un coût puisqu’il est inclus dans chaque requête, sans améliorer la précision.
Que faire si j’atteins la limite d’utilisation de 5 heures ?
Il existe 3 options : attendre la réouverture de la fenêtre, passer à un forfait supérieur ou basculer vers une clé API uniquement pour cette tâche. La troisième option consiste simplement à définir ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN ; il n’est pas nécessaire de résilier votre abonnement. Tant que les variables sont définies, la facturation se fait à l’usage des tokens ; supprimez-les pour revenir à la situation précédente. C’est la méthode la plus rapide lorsque vous ne voulez pas interrompre votre travail.
Puis-je réduire le nombre de fois où l’on me demande « Puis-je l’exécuter ? »
Oui. Si vous sélectionnez « Toujours autoriser » pendant la session, l’autorisation est mémorisée ; vous pouvez la fixer au niveau du projet en l’écrivant dans .claude/settings.json. Autoriser les commandes de lecture et de vérification comme npm test ou git status réduit considérablement le nombre de confirmations. Il existe également un indicateur qui ignore toutes les confirmations, mais ne l’utilisez pas en dehors d’un environnement isolé — les suppressions et les push seront eux aussi exécutés sans confirmation.
Comment créer des commandes personnalisées ?
Il suffit de placer un fichier Markdown dans .claude/commands/. Si vous placez review.md, vous pourrez l’utiliser avec /review. Son contenu peut être un prompt en langage naturel. En le commitant dans git, toute l’équipe pourra utiliser la même commande, ce qui permet de partager les tâches où « la même demande doit être formulée à chaque fois », comme les critères de revue ou la procédure de mise en production.
Quelle astuce est la plus efficace pour apprendre à l’utiliser ?
Indiquez précisément les noms et chemins des fichiers. « Corrige la validation » est moins efficace que « Remplace la validation de src/api/user.ts par zod » : le nombre de tokens utilisés pour l’exploration diminue, et le résultat est plus rapide et plus précis. Autre conseil : ne soumettez pas une grande demande en une seule fois ; découpez-la en modification → test → modification suivante. En cas d’échec, le point de reprise est clairement identifiable.