Installer Claude Code et réussir un premier lancement sûr

Préparer le premier projet

Prévoyez un terminal, un petit projet Git que vous pouvez modifier et, idéalement, un git status propre. L'authentification officielle exige un compte Claude ou Console pris en charge ; un gateway suit un chemin de provider séparé. Ne placez jamais les clés dans le code, les captures ou l'historique du shell.

Native Install pour macOS, Linux et WSL

Anthropic recommande Native Install :

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

Cette étape installe le client uniquement. Elle ne remplace ni le login navigateur ni la configuration d'un provider; consultez la documentation actuelle pour les autres méthodes et dépendances.

Installation Windows correcte

Dans PowerShell :

irm https://claude.ai/install.ps1 | iex

Dans CMD :

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Sur Windows natif, Git for Windows est recommandé afin que Claude Code utilise Bash. Dans WSL, il n'est pas requis : installez la version Linux et gardez les projets dans le système de fichiers WSL lorsque possible.

Vérifier le client et le login

Après avoir ouvert un nouveau terminal :

claude --version
claude auth status

Lancez ensuite claude et terminez le flux navigateur officiel. Pour changer de compte, utilisez /login dans la session. Ne mettez pas une API Key dans un prompt normal ni dans le dépôt.

Configurer un gateway tiers

Un gateway requiert API Key, Model ID pris en charge et Base URL exacte. Avec BetterToken, suivez le guide actuel et utilisez la Base URL Anthropic-compatible https://bettertoken.ai. Elle n'est pas l'URL HTTP Messages brute : le client ajoute le chemin de protocole. Testez une petite requête après une modification, sans changer clé, modèle et URL à la fois.

Démarrer en lecture seule

cd path/to/test-project
git status
claude --permission-mode plan

Demandez d'abord : « Explique la structure, le point d'entrée et la commande de lancement. Ne modifie aucun fichier et n'exécute pas de commande réseau. » Plan mode explore et prépare un plan sans modifier les sources.

Première modification réversible

Demandez ensuite une seule limite de fichier :

Ajoute à README.md une courte section de développement local. Modifie seulement README.md, n'installe rien, n'utilise pas le réseau et ne committe pas.

Après approbation, vérifiez :

git diff -- README.md

Contrôlez le périmètre, le contenu, les secrets et tout changement inattendu de configuration ou dépendance.

Modes de permission et limites de sécurité

default lit sans demander puis demande avant édition ou commande. plan analyse sans modifier les sources. acceptEdits accepte automatiquement les éditions et opérations courantes; auto est une research preview avec contrôles de fond. bypassPermissions est réservé à un conteneur ou une VM isolés. Pour le premier run, gardez default ou plan.

Vérifier le résultat et l'API

Le premier run est bon si le bon dossier est ouvert, si login ou requête provider réussit, si seule la fichier autorisée change et si le diff est compréhensible. Avec BetterToken, vérifiez aussi modèle, statut et tokens input/output/cache dans Dashboard et Usage History. Cela confirme le chemin API, pas les droits Chat ou Cowork.

Diagnostiquer dans le bon ordre

Si claude est introuvable, rouvrez le terminal et suivez l'aide d'installation officielle au lieu d'une ancienne commande npm. Pour un échec login, distinguez login Claude, Console/API et gateway. Pour un provider, contrôlez d'abord la clé, puis Base URL, puis Model ID. Si Claude propose trop de changements, refusez, repassez en Plan mode et nommez un seul fichier autorisé, sans réseau ni commit.

Suite et sources

Après un README propre, passez à un test ou un petit correctif. Augmentez le périmètre et l'autonomie séparément : les déploiements, APIs et systèmes distants ne sont pas réversibles comme une édition locale.

Sources

• Claude Code installation
• Claude Code quickstart
• Claude Code permission modes
• Claude Code CLI reference
• BetterToken Claude Code