% ------------------------------------------------------------------------------ \section{Installer Claude Code} \label{sec:installer} % ------------------------------------------------------------------------------ \begin{enbref} Dix minutes. Un compte Claude (Pro ou Max, ou une clé d'API), un terminal, une commande d'installation par système, puis \texttt{claude} pour se connecter. Ce chapitre couvre macOS, Windows et Linux, les extensions VS Code et JetBrains, la vérification (\texttt{claude doctor}), les mises à jour et les problèmes classiques du premier jour. \end{enbref} \subsection{Avant de commencer} \begin{enumerate}[label=\textbf{\arabic*.},leftmargin=2em] \item \textbf{Un compte.} Soit un abonnement Claude Pro ou Max sur \texttt{claude.ai} (recommandé : c'est le même compte que le clavardage), soit un compte Console Anthropic avec une clé d'API facturée à l'usage \parencite{cc_setup}. \item \textbf{Un terminal.} Sur macOS : l'application Terminal (dans Applications, Utilitaires) ou iTerm2. Sur Windows : Windows Terminal ou PowerShell. Sur Linux : n'importe lequel. \item \textbf{Git} (recommandé, pas obligatoire) : Claude Code s'en sert pour les points de restauration et pour versionner votre travail. Sur macOS il s'installe avec les outils en ligne de commande d'Apple ; sur Windows, installez \emph{Git for Windows}. \item \textbf{Un dossier de travail} dédié à votre TP (par exemple \texttt{Documents/UQO/IMM1003/TP2\_comparaison}), qui ne contient que l'énoncé, le gabarit et vos données. C'est là que vous lancerez l'agent. \end{enumerate} \begin{piege}[Ne lancez jamais Claude Code depuis votre dossier personnel] L'agent voit tout le dossier où il démarre, sous-dossiers compris. Lancé depuis \texttt{Documents} ou depuis la racine de votre compte, il aurait accès à vos courriels exportés, vos relevés, vos dossiers de stage. Un dossier par travail : c'est la règle numéro un, et elle vaut pour la Loi 25 autant que pour la qualité des réponses (moins de bruit dans le contexte). \end{piege} \subsection{macOS} Ouvrez Terminal et collez la commande d'installation officielle. Elle télécharge une version native (aucun Node.js requis) et l'ajoute à votre chemin \parencite{cc_setup}. \begin{terminal}[macOS --- installation native (recommandée)] \begin{Verbatim}[commandchars=§¡¿] §tu¡$¿ curl -fsSL https://claude.ai/install.sh | bash §co¡# ... téléchargement, puis :¿ §vok¡¿ §ok¡Claude Code installed¿ in ~/.local/bin/claude §co¡# Fermez et rouvrez Terminal (ou : source ~/.zshrc), puis vérifiez :¿ §tu¡$¿ claude --version 2.1.x (Claude Code) \end{Verbatim} \end{terminal} Si vous utilisez Homebrew, l'alternative équivalente est \texttt{brew install --cask claude-code}. Une troisième voie, plus ancienne, passe par Node.js : \texttt{npm install -g @anthropic-ai/claude-code} ; elle exige Node 18 ou plus récent et se met à jour moins facilement. Préférez l'installation native \parencite{cc_setup}. \subsection{Windows} Deux options. La plus simple aujourd'hui est l'installation native pour Windows, depuis PowerShell (pas besoin de droits d'administrateur) ; \emph{Git for Windows} est recommandé parce que Claude Code utilise son environnement pour exécuter des commandes. \begin{terminal}[Windows --- PowerShell] \begin{Verbatim}[commandchars=§¡¿] §tu¡PS>¿ irm https://claude.ai/install.ps1 | iex §co¡# ... puis rouvrez Windows Terminal :¿ §tu¡PS>¿ claude --version \end{Verbatim} \end{terminal} L'autre option, plus robuste pour tout ce qui touche Python et les outils Unix, est \textbf{WSL} (Windows Subsystem for Linux) : vous installez Ubuntu depuis le Microsoft Store, puis vous suivez les instructions Linux ci-dessous à l'intérieur d'Ubuntu. Vos fichiers Windows restent accessibles sous \texttt{/mnt/c/Users/VotreNom/...} \parencite{cc_setup}. \begin{astuce}[Windows : quel chemin vers mon dossier de TP ?] Dans l'Explorateur, ouvrez votre dossier de TP, faites un clic droit dans l'espace vide et choisissez « Ouvrir dans le terminal » : le terminal s'ouvre déjà au bon endroit. Tapez ensuite \texttt{claude}. Sous WSL, le même dossier s'appelle \texttt{/mnt/c/Users/VotreNom/Documents/UQO/...}. \end{astuce} \subsection{Linux} \begin{terminal}[Linux (Ubuntu, Debian, Fedora…) et WSL] \begin{Verbatim}[commandchars=§¡¿] §tu¡$¿ curl -fsSL https://claude.ai/install.sh | bash §tu¡$¿ source ~/.bashrc §co¡# ou ~/.zshrc selon votre shell¿ §tu¡$¿ claude --version \end{Verbatim} \end{terminal} \subsection{Première connexion} Placez-vous dans votre dossier de TP et lancez \texttt{claude}. Au premier démarrage, l'outil vous demande un thème de couleurs, puis une méthode de connexion : choisissez « Claude account with subscription » si vous avez Pro ou Max ; votre navigateur s'ouvre pour autoriser l'accès. Avec une clé d'API, choisissez « Anthropic Console account » \parencite{cc_setup}. \begin{terminal}[Première connexion] \begin{Verbatim}[commandchars=§¡¿] §tu¡$¿ cd ~/Documents/UQO/IMM1003/TP2_comparaison §tu¡$¿ claude §hi¡Welcome to Claude Code!¿ Select login method: §tu¡› 1. Claude account with subscription¿ §co¡← Pro ou Max¿ 2. Anthropic Console account §co¡← clé d'API, facturation à l'usage¿ §co¡# le navigateur s'ouvre, vous autorisez, puis :¿ §ok¡Login successful.¿ Press Enter to continue… \end{Verbatim} \end{terminal} Vous pouvez changer de compte plus tard avec \texttt{/login} et \texttt{/logout}. L'outil demande ensuite si vous faites confiance aux fichiers de ce dossier (\emph{trust this folder}) : répondez oui pour votre dossier de TP, jamais pour un dossier téléchargé dont vous ne connaissez pas le contenu (le chapitre~\ref{sec:permissions} explique pourquoi). \subsection{Vérifier, mettre à jour, désinstaller} \begin{terminal}[Santé de l'installation] \begin{Verbatim}[commandchars=§¡¿] §tu¡$¿ claude doctor §co¡# diagnostic : version, chemin, mise à jour, terminal¿ §tu¡$¿ claude update §co¡# mise à jour manuelle (elle est automatique par défaut)¿ §tu¡$¿ which claude §co¡# où est le programme (macOS/Linux)¿ /Users/vous/.local/bin/claude \end{Verbatim} \end{terminal} Dans une session, \texttt{/doctor} et \texttt{/status} donnent les mêmes informations, plus le modèle actif, le compte connecté et le dossier de travail. Pour désinstaller la version native, supprimez le fichier \texttt{\textasciitilde/.local/bin/claude} et le dossier \texttt{\textasciitilde/.claude} (celui-ci contient vos réglages et l'historique de vos sessions : sauvegardez-le si vous y tenez). \subsection{Dans VS Code ou JetBrains} Installez l'extension « Claude Code » depuis la boutique d'extensions de VS Code (ou de PyCharm). Elle détecte l'installation en ligne de commande et ouvre Claude Code dans un panneau latéral ; les modifications proposées s'affichent en comparaison avant/après dans l'éditeur, ce qui est très confortable pour relire un script \parencite{cc_setup}. Si vous ouvrez un terminal \emph{intégré} à VS Code et tapez \texttt{claude}, l'agent détecte aussi l'éditeur et peut lire le fichier ouvert et votre sélection. \subsection{Régler son terminal} Deux réglages rendent la vie plus douce \parencite{cc_interactive} : \begin{itemize} \item \textbf{Retour à la ligne dans une requête.} Par défaut, \kbd{Entrée} envoie. Pour écrire sur plusieurs lignes, tapez \kbd{\textbackslash} puis \kbd{Entrée}, ou \kbd{Option}+\kbd{Entrée} sur macOS. La commande \texttt{/terminal-setup} configure \kbd{Maj}+\kbd{Entrée} dans iTerm2, VS Code et Windows Terminal. \item \textbf{Coller une image.} Une capture d'écran d'un graphique ou d'un message d'erreur se colle avec \kbd{Ctrl}+\kbd{V} (oui, Ctrl, même sur macOS). Vous pouvez aussi glisser un fichier (PDF, PNG, CSV) dans la fenêtre : son chemin s'insère. \end{itemize} \subsection{Problèmes du premier jour} {\small\Needspace{9\baselineskip} \begin{tabularx}{\textwidth}{R{4.2cm}X} \caption{Problèmes d'installation courants et leur remède}\label{tab:install-pb}\\ \rowcolor{uqoRouge} \hc{Symptôme} & \hc{Remède} \\ \endfirsthead \captionsuite{Problèmes d'installation courants et leur remède} \rowcolor{uqoRouge} \hc{Symptôme} & \hc{Remède} \\ \endhead \suitepage{2} \endfoot \finTableau \endlastfoot \texttt{claude: command not found} juste après l'installation & Le terminal n'a pas relu son chemin. Fermez-le et rouvrez-le, ou tapez \texttt{source \textasciitilde/.zshrc} (macOS) ou \texttt{source \textasciitilde/.bashrc} (Linux). Sur Windows, rouvrez Windows Terminal. \\ \rowcolor{uqoBgClair} La connexion tourne en boucle dans le navigateur & Copiez l'adresse affichée dans le terminal dans un autre navigateur ; vérifiez que vous êtes connecté au bon compte Claude ; \texttt{/logout} puis \texttt{/login}. \\ « Node version too old » (installation npm) & Vous avez utilisé l'ancienne méthode. Désinstallez (\texttt{npm uninstall -g @anthropic-ai/claude-code}) et refaites l'installation native. \\ \rowcolor{uqoBgClair} Sur Windows, les commandes Python ne marchent pas & Installez Python depuis \texttt{python.org} en cochant « Add to PATH », ou passez sous WSL. \\ Caractères bizarres, cadres cassés & Votre police de terminal n'a pas les symboles ; installez une police « Nerd Font » ou changez de terminal (Windows Terminal, iTerm2). \\ \rowcolor{uqoBgClair} « Permission denied » sur \texttt{install.sh} & Vous êtes sur un ordinateur géré (laboratoire UQO). Utilisez la version Web (\texttt{claude.ai/code}) ou votre ordinateur personnel. \\ \end{tabularx} } Le chapitre~\ref{sec:depannage} traite les problèmes qui surviennent ensuite, en cours de travail.