Préparer son poste de développement

1. Ouvrir un terminal

   Sur Mac : dans le Finder, ouvrez le dossier /Applications/Utilitaires, puis Terminal ; ou cherchez « Terminal » dans le Launchpad.
   Sous Windows : menu Démarrer, cherchez « PowerShell », ou ouvrez le Terminal Windows.
   Ce qu'on voit : une fenêtre avec une ligne d'invite, où le curseur attend une commande.

2. Installer git

   git garde l'historique de chaque fichier d'un projet ; un dossier suivi par git s'appelle un dépôt.

   MacCopier

   xcode-select --install

   Windows, PowerShellCopier

   winget install --id Git.Git -e --source winget

   Sur Mac, Apple fournit git avec ses outils de ligne de commande ; Homebrew l'installe aussi (brew install git).
   Ce qu'on voit : git --version affiche un numéro de version. La dernière publiée est la 2.56.0 ; sous Windows, Git for Windows 2.56.0(2), du 5 octobre 2026.
   À vérifier : donnez-lui votre nom et votre adresse, qu'il inscrit dans chaque version enregistrée.

   Mac et WindowsCopier

   git config --global user.name "Prénom Nom"
   git config --global user.email prenom@entreprise.fr

3. Installer uv, puis Python

   uv installe Python et, pour chaque projet, ses bibliothèques, c'est-à-dire le code écrit par d'autres que votre programme utilise : le SDK d'OpenAI, celui d'Anthropic, de Mistral.

   MacCopier

   curl -LsSf https://astral.sh/uv/install.sh | sh

   Windows, PowerShellCopier

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

   Autres voies : brew install uv sur Mac, winget install --id=astral-sh.uv -e sous Windows.
   Fermez et rouvrez le terminal, puis installez Python :

   Mac et WindowsCopier

   uv python install

   Ce qu'on voit : uv --version affiche uv 0.12.23 ou plus récent (version du 3 octobre 2026) ; uv python install installe la dernière version stable de Python. Sur python.org, c'est la 3.14.8, du 30 septembre 2026.
   À vérifier : la commande télécharge un script et l'exécute avec vos droits. Pour le lire avant, remplacez | sh par | less sur Mac, et | iex par | more sous Windows.

4. Installer un éditeur : VS Code et son extension Python

   Sur Mac : téléchargez VS Code sur code.visualstudio.com, ouvrez le fichier .dmg, glissez Visual Studio Code dans Applications. Puis, dans VS Code, ouvrez la palette de commandes (Cmd+Maj+P) et lancez Shell Command: Install 'code' command in PATH, pour ouvrir un dossier depuis le terminal.
   Sous Windows : téléchargez l'installateur « User Setup », lancez-le ; il ajoute la commande code au terminal.
   Puis, dans la vue Extensions de VS Code, installez l'extension Python de Microsoft ; elle installe avec elle Pylance, Python Debugger et Python Environments.
   Ce qu'on voit : code --version affiche 1.141 ou plus récent (version du 7 octobre 2026). Le compte n'est pas nécessaire : les fonctions d'IA de l'éditeur sont facultatives.

5. Créer un projet

   Un projet est un dossier qui a son propre Python et ses propres bibliothèques, rangés dans un environnement, le sous-dossier .venv.

   Mac et WindowsCopier

   uv init essai-ia
   cd essai-ia
   uv add openai python-dotenv
   uv run essai-ia
   code .

   Remplacez openai par anthropic ou mistralai selon l'éditeur choisi.
   Ce qu'on voit : uv init crée un dépôt git, un fichier .gitignore, .python-version, pyproject.toml, README.md et un dossier src ; au premier lancement, uv ajoute .venv et uv.lock. uv run essai-ia affiche Hello from essai-ia!, et VS Code s'ouvre sur le dossier.
   À vérifier : VS Code doit utiliser le Python du projet : palette de commandes, Python: Select Interpreter, puis celui de .venv.

6. Créer une clé d'API

   Une clé par projet, et une par usage (essai, production) : Anthropic le recommande, et une clé perdue ne coupe alors qu'un seul usage. Les consoles des éditeurs n'ont pas de libellés français : les chemins sont donnés en anglais, tels qu'ils s'affichent.
   Plateforme d'OpenAI (platform.openai.com)SettingsOrganizationAPI keysEn anglais : Settings › Organization › API keys
   Console de Claude (platform.claude.com)SettingsAPI keysCreate keyEn anglais : Settings › API keys › Create keyLa clé commence par sk-ant- et ne s'affiche qu'une fois : copiez-la tout de suite.
   Mistral Studio (console.mistral.ai)API KeysCreate new keyEn anglais : API Keys › Create new keyLa clé complète ne s'affiche qu'une fois : copiez-la tout de suite.
   Ce qu'on voit : la clé, une longue suite de caractères, affichée une seule fois chez Anthropic et chez Mistral.
   À vérifier : donnez-lui une date d'expiration quand la console le propose, et remplacez-la régulièrement : Anthropic cite l'exemple de tous les 90 jours.

7. Ranger la clé hors du code

   Dans le dossier du projet, créez un fichier nommé .env, avec une ligne : le nom de la variable, le signe égal, la clé. Le .gitignore écrit par uv n'exclut pas ce fichier : ajoutez-le.

   MacCopier

   echo 'OPENAI_API_KEY=collez-la-clé-ici' > .env
   echo '.env' >> .gitignore

   Windows, PowerShellCopier

   Set-Content .env 'OPENAI_API_KEY=collez-la-clé-ici'
   Add-Content .gitignore '.env'

   Les noms attendus : OPENAI_API_KEY, ANTHROPIC_API_KEY, MISTRAL_API_KEY.
   Puis, pour vérifier que le programme la lit, un fichier verifier_cle.py à la racine du projet :

   verifier_cle.pyCopier

   import os
   from dotenv import load_dotenv
   
   load_dotenv()  # lit .env, sans remplacer une variable déjà définie
   print("clé chargée" if os.getenv("OPENAI_API_KEY") else "clé absente")

   Mac et WindowsCopier

   uv run verifier_cle.py

   

   Ce qu'on voit : clé chargée, jamais la clé elle-même. git check-ignore .env affiche .env : git ne l'enregistrera pas.
   À vérifier : aucune clé dans une page web ni dans une application mobile : quiconque l'ouvre peut la lire. Les appels passent par votre propre serveur.

8. Plafonner la dépense

   Avant le premier appel, chez chaque éditeur utilisé :
   Plateforme d'OpenAI (platform.openai.com)Organization limitsSpendEdit spend limitMonthly spend limitEnforce a hard limitSaveEn anglais : Organization limits › Spend › Edit spend limit › Monthly spend limit › Enforce a hard limit › SaveLes alertes de dépense préviennent sans rien bloquer. Le plafond fait échouer les appels (erreur 429), avec un léger décalage : la dépense peut le dépasser un peu.
   Console de Claude (platform.claude.com)SettingsBillingSpend limitsAdjust limitEn anglais : Settings › Billing › Spend limits › Adjust limit
   Console d'administration de Mistral (admin.mistral.ai)AdministrationWorkspacesespace de travailSettingsMonthly spending limitSaveEn anglais : Administration › Workspaces › espace de travail › Settings › Monthly spending limit › SaveAtteint, le plafond suspend l'API de l'espace de travail jusqu'au mois suivant.
   Ce qu'on voit : le plafond affiché dans la console, en dollars ou en euros par mois.
   À vérifier : chez Mistral, aucun plafond n'existe tant que vous n'en fixez pas ; chez OpenAI, une alerte prévient sans rien bloquer.

Dans le terminal, depuis le dossier du projet. Chaque ligne cochée est une installation vérifiée.

• git --version affiche un numéro de version
• uv --version affiche 0.12.23 ou plus récent
• uv run python --version affiche Python 3.14 ou plus récentle Python du projet, pas celui du système
• code --version affiche 1.141 ou plus récent
• git check-ignore .env affiche .envla clé ne partira pas dans le dépôt
• uv run verifier_cle.py affiche « clé chargée »
• Un plafond de dépense est fixé chez chaque éditeur utilisé