Installer Claude Code, Codex et Gemini CLI
Installez Claude Code, Codex ou Gemini CLI avec npm, connectez le client choisi à Code By AI, puis envoyez une requête test pour vérifier la configuration.
1. Vérifier Node.js et npm
Utilisez une version LTS actuelle de Node.js. Avant de télécharger quoi que ce soit, vérifiez l'environnement :
1 node --version2 npm --version
Si l'une de ces commandes est absente, installez d'abord Node.js. npm est fourni avec Node.js.
macOS avec Homebrew
1 brew install node
Ubuntu / Debian
1 sudo apt update2 sudo apt install nodejs npm
Windows
Téléchargez l'installateur LTS actuel sur nodejs.org et laissez activée l'option qui ajoute Node.js au PATH. Après l'installation, ouvrez un nouveau terminal et relancez les vérifications de version.
Si vous gérez plusieurs versions de Node.js, utilisez votre gestionnaire de versions habituel plutôt que de modifier l'installation système.
2. Installer le client dont vous avez besoin
N'installez que les outils que vous utilisez réellement.
Claude Code
1 npm install -g @anthropic-ai/claude-code
Codex
1 npm install -g @openai/codex
Gemini CLI
1 npm install -g @google/gemini-cli
Vérifiez l'installation et la présence du CLI dans votre PATH :
1 claude --version2 codex --version3 gemini --version
Effectuez uniquement les vérifications des clients installés. Un numéro de version confirme l'installation du paquet, mais pas encore le fonctionnement de la connexion API.
3. Configurer Code By AI
Créez une clé dans votre tableau de bord Code By AI, puis pointez le client vers la passerelle. Ne placez pas cette clé dans le contrôle de version et évitez autant que possible de la laisser dans l'historique du shell.
Claude Code nécessite deux variables : l'endpoint et le token.
macOS / Linux (Bash / Zsh)
1 export ANTHROPIC_BASE_URL="https://www.codebyai.net/api/agent"2 export ANTHROPIC_AUTH_TOKEN="sk-proj-xxxx"
Windows PowerShell
1 $env:ANTHROPIC_BASE_URL = "https://www.codebyai.net/api/agent"2 $env:ANTHROPIC_AUTH_TOKEN = "sk-proj-xxxx"
Windows CMD
1 set "ANTHROPIC_BASE_URL=https://www.codebyai.net/api/agent"2 set "ANTHROPIC_AUTH_TOKEN=sk-proj-xxxx"
Choisissez les commandes adaptées à votre terminal et remplacez sk-proj-xxxx par votre vraie clé. Ces variables ne s'appliquent qu'au terminal actuel ; effectuez le test ci-dessous dans la même fenêtre. Pour les conserver, ajoutez les lignes export à ~/.zshrc ou ~/.bashrc sous macOS / Linux, ou suivez les étapes de configuration Windows. Si vous utilisez ~/.claude/settings.json, suivez l'exemple de configuration JSON et placez les variables dans l'objet env ; n'y collez pas de commandes shell.
Les autres clients utilisent d'autres fichiers de configuration et d'autres noms de variables :
Si vous ne savez pas quelle variable mettre dans quel fichier, consultez la référence des variables d'environnement. Elle contient des exemples pour le shell, settings.json, VS Code, TypeScript, Python, YAML, TOML, INI et .env.
4. Exécuter la première requête
Pour Claude Code, utilisez le mode print afin que la commande se termine après la réponse :
1 claude -p "Reply with exactly: setup ok"
Une réponse setup ok confirme trois choses : le CLI est installé, la passerelle accepte votre clé et le modèle répond. Si la commande bloque ou renvoie une erreur d'authentification, effectuez les vérifications ci-dessous plutôt que de réinstaller le CLI.
Dépannage
node: command not found ou npm: command not found. Node.js n'est pas installé ou votre terminal n'a pas rechargé son PATH. Installez Node.js, fermez le terminal et réessayez.
claude: command not found après une installation npm globale. Vérifiez où npm place les exécutables globaux :
1 npm prefix -g
Ajoutez le répertoire des exécutables globaux à votre PATH, où {prefix} désigne le répertoire affiché par npm prefix -g :
- macOS / Linux : ajoutez
{prefix}/bin. - Windows : ajoutez directement
{prefix}, sans ajouterbin.
Après la modification du PATH, ouvrez un nouveau terminal et relancez claude --version. Sous macOS et Linux, un gestionnaire de versions comme nvm est généralement préférable à l'installation de paquets globaux avec sudo.
EACCES ou erreurs de permission pendant npm install -g. N'utilisez pas sudo en premier. Utilisez un gestionnaire de versions de Node.js ou un préfixe global npm accessible en écriture par votre utilisateur.
401, invalid api key ou une erreur d'authentification. Vérifiez que ANTHROPIC_AUTH_TOKEN contient votre clé Code By AI et que ANTHROPIC_API_KEY n'est pas aussi défini. Ces deux variables utilisent des en-têtes différents ; ne définissez que l'une d'elles.
Les requêtes vont chez Anthropic au lieu de Code By AI. Vérifiez que ANTHROPIC_BASE_URL vaut https://www.codebyai.net/api/agent et qu'il est défini dans l'environnement qui lance le CLI. Le panneau de l'extension VS Code nécessite claudeCode.environmentVariables, pas seulement un export dans le shell.
Les requêtes longues expirent. Vérifiez la durée et les journaux de la passerelle. Le streaming Anthropic Messages dispose de délais distincts pour le démarrage, l’inactivité et la durée totale ; les requêtes sans streaming conservent une limite totale de 295 secondes. Augmenter API_TIMEOUT_MS ne prolonge pas ces délais. Si l’échec est immédiat, vérifiez l’endpoint et la clé API.
Une modification de configuration n'a aucun effet. Redémarrez le CLI ou exécutez Developer: Reload Window dans VS Code. Les variables d'environnement sont lues au démarrage du processus.
Étapes suivantes
- Référence des variables d'environnement Claude Code
- Guide de configuration de Claude Code
- Guide de configuration de Codex
- Guide de configuration de Gemini CLI
- Prix des modèles et des tokens
- Démarrage rapide de l'API pour un script ou un SDK
Une fois le test réussi, comparez les tarifs de Claude Code et choisissez le modèle adapté à votre charge de travail.