Comment utiliser Claude Code — au-delà du guide pour débutants

De nombreux articles expliquent comment utiliser Claude Code, mais la plupart s’arrêtent après « l’installation et la première réponse ». Les véritables difficultés viennent ensuite : vous répétez les mêmes explications, les fenêtres de confirmation apparaissent trop souvent et la fenêtre d’utilisation de 5 heures se ferme en plein travail. Cet article commence là où les guides d’introduction s’arrêtent et traite successivement ces trois problèmes.

Commençons par une prémisse commune. Claude Code n’est pas un outil auquel on colle du code dans une fenêtre de chat, mais un agent qui réside dans le dépôt depuis le terminal. Il lit et modifie les fichiers, exécute les tests et va jusqu’à créer des commits. La première chose à faire n’est donc pas de mémoriser son utilisation, mais de lui transmettre les règles du projet.

Les trois premières étapes — exécuter, /init, demander précisément

Juste après l’installation, ces trois étapes sont les seules qui méritent votre attention. En particulier, si vous sautez la deuxième étape, /init, vous devrez répéter les mêmes explications à chaque session.

# 1. 프로젝트 디렉터리에서 실행한다 (이게 전제 조건입니다)
cd ~/work/my-app
claude

# 2. 첫 명령은 /init — 저장소를 읽고 CLAUDE.md를 만들어 줍니다
> /init

# 3. 이후엔 한국어로 그냥 부탁하면 됩니다. 파일 경로를 붙일수록 정확해집니다
> src/api/user.ts의 검증 로직을 zod로 바꾸고 테스트도 같이 고쳐줘

/init lit le dépôt et crée CLAUDE.md. Le contenu généré est un brouillon : ne le laissez pas tel quel et réorganisez-le impérativement à la main. La section suivante explique ce qu’il doit contenir.

CLAUDE.md — écrire une seule fois ce que vous expliquiez à chaque fois

CLAUDE.md est un fichier Markdown placé à la racine du projet et lu automatiquement à chaque session. Il doit contenir uniquement « ce que la lecture du code ne permet pas de savoir ».

# CLAUDE.md — 프로젝트 루트에 두고 git에 커밋합니다

## 명령어
- 테스트: npm test (파일 하나만: npm test -- path/to/file)
- 타입 검사: npx tsc --noEmit
- 린트: npm run lint

## 규칙
- 날짜는 date-fns만 사용. moment 금지.
- API 핸들러는 app/api/**/route.ts에만 둔다.
- 커밋 메시지는 한국어, prefix는 feat / fix / docs.

## 건드리면 안 되는 곳
- db/migrations/ — 생성물. 직접 수정 금지.

Ce qu’il ne faut pas y inscrire est tout aussi clair. La structure des répertoires et les descriptions de fonctions sont déductibles du code et sont donc inutiles. CLAUDE.md est inclus dans chaque requête, donc sa longueur consomme des tokens — faites court, limitez-vous aux règles. Si vous le validez dans git, les mêmes règles s’appliquent à toute l’équipe.

Autorisations — réduire les confirmations sans tout désactiver

Une fenêtre de confirmation apparaît chaque fois que vous modifiez un fichier ou exécutez une commande. C’est une protection ; en pratique, il vaut mieux autoriser uniquement les opérations de lecture et de vérification plutôt que de tout désactiver. Si vous choisissez « Toujours autoriser » pendant une session, le choix est mémorisé ; en l’inscrivant dans .claude/settings.json, vous le fixez au niveau du projet.

Il existe un indicateur qui ignore toutes les confirmations, mais il désactive également celles concernant les suppressions et les push distants. Utilisez-le uniquement dans un conteneur ou un espace de travail temporaire que vous pouvez jeter en cas de problème. Le critère de décision est expliqué dans quand utiliser --dangerously-skip-permissions.

Commandes personnalisées — ne plus taper la même demande

Les tâches que vous demandez presque toujours de la même manière, comme une revue, une vérification avant publication ou la mise en forme d’un message de commit, peuvent être transformées en commandes. Il suffit de placer un fichier Markdown dans .claude/commands/.

# .claude/commands/review.md — 파일만 두면 /review로 쓸 수 있습니다
지정된 파일을 리뷰하고 다음 세 가지만 지적하세요.

1. 실제로 실패하는 조건이 있는 버그 (재현 방법 포함)
2. 기존 유틸리티로 대체 가능한 중복
3. 테스트가 없는 분기

스타일 취향은 지적하지 마세요.

Vous pouvez alors lancer une revue selon la même approche avec /review src/api/user.ts. Si vous validez la commande dans git, l’équipe la partage et les critères de revue eux-mêmes peuvent être conservés dans le dépôt. Des exemples de commandes utilisées en pratique sont décrits plus en détail en anglais dans Claude Code workflows.

Comment continuer lorsque la fenêtre d’utilisation se ferme

L’utilisation de l’abonnement est gérée par une fenêtre glissante de 5 heures, qui se ferme souvent au moment où le travail devient urgent l’après-midi. Passer à un forfait supérieur ne la rouvre pas immédiatement. En pratique, trois options sont possibles.

La troisième option ne nécessite pas de résilier l’abonnement. Tant que les deux lignes ci-dessous sont configurées, la facturation est à l’usage ; supprimez les variables pour revenir à l’abonnement. Si vous n’avez pas encore de clé, commencez par obtenir une clé API Claude.

# 사용량 창이 닫혀도 작업을 이어가는 두 줄.
# 이 변수가 설정된 동안에만 종량제로 청구되고, 지우면 구독으로 돌아갑니다.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# 클로드 코드의 기본 모델과 opus 별칭은 최신 Opus를, sonnet 별칭은 Sonnet 5.5를
# 가리킵니다. Kunavo가 제공하지 않는 모델(Sonnet 5.5, 아직 들어오지 않은 새 Opus)을
# 요청해 404가 나지 않도록 모델을 고정합니다. sonnet을 고정하지 않으면 /model sonnet,
# opusplan의 실행 단계, model: 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

# 보조 작업을 가장 싼 모델로 넘기는 한 줄 (매 세션 효과가 있습니다)
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Les tarifs sont lus directement dans le catalogue : Claude Sonnet 5 coûte $1.40 / $7.00 par million de tokens, et Claude Haiku 4.5 coûte $0.70 / $3.50. Le montant est déduit du solde prépayé ; aucun frais n’est donc facturé pendant les mois où vous ne travaillez pas. Le calcul du seuil de rentabilité pour déterminer l’option la moins chère entre abonnement et paiement à l’usage figure dans tarification de Claude Code ; les solutions lorsque le paiement est bloqué avec une carte coréenne sont détaillées dans prix et paiement de l’API Claude, et la structure de la fenêtre d’utilisation elle-même dans limites de Claude Pro.

Les demandes qui améliorent les résultats et celles qui les dégradent

Enfin, c’est ici que la différence de méthode d’utilisation est la plus visible. Indiquer le chemin d’un fichier réduit les tokens consacrés à l’exploration et rend le résultat plus rapide et plus précis — « Corrige la logique de validation » devient « Remplace par zod la logique de validation dans src/api/user.ts ».

Et ne confiez pas une tâche volumineuse en une seule fois. Découpez-la en modification → test → modification suivante afin d’avoir un point de retour clair en cas d’échec. La manière de distinguer les différents types d’erreurs est expliquée dans le récapitulatif des erreurs de Claude Code.

Si vous souhaitez utiliser l’agent de codage d’OpenAI de la même manière, comment utiliser Codex explique comment exécuter Codex CLI avec une clé API, sans forfait ChatGPT.

Questions fréquentes