Claude (Anthropic) : Guide de référence rapide

Modèles

Anthropic publie régulièrement de nouvelles versions (numérotées) de chaque famille. Vérifier docs.anthropic.com pour la liste à jour et les dates de fin de support des anciennes versions.

claude.ai (interface web)

Projects

Un Project regroupe :
- Des instructions personnalisées (contexte permanent pour toutes
  les conversations du projet)
- Des fichiers de référence (docs, code, specs) consultables par
  Claude dans toutes les conversations du projet
- Un historique de conversations lié au même contexte

Utile pour : garder le contexte d’un projet (infra, codebase, style de rédaction) sans le retaper à chaque conversation.

Artifacts

Contenu généré (code, document, diagramme, page HTML) affiché dans un panneau séparé de la conversation, modifiable indépendamment. Se déclenche automatiquement pour du contenu suffisamment long ou autonome (un script complet, une page web, un rapport structuré).

Extended thinking

Certains modèles peuvent exposer leur raisonnement intermédiaire avant la réponse finale – utile pour vérifier la logique sur des tâches de debug ou d’analyse, pas nécessaire pour des demandes simples (ça ralentit la réponse).

API – bases

Authentification et endpoint

curl https://api.anthropic.com/v1/messages 
  -H "x-api-key: $ANTHROPIC_API_KEY" 
  -H "anthropic-version: 2023-06-01" 
  -H "content-type: application/json" 
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Explique la différence entre TCP et UDP en 3 phrases."}
    ]
  }'

Paramètres courants

System prompt

{
  "model": "claude-sonnet-4-5",
  "max_tokens": 1024,
  "system": "Tu es un assistant technique. Réponds toujours en français, de façon concise, avec des exemples de commande quand pertinent.",
  "messages": [
    {"role": "user", "content": "Comment lister les ports ouverts sur Linux ?"}
  ]
}

Le system définit le comportement global, séparé des tours de conversation dans messages – contrairement à d’anciennes API qui mélangeaient les deux dans un seul historique de rôles.

Appel avec image (vision)

{
  "model": "claude-sonnet-4-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "image",
          "source": {
            "type": "base64",
            "media_type": "image/png",
            "data": "BASE64_ENCODED_IMAGE"
          }
        },
        {"type": "text", "text": "Que montre ce graphique Grafana ?"}
      ]
    }
  ]
}

Bonnes pratiques de prompt

Structurer avec des balises XML

Serveur Debian 12, Nginx 1.24, certificat Let's Encrypt.



Explique pourquoi Nginx refuse de démarrer après renouvellement
du certificat.



Réponse en 3 points maximum, avec la commande de diagnostic
à lancer en premier.

Claude répond de façon fiable aux structures XML explicites (...) pour séparer contexte, instructions et contraintes de format – plus robuste qu’un paragraphe unique mélangeant tout.

Donner un rôle et des contraintes explicites

Tu es un relecteur de code exigeant. Ne complimente pas le code
avant d'avoir listé les problèmes. Si le code est correct, dis-le
en une phrase, sans développer inutilement.

Demander l’explication avant la solution

Avant de proposer un correctif, explique le mécanisme exact du bug.

Force un raisonnement vérifiable plutôt qu’une réponse qui a l’air juste sans l’être.

Itérer plutôt que tout mettre dans un seul prompt

Un prompt unique et massif (« fais X, puis Y, vérifie Z, et documente le tout ») donne souvent des résultats moins fiables qu’une série d’échanges courts et vérifiés un par un.

Limites à connaître

• Pas d’accès internet en temps réel par défaut (sauf outils explicitement activés côté produit/API).
• Date de coupure des connaissances : vérifier la doc du modèle utilisé, ne pas supposer une actualité récente.
• Ne connaît pas votre environnement précis (versions exactes, configs locales) sauf si vous le lui donnez explicitement dans le prompt.