Aller au contenu
Ressources pour développeurs
Ressources pour développeurs

Claude Code

Installez Claude Code, connectez-le à RunAPI, choisissez un modèle et vérifiez la configuration.

Vue d'ensemble

Claude Code est un outil de codage agentique pour le terminal. Ce guide installe le CLI, oriente ses requêtes compatibles Anthropic vers RunAPI, sélectionne un modèle RunAPI et vérifie la connexion.

Avant de commencer

Installer

Utilisez le programme d’installation natif officiel sur macOS, Linux ou WSL, puis confirmez que la commande est disponible :

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

Pour Homebrew, WinGet et les exigences spécifiques à la plateforme, utilisez le guide d’installation officiel.

Configurer RunAPI

Pour un premier test, exportez l’URL de base, la clé API et le modèle dans le shell actuel :

SHELL
export ANTHROPIC_BASE_URL=https://runapi.ai
export ANTHROPIC_API_KEY=YOUR_RUNAPI_API_KEY
export ANTHROPIC_MODEL=YOUR_RUNAPI_MODEL_ID

Pour appliquer les valeurs à chaque session Claude Code de votre utilisateur, placez-les dans l’objet env de ~/.claude/settings.json :

JSON
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}

Ne placez pas la vraie clé dans .claude/settings.json, qui est destiné aux paramètres de projet pouvant être commités. Pour les portées de configuration et la priorité, consultez la référence des paramètres Claude Code.

Choisir un modèle

Remplacez YOUR_RUNAPI_MODEL_ID par l’identifiant exact du Catalogue de modèles. ANTHROPIC_BASE_URL modifie la destination des requêtes ; il ne sélectionne pas un modèle. Vous pouvez également démarrer une session avec claude --model YOUR_RUNAPI_MODEL_ID ou exécuter /model pendant une session.

Vérifier

Exécutez les vérifications d’installation et de configuration, puis envoyez une courte invite :

SHELL
claude --version
claude doctor
claude

Dans Claude Code, exécutez /status pour confirmer les paramètres chargés et le modèle actif. Une réponse normale à Describe this repository in one sentence. confirme que la connexion RunAPI fonctionne.

Résoudre les problèmes

  • claude est introuvable : rouvrez le terminal et suivez le dépannage officiel de l’installation.
  • Les paramètres ne se chargent pas : validez ~/.claude/settings.json avec claude doctor, puis utilisez /status pour inspecter les sources chargées.
  • L’authentification échoue : confirmez que ANTHROPIC_API_KEY contient une clé RunAPI active. Créez ou renouvelez des clés via le Guide d’authentification.
  • Le modèle est indisponible : copiez l’identifiant exact depuis le Catalogue de modèles, puis démarrez une nouvelle session. Les sessions reprises peuvent conserver leur modèle précédent.
  • Les requêtes utilisent un autre point de terminaison : ouvrez un nouveau terminal après avoir modifié les variables d’environnement et vérifiez qu’aucun paramètre Claude Code de priorité supérieure n’est présent.

Étapes suivantes

Consultez le Guide de démarrage rapide de l’API LLM pour le comportement du protocole et la Référence de l’API Anthropic Messages pour les champs de requête. Pour ajouter des outils RunAPI à Claude Code, poursuivez avec la Vue d’ensemble MCP.