spb/uqo_cours

1% ------------------------------------------------------------------------------2\section{Première session en quinze minutes}3\label{sec:premiere}4% ------------------------------------------------------------------------------56\begin{enbref}7Un dossier de TP, la commande \texttt{claude}, le mode plan, une première requête en lecture seule, puis les gestes qui reviennent tout le temps : \kbd{Maj}+\kbd{Tab} pour changer de mode, \kbd{Échap} pour interrompre, \texttt{@} pour désigner un fichier, \texttt{!} pour une commande shell, \texttt{/} pour les commandes, \texttt{\#} pour noter une règle. Une session annotée ligne par ligne, puis le tableau des raccourcis.8\end{enbref}910\subsection{Le dossier, puis la commande}1112Créez votre dossier de travail, mettez-y l'énoncé et le gabarit, ouvrez un terminal dedans et tapez \texttt{claude}. Rien de plus. L'invite qui apparaît attend votre première phrase ; en bas, une ligne d'état indique le mode de permission, le modèle et le dossier.1314\begin{terminal}[Ce que vous voyez au lancement (macOS ; identique ailleurs)]15\begin{Verbatim}[commandchars=§¡¿]16§tu¡$¿ mkdir -p ~/Documents/UQO/IMM1003/TP2_comparaison && cd $_17§tu¡$¿ cp ~/Downloads/enonce_TP2.pdf enonce.pdf && cp ~/Downloads/gabarit_TP2.xlsx gabarit.xlsx18§tu¡$¿ claude1920┌──────────────────────────────────────────────────────────────┐21│ §hi¡* Welcome to Claude Code!¿                                   │22│                                                              │23│   /help for help, /status for your current setup             │24│   cwd: /Users/vous/Documents/UQO/IMM1003/TP2_comparaison     │25└──────────────────────────────────────────────────────────────┘2627§gris¡Tips for getting started:¿28§gris¡ Run /init to create a CLAUDE.md file with instructions for Claude¿29§gris¡ Use Claude to help with file analysis, editing, bash commands and git¿3031§tu¡>¿ █32                                          §gris¡>> default mode · sonnet · TP2_comparaison¿33\end{Verbatim}34\end{terminal}3536\subsection{Passer en mode plan avant tout}3738Appuyez sur \kbd{Maj}+\kbd{Tab} : la ligne d'état passe de « default » à « accept edits » puis à \textbf{« plan mode »}. En mode plan, l'agent peut lire et réfléchir, mais ne peut rien écrire ni exécuter de commande qui modifie quelque chose \parencite{cc_iam}. C'est le bon état pour découvrir un dossier, et le premier réflexe à prendre. Vous pouvez aussi lancer directement \texttt{claude --permission-mode plan}.3940\subsection{Une session annotée}4142\begin{terminal}[Première session --- découverte du TP2 en lecture seule (extrait)]43\begin{Verbatim}[commandchars=§¡¿,numbers=left]44§tu¡> Lis @enonce.pdf et @gabarit.xlsx. Explique-moi la structure du classeur¿      §mk¡1¿45§tu¡  (feuilles, cellules d'entrée, cellules de résultat) et les conventions¿46§tu¡  de l'énoncé. Ne modifie rien.¿4748  §hi¡Read¿(enonce.pdf)                                                           §mk¡2¿49  §hi¡Read¿(gabarit.xlsx)50  §hi¡Bash¿(python3 -c "import openpyxl; wb=openpyxl.load_workbook('gabarit.xlsx'); …")51  §gris¡  Lecture seule : autorisée en mode plan sans question¿5253  Le classeur a quatre feuilles. §hi¡Accueil!D9¿ attend B (dernier chiffre du code54  permanent). §hi¡Donnees!B4:H9¿ contient cinq comparables (prix, date, superficie,55  terrain, âge, garage). §hi¡Grille!C12:G16¿ attend vos ajustements ; §hi¡Grille!H26¿56  est la valeur indiquée et §hi¡Dashboard¿ la lit. Conventions relevées dans57  l'énoncé : ajustements transactionnels d'abord, séquentiels ; seuils d'alerte58  15 % brut et 25 % net ; arrondi final au 5 000 $.59  §ok¡Je n'ai rien modifié.¿                                                          §mk¡3¿6061§tu¡> # Convention du cours : ajustements transactionnels séquentiels avant les¿        §mk¡4¿62§tu¡  physiques ; seuils 15 % brut / 25 % net ; arrondi au 5 000 $.¿63  §ok¡Saved to CLAUDE.md¿6465§tu¡> Propose un plan en cinq étapes pour compléter la grille. Indique ce que je¿      §mk¡5¿66§tu¡  dois écrire moi-même et ce que tu pourrais préparer. Deux colonnes : moi / toi.¿6768  Plan proposé69  1. §tu¡(moi)¿  ajustements transactionnels (conditions, financement, date)70  2. §tu¡(moi)¿  ajustements physiques (superficie, âge, garage, terrain)71  3. §hi¡(toi)¿  formules de total brut/net + drapeaux 15 %/25 % en Grille!I12:J1672  4. §hi¡(toi)¿  mise en forme conditionnelle et graphique du Dashboard73  5. §tu¡(moi)¿  réconciliation, arrondi, interprétation en deux phrases74  Vérification : changer Accueil!D9 (B=2 puis B=9) et comparer Grille!H26.75  §gris¡Voulez-vous sortir du mode plan et exécuter ? [y/n]¿                             §mk¡6¿7677§tu¡> n — je fais d'abord les étapes 1 et 2 dans Excel. /rename tp2-decouverte¿          §mk¡7¿78\end{Verbatim}79\end{terminal}8081\begin{description}[style=nextline,leftmargin=1.2em,itemsep=2pt]82  \item[\etape{1} La requête désigne les fichiers avec \texttt{@}.] Tapez \texttt{@} puis les premières lettres : une liste de fichiers du dossier s'affiche, \kbd{Tab} complète. Le fichier est alors lu en entier dans le contexte ; ne le faites que pour ceux dont vous avez besoin.83  \item[\etape{2} L'agent affiche chaque outil qu'il utilise.] \texttt{Read}, \texttt{Bash}, plus tard \texttt{Edit} et \texttt{Write}. En mode plan, les lectures passent sans question ; tout ce qui écrit serait refusé.84  \item[\etape{3} La restitution est votre premier contrôle.] Si l'agent a mal lu une convention, corrigez-le maintenant, avant qu'il ne construise dessus.85  \item[\etape{4} Le raccourci \texttt{\#} note une règle dans \texttt{CLAUDE.md}.] Tout ce qui commence par \texttt{\#} est ajouté au fichier d'instructions du dossier et sera relu à chaque session (chapitre~\ref{sec:claudemd}).86  \item[\etape{5} Un plan à deux colonnes.] Vous décidez ce qui est délégué ; ce qui porte le jugement reste à vous.87  \item[\etape{6} Sortir du mode plan est une décision explicite.] L'agent le demande ; vous pouvez refuser et continuer à explorer.88  \item[\etape{7} \texttt{/rename} nomme la session.] Vous la retrouverez avec \texttt{/resume} ou \texttt{claude --resume}, y compris demain.89\end{description}9091\subsection{Les gestes qui reviennent tout le temps}9293{\small\Needspace{9\baselineskip}94\begin{tabularx}{\textwidth}{L{3.6cm}X}95\caption{Raccourcis et préfixes essentiels en session interactive}\label{tab:raccourcis}\\96\rowcolor{uqoBleu} \hc{Geste} & \hc{Effet} \\97\endfirsthead98\captionsuite{Raccourcis et préfixes essentiels en session interactive}99\rowcolor{uqoBleu} \hc{Geste} & \hc{Effet} \\100\endhead101\suitepage{2}102\endfoot103\finTableau104\endlastfoot105\kbd{Maj}+\kbd{Tab} & Fait tourner le mode de permission : default, accept edits, plan (chapitre~\ref{sec:permissions}). \\106\rowcolor{uqoBgClair}107\kbd{Échap} & Interrompt l'agent en pleine action ; votre contexte est conservé, vous reformulez. \\108\kbd{Échap} \kbd{Échap} & Ouvre la liste des messages précédents pour revenir en arrière (\emph{rewind}) : restaurer la conversation, les fichiers, ou les deux \parencite{cc_checkpointing}. \\109\rowcolor{uqoBgClair}110\kbd{Ctrl}+\kbd{C} & Annule la saisie en cours ; deux fois de suite quitte Claude Code. \\111\texttt{@fichier} & Insère un fichier ou un dossier dans la requête (autocomplétion avec \kbd{Tab}). \\112\rowcolor{uqoBgClair}113\texttt{!commande} & Exécute directement une commande shell (\texttt{!ls}, \texttt{!python3 verif.py}) ; la sortie entre dans le contexte. \\114\texttt{/commande} & Commandes de Claude Code (\texttt{/help}, \texttt{/clear}, \texttt{/compact}, \texttt{/model}…) ; tapez \texttt{/} pour la liste, tableau~\ref{tab:slash}. \\115\rowcolor{uqoBgClair}116\texttt{\#texte} & Ajoute « texte » au fichier \texttt{CLAUDE.md} (mémoire persistante). \\117\kbd{\textbackslash} puis \kbd{Entrée} & Nouvelle ligne dans la requête sans l'envoyer (ou \kbd{Option}+\kbd{Entrée}, ou \kbd{Maj}+\kbd{Entrée} après \texttt{/terminal-setup}). \\118\rowcolor{uqoBgClair}119\kbd{Ctrl}+\kbd{V} & Colle une image du presse-papiers (capture d'écran, graphique). \\120\kbd{↑} / \kbd{↓} & Parcourt vos requêtes précédentes ; \kbd{Ctrl}+\kbd{R} cherche dans l'historique. \\121\rowcolor{uqoBgClair}122\kbd{Tab} & Complète un nom de fichier ou de commande. \\123\end{tabularx}124}125126\subsection{Les commandes qu'il faut connaître}127128Il en existe des dizaines ; celles-ci couvrent l'usage d'un étudiant. La liste complète, toujours à jour, s'obtient avec \texttt{/help} \parencite{cc_slash}.129130{\small\Needspace{9\baselineskip}131\begin{tabularx}{\textwidth}{L{3.6cm}X}132\caption{Commandes de session utiles (tapez \texttt{/help} pour la liste du jour)}\label{tab:slash}\\133\rowcolor{uqoBleu} \hc{Commande} & \hc{Ce qu'elle fait} \\134\endfirsthead135\captionsuite{Commandes de session utiles}136\rowcolor{uqoBleu} \hc{Commande} & \hc{Ce qu'elle fait} \\137\endhead138\suitepage{2}139\endfoot140\finTableau141\endlastfoot142\texttt{/help} & Liste des commandes et raccourcis de la version installée. \\143\rowcolor{uqoBgClair}144\texttt{/init} & Génère un premier \texttt{CLAUDE.md} après avoir exploré le dossier ; à relire et raccourcir (chapitre~\ref{sec:claudemd}). \\145\texttt{/memory} & Ouvre les fichiers de mémoire (\texttt{CLAUDE.md} du dossier, global, local) dans votre éditeur. \\146\rowcolor{uqoBgClair}147\texttt{/clear} & Vide le contexte : nouvelle conversation, même dossier. À faire entre deux tâches distinctes. \\148\texttt{/compact [consigne]} & Résume l'historique pour libérer du contexte ; la consigne dit ce qu'il faut garder (« conserve la liste des cellules modifiées et la valeur de $B$ »). \\149\rowcolor{uqoBgClair}150\texttt{/rewind} & Revient à un point de contrôle antérieur (conversation, fichiers, ou les deux). \\151\texttt{/resume}, \texttt{/rename} & Reprendre une session passée ; donner un nom à la session courante. \\152\rowcolor{uqoBgClair}153\texttt{/model} & Choisir le modèle (Sonnet par défaut ; Opus pour les tâches difficiles ; Haiku pour la vitesse), chapitre~\ref{sec:cout}. \\154\texttt{/permissions} & Voir et modifier les règles d'autorisation (chapitre~\ref{sec:permissions}). \\155\rowcolor{uqoBgClair}156\texttt{/output-style} & Activer le style \emph{Explanatory} ou \emph{Learning} (§\ref{sec:styles}). \\157\texttt{/cost}, \texttt{/usage} & Coût de la session (API) ; consommation des limites de l'abonnement. \\158\rowcolor{uqoBgClair}159\texttt{/context} & Montre ce qui occupe la fenêtre de contexte : fichiers, historique, \texttt{CLAUDE.md}, outils. \\160\texttt{/status}, \texttt{/doctor} & État du compte, du modèle, du dossier ; diagnostic de l'installation. \\161\rowcolor{uqoBgClair}162\texttt{/agents}, \texttt{/mcp}, \texttt{/hooks} & Gérer les sous-agents, les connecteurs et les hooks (chapitre~\ref{sec:personnaliser}). \\163\texttt{/export} & Exporte la conversation en texte : c'est votre \textbf{transcription} pour la déclaration d'outils. \\164\rowcolor{uqoBgClair}165\texttt{/bug} & Signale un problème à Anthropic avec le contexte de la session. \\166\end{tabularx}167}168169\begin{astuce}[Trois habitudes qui évitent 80\,\% des ennuis]170\textbf{Un dossier par TP} (l'agent ne voit que lui). \textbf{Mode plan d'abord} (rien n'est écrit tant que vous n'avez pas compris). \textbf{\texttt{/clear} entre deux tâches} (une conversation encombrée produit des réponses de moins en moins bonnes). Le reste de ce guide est du raffinement.171\end{astuce}172