Intégration Claude Code | Documentation des API

Claude Code appelle les modèles via le protocole Anthropic Messages. Définissez ANTHROPIC_BASE_URL sur l’URL de base compatible Anthropic indiquée sur cette page.

Claude Sonnet 4.6 (claude-sonnet-4-6) est pris en charge par le fournisseur amont, mais n’est actuellement pas publié sur RequestBeam. Il ne constitue pas un modèle d’intégration par défaut actif. Avant tout appel, confirmez votre accès avec votre propre réponse de GET https://api.apihop.ai/v1/models.

text

ANTHROPIC_BASE_URL=https://api.apihop.ai/anthropic

Prérequis

Préparez d’abord une clé API RequestBeam valide. Elle sera écrite dans l’environnement local de votre shell. Ne l’incluez pas dans des dépôts, journaux ou captures d’écran.

Installer Claude Code

Sur macOS / Linux, utilisez l’installateur natif de Claude Code :

bash

curl -fsSL https://claude.ai/install.sh | bash

Si l’installateur indique ~/.local/bin/claude mais que claude est introuvable, ouvrez un nouveau terminal ou ajoutez ~/.local/bin à PATH.

Pour les anciens processus, le paquet npm reste disponible :

bash

npm install -g @anthropic-ai/claude-code

N’utilisez pas sudo npm install -g @anthropic-ai/claude-code ; cela peut causer des problèmes de permissions lors des mises à niveau suivantes.

Vérifiez la CLI après l’installation :

bash

claude --version
claude doctor

Sur Windows, Git Bash ou WSL est recommandé pour Claude Code. PowerShell peut aussi définir les variables d’environnement, mais leur persistance diffère selon le terminal.

Configurer les variables d’environnement

Les réglages temporaires concernent uniquement la session de terminal actuelle :

bash

export ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"
export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
export ANTHROPIC_MODEL="claude-sonnet-5-5"

macOS utilise zsh par défaut. Pour une configuration persistante, écrivez les variables dans ~/.zshrc, puis exécutez source ~/.zshrc pour les charger immédiatement dans le terminal actuel :

bash

printf '%s\n' \
  'export ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"' \
  'export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"' \
  'export ANTHROPIC_MODEL="claude-sonnet-5-5"' \
  >> ~/.zshrc

source ~/.zshrc

Sur Linux avec bash, écrivez les mêmes variables dans ~/.bashrc et exécutez source ~/.bashrc.

Réglages temporaires de Windows PowerShell :

powershell

$env:ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"
$env:ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
$env:ANTHROPIC_MODEL="claude-sonnet-5-5"

Persistance au niveau utilisateur dans PowerShell :

powershell

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_REQUESTBEAM_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.apihop.ai/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5-5", "User")

Ouvrez une nouvelle session PowerShell avant d’exécuter claude.

Fichier de paramètres

Comme alternative à la configuration du shell, créez ou modifiez ~/.claude/settings.json. Si le fichier existe déjà, fusionnez env et model avec le JSON existant sans remplacer les autres paramètres :

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_REQUESTBEAM_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.apihop.ai/anthropic",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  },
  "model": "claude-sonnet-5-5"
}

Modèles disponibles :

claude-fable-5
claude-fable-5-1
claude-opus-4-6
claude-opus-4-7
claude-opus-4-8
claude-opus-5
claude-opus-5-5
claude-sonnet-5
claude-sonnet-5-5

Utilisez GET https://api.apihop.ai/v1/models pour consulter les modèles actuellement accessibles à votre clé API.

Démarrer et tester

Redémarrez Claude Code après avoir défini les variables d’environnement, puis envoyez une consigne normale :

bash

claude "Reply exactly OK."

Vous pouvez aussi démarrer le mode interactif :

bash

claude

Au premier lancement, Claude Code peut demander un thème, une confirmation de sécurité, des réglages du terminal ou si le répertoire actuel est fiable. Suivez les indications du terminal.

Choisir un modèle

Définissez un modèle par défaut avec la variable d’environnement ou choisissez-en un pour une seule commande avec --model :

bash

claude --model claude-sonnet-5-5 "Review this PR"

Comportement de l’endpoint

Claude Code s’authentifie avec la clé API RequestBeam configurée. Le service accepte les deux formes d’authentification suivantes :

http

x-api-key: YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01

http

Authorization: Bearer YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01

Les réponses conservent le format natif JSON ou d’événements SSE d’Anthropic Messages. Elles ne sont pas converties au format OpenAI.

Dépannage

ANTHROPIC_BASE_URL doit être l’URL de base publique indiquée sur cette page suivie de /anthropic.
N’incluez pas les chemins d’endpoints dans ANTHROPIC_BASE_URL ; seule l’URL de base compatible Anthropic est nécessaire.
Après modification de ~/.zshrc sur macOS, exécutez source ~/.zshrc ou ouvrez un nouveau terminal avant de lancer Claude Code.
Si claude indique que la commande est introuvable, confirmez que le répertoire d’installation est dans PATH ; un emplacement courant est ~/.local/bin/claude.
Si claude doctor signale des variables manquantes, exécutez echo $ANTHROPIC_BASE_URL et echo $ANTHROPIC_MODEL dans le même terminal pour confirmer leur chargement.
Si vous recevez 401, confirmez que la clé API est valide.
Si le modèle est indisponible, confirmez que son nom figure dans la liste ci-dessus.
Redémarrez le processus Claude Code après modification des variables d’environnement.

POST https://api.apihop.ai/anthropic/v1/messages : endpoint compatible Anthropic Messages.