Free Claude Code - Guide Complet d'Installation et d'Utilisation

IMPORTANT : Ce guide est un "pense-bête" exhaustif créé après une session d'installation complète sur macOS Sequoia avec VSCode. Il contient toutes les subtilités, nuances et décisions techniques prises lors de l'installation et sert de référence complète pour l'utilisation de Free Claude Code.

Instructions par Système d'Exploitation

Windows 10/11 Enterprise

Particularités : Les environnements d'entreprise imposent souvent des restrictions. Cela inclut le proxy, l'antivirus, et les politiques de groupe. Une configuration spécifique est nécessaire.

Installation de uv (PowerShell en tant qu'administrateur) :

irm https://astral.sh/uv/install.ps1 | iex
uv self update
which python && python --version || uv python install 3.14

Configuration du proxy d'entreprise : Si votre entreprise impose un proxy sortant, éditez le fichier .env :

NVIDIA_NIM_PROXY="http://utilisateur:motdepasse@proxy-entreprise:8080"

Cloner le dépôt (PowerShell) :

cd $env:USERPROFILE\Projets
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
Copy-Item .env.example .env

Lancer le proxy et Claude Code (deux terminaux PowerShell) :

# Terminal1
cd $env:USERPROFILE\Projets\free-claude-code
uv run uvicorn server:app --host 0.0.0.0 --port 8082

# Terminal2
$env:ANTHROPIC_AUTH_TOKEN="freecc"
$env:ANTHROPIC_BASE_URL="http://localhost:8082"
claude

# En une seule commande (PowerShell) - Lance le proxy en arrière-plan puis Claude Code
cd $env:USERPROFILE\Projets\free-claude-code
Start-Process powershell -ArgumentList "-NoExit", "-Command", "uv run uvicorn server:app --host 0.0.0.0 --port 8082" -WindowStyle Minimized
Start-Sleep -Seconds 3
$env:ANTHROPIC_AUTH_TOKEN="freecc"; $env:ANTHROPIC_BASE_URL="http://localhost:8082"; claude

⚠️ Notes spécifiques Windows Enterprise :

⚠️ Note technique PowerShell : Nous utilisons Start-Process plutôt que Start-Job car Start-Job crée une session PowerShell isolée qui n'hérite pas du PATH utilisateur, ce qui peut empêcher uv d'être trouvé. Start-Process lance le proxy dans une nouvelle fenêtre minimisée visible dans la barre des tâches.
Ajoutez uv au PATH manuellement si nécessaire : %USERPROFILE%\.cargo\bin ou %USERPROFILE%\.local\bin
Désactivez temporairement l'antivirus si le téléchargement de Python 3.14 échoue
Les dossiers avec espaces peuvent poser problème : préférez $env:USERPROFILE\Projets à $env:USERPROFILE\Mon Nom\Projets

macOS (Sequoia et versions antérieures)

Particularités : macOS est le système le plus simple pour ce projet. Homebrew est recommandé pour les dépendances.

Installation de uv (Terminal zsh/bash) :

curl -LsSf https://astral.sh/uv/install.sh | sh
uv self update
which python && python --version || uv python install 3.14

Cloner le dépôt :

cd $HOME/Projets
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
cp .env.example .env

Lancer le proxy et Claude Code :

# Terminal1
cd $HOME/Projets/free-claude-code
uv run uvicorn server:app --host 0.0.0.0 --port 8082

# Terminal2
ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude

# En une seule commande (lance le proxy en arrière-plan puis Claude Code)
cd $HOME/Projets/free-claude-code && uv run uvicorn server:app --host 0.0.0.0 --port 8082 & sleep 3 && ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude

⚠️ Notes spécifiques macOS :

Si vous utilisez un Mac avec puce Apple Silicon (M1/M2/M3/M4), Python 3.14 s'installera en version aarch64 (natif)
Les permissions Gatekeeper peuvent bloquer l'exécution : allez dans Préférences > Sécurité pour autoriser
Pour VSCode, l'extension utilise les variables d'environnement configurées dans settings.json

Linux (Ubuntu/Debian/Fedora/Arch)

Particularités : Linux offre la meilleure compatibilité. Aucune restriction système majeure.

Installation de uv (Terminal bash/zsh) :

curl -LsSf https://astral.sh/uv/install.sh | sh
uv self update
which python && python --version || uv python install 3.14

Cloner le dépôt :

cd ~/Projets
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
cp .env.example .env

Lancer le proxy et Claude Code :

# Terminal1
cd ~/Projets/free-claude-code
uv run uvicorn server:app --host 0.0.0.0 --port 8082

# Terminal2
ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude

# En une seule commande (lance le proxy en arrière-plan puis Claude Code)
cd ~/Projets/free-claude-code && uv run uvicorn server:app --host 0.0.0.0 --port 8082 & sleep 3 && ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude

⚠️ Notes spécifiques Linux :

Pour les serveurs sans GUI, utilisez tmux ou screen pour laisser le proxy tourner en arrière-plan :

tmux new -s proxy
uv run uvicorn server:app --host 0.0.0.0 --port 8082
# Ctrl+B puis D pour détacher
# tmux attach -t proxy pour revenir

Si vous utilisez firewalld (Fedora/RHEL) ou ufw (Ubuntu), ouvrez le port 8082 :

sudo ufw allow 8082/tcp
# ou
sudo firewall-cmd --permanent --add-port=8082/tcp && sudo firewall-cmd --reload

L'intégration VSCode fonctionne de la même manière que sur macOS

Qu'est-ce que Free Claude Code ?

Free Claude Code (dépôt : Alishahryar1/free-claude-code) est un proxy. Il redirige les appels API d'Anthropic vers des providers gratuits ou personnels, notamment NVIDIA NIM. C'est un projet open-source. Il est très utilisé et performant.

Ce que ça fait :

Intercepte les requêtes que Claude Code envoie normalement aux serveurs d'Anthropic
Les redirige vers NVIDIA NIM (ou OpenRouter, DeepSeek, LM Studio, etc.)
Permet d'utiliser Claude Code CLI avec des modèles gratuits ou personnels

Ce que ça N'EST PAS :

Ce n'est pas une version crackée de Claude Code
Ce n'est pas un remplacement des modèles Claude d'Anthropic
Les "tiers" Opus/Sonnet/Haiku de Claude Code sont routés vers d'autres modèles (GLM-4.7, Kimi K2, etc.)

Architecture et Fonctionnement

┌─────────────────┐         ┌──────────────────────┐         ┌─────────────────┐
│  Claude Code    │         │  Free Claude Code    │         │ Provider        │
│  CLI ou VSCode  │────────>│  Proxy (port 8082)   │────────>│ (OpenRouter,    │
│                 │         │                      │         │  NVIDIA NIM,    │
└─────────────────┘         └──────────────────────┘         │  Local, etc.)   │
                                                             └─────────────────┘

Flux de données :

Claude Code envoie une requête API Anthropic (format Messages API)
Free Claude Code (proxy local) intercepte la requête sur http://localhost:8082
Le proxy traduit la requête au format attendu par le provider
Le provider (OpenRouter, NVIDIA NIM, etc.) traite la requête et renvoie la réponse
Le proxy reformate la réponse au format Anthropic

Points subtils à comprendre :

1. Le concept de "Proxy Sortant" (NVIDIA_NIM_PROXY)

NVIDIA_NIM_PROXY=""

Cette option sert à ajouter un proxy intermédiaire entre Free Claude Code et NVIDIA NIM
Exemple : Si vous êtes en entreprise avec un proxy sortant http://proxy:8080
Usage personnel à la maison : Laissez vide
Ce n'est PAS un double proxy entre Claude Code et Free Claude Code (ils sont sur la même machine)

2. Le routage Opus/Sonnet/Haiku

Claude Code demande des modèles par "tiers" (Opus = complexe, Sonnet = équilibré, Haiku = rapide). Ces tiers sont virtuels dans ce contexte. Ils sont routés vers des vrais modèles. C'est une particularité unique du projet.

MODEL_OPUS → Normalement pour tâches complexes (ex: Kimi K2)
MODEL_SONNET → Équilibré (ex: GLM-4.7)
MODEL_HAIKU → Rapide (ex: MiniMax M1)
MODEL → Fallback si les autres sont vides

Emplacement du Projet

Dossier du projet Free Claude Code :

$HOME/Projets/free-claude-code

Dossier de ce guide :

$HOME/Projets/free-claude-code-guide

Pré-requis et Installation

Étape 1 : Installer uv (gestionnaire de paquets Python moderne)

uv est un outil équivalent à pip mais beaucoup plus rapide. Il gère aussi les versions de Python. Il est recommandé de l'utiliser pour ce projet. C'est un outil moderne, performant et très rapide.

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

Vérifier l'installation :

which uv
# Devrait afficher : $HOME/.local/bin/uv

Étape 2 : Installer Python 3.14

Free Claude Code nécessite Python 3.14 (version spécifiée dans le projet).

uv python install 3.14

Étape 3 : Cloner le dépôt

cd $HOME/Projets
git clone https://github.com/Alishahryar1/free-claude-code.git

Étape 4 : Installer les dépendances

cd $HOME/Projets/free-claude-code
uv sync

Ce que cette commande fait :

Crée un environnement virtuel Python dans .venv
Installe toutes les dépendances listées dans pyproject.toml
Les dépendances incluent : FastAPI, httpx, OpenAI, etc.

Configuration Détaillée

Le fichier `.env`

Le fichier .env contient toute la configuration. Il est situé à :

$HOME/Projets/free-claude-code/.env

1. Choix du Provider (OBLIGATOIRE)

Free Claude Code supporte 6 providers. OpenRouter est recommandé pour commencer (modèles gratuits sans carte bancaire).

Option A : OpenRouter (Recommandé - Gratuit)

Obtenir une clé sur : https://openrouter.ai/keys

OPENROUTER_API_KEY="sk-or-votre-cle-ici"
MODEL_OPUS="open_router/google/gemma-4-26b-a4b-it:free"
MODEL_SONNET="open_router/google/gemma-4-26b-a4b-it:free"
MODEL_HAIKU="open_router/google/gemma-4-26b-a4b-it:free"
MODEL="open_router/google/gemma-4-26b-a4b-it:free"

Option B : NVIDIA NIM (Alternative)

Obtenir une clé sur : https://build.nvidia.com/settings/api-keys

NVIDIA_NIM_API_KEY="nvapi-votre-clé-ici"
MODEL_OPUS="nvidia_nim/meta/llama-3.1-70b-instruct"
MODEL_SONNET="nvidia_nim/z-ai/glm4.7"
MODEL_HAIKU="nvidia_nim/meta/llama-3.1-8b-instruct"
MODEL="nvidia_nim/z-ai/glm4.7"

⚠️ Sécurité : Ne jamais partager votre fichier .env avec vos clés. Ajoutez .env à votre .gitignore.

2. Format des Modèles

Format : provider_type/model/name

open_router ou nvidia_nim = provider
google ou z-ai = organisation
gemma-4-26b-a4b-it:free ou glm4.7 = nom du modèle

3. Token d'authentification

ANTHROPIC_AUTH_TOKEN="freecc"

Ce token est local et fictif. Claude Code l'envoie au proxy, et le proxy le renvoie tel quel. Vous pouvez mettre n'importe quelle valeur (ex: "toto", "1234"). "freecc" est la convention du projet. C'est un token de test non sensible.

4. Options de "Thinking" (Raisonnement)

ENABLE_MODEL_THINKING=true

Cela active les blocs de réflexion. Les options par modèle héritent de cette valeur.

5. Configuration du serveur

PROVIDER_RATE_LIMIT=1
PROVIDER_RATE_WINDOW=3
PROVIDER_MAX_CONCURRENCY=5

PROVIDER_RATE_LIMIT : Nombre de requêtes
PROVIDER_RATE_WINDOW : Sur combien de secondes
PROVIDER_MAX_CONCURRENCY : Requêtes simultanées max

Comprendre le Routage des Modèles

La confusion "Opus 4.7"

⚠️ Point important : Il n'existe pas de modèle "Claude Opus 4.7".

GLM-4.7 est un modèle de Zhipu AI (entreprise chinoise)
Claude Opus est un modèle d'Anthropic (entreprise américaine)
Ils n'ont rien à voir l'un avec l'autre

Dans Free Claude Code :

Quand Claude Code "demande" Opus → Le proxy envoie la requête vers le modèle défini dans MODEL_OPUS
Si vous mettez MODEL_OPUS="nvidia_nim/z-ai/glm4.7", alors "Opus" = GLM-4.7 (c'est juste un alias)

Comparaison des modèles par Provider

Provider : NVIDIA NIM

Modèle	Identifiant complet	Points forts	Points faibles
GLM-4.7	`nvidia_nim/z-ai/glm4.7`	Équilibré, fiable	-
Kimi K2	`nvidia_nim/moonshotai/kimi-k2`	Très capable	Moins testé
MiniMax M1	`nvidia_nim/minimax/minimax-m1`	Rapide	Moins puissant

Provider : OpenRouter (Modèles gratuits :free)

Modèle	Identifiant complet	Points forts	Points faibles
Gemma-4	`open_router/google/gemma-4-26b-a4b-it:free`	Léger, gratuit	Limites de taux
Llama 3.1	`open_router/meta-llama/llama-3.1-8b-instruct:free`	Standard, stable	-

Recommandations :

OpenRouter (gratuit) : Idéal pour débuter sans carte bancaire (google/gemma-4-26b-a4b-it:free)
NVIDIA NIM : Pour une utilisation plus poussée (nécessite une clé API NVIDIA)

Intégration VSCode

Pré-requis : Installer l'extension Claude Code

Avant de configurer VSCode, assurez-vous que l'extension Claude Code est installée :

Ouvrez VSCode
Allez dans l'onglet Extensions (Ctrl+Shift+X ou Cmd+Shift+X sur macOS)
Recherchez "Claude Code" (éditeur : Anthropic)
Cliquez sur Install

Emplacement du fichier settings.json

Le fichier de configuration VSCode se trouve à des emplacements différents selon votre système d'exploitation :

Système	Chemin du fichier settings.json
Windows	`%APPDATA%\Code\User\settings.json` (ou `$env:APPDATA\Code\User\settings.json` en PowerShell)
macOS	`$HOME/Library/Application Support/Code/User/settings.json`
Linux	`$HOME/.config/Code/User/settings.json`

Configuration pas à pas

Étape 1 : Ouvrir le fichier settings.json

Méthode recommandée (tous les OS) :

Ouvrez VSCode
Appuyez sur Ctrl+Shift+P (Windows/Linux) ou Cmd+Shift+P (macOS) pour ouvrir la Command Palette
Tapez : Preferences: Open User Settings (JSON)
Appuyez sur Entrée

Le fichier settings.json s'ouvre dans l'éditeur.

Étape 2 : Ajouter la configuration Free Claude Code

Cas A : Fichier settings.json vide ou nouveau

Si votre fichier est vide ou contient seulement {}, remplacez tout par :

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "http://localhost:8082" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "freecc" }
  ]
}

Cas B : Fichier settings.json existant avec d'autres paramètres

Si votre fichier contient déjà des paramètres (exemple : thème, taille de police, etc.), ajoutez la configuration à l'intérieur des accolades existantes :

Exemple avant :

{
  "editor.fontSize": 14,
  "workbench.colorTheme": "Dark+"
}

Exemple après (ajout de la virgule et de la configuration) :

{
  "editor.fontSize": 14,
  "workbench.colorTheme": "Dark+",
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "http://localhost:8082" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "freecc" }
  ]
}

⚠️ Important : N'oubliez pas la virgule après le paramètre précédent !

Étape 3 : Sauvegarder et recharger

Sauvegardez le fichier (Ctrl+S ou Cmd+S)
Rechargez VSCode :
- Ouvrez la Command Palette (Ctrl+Shift+P ou Cmd+Shift+P)
- Tapez : Developer: Reload Window
- Appuyez sur Entrée

Résultat attendu dans settings.json

Votre configuration finale devrait ressembler à ceci :

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "http://localhost:8082" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "freecc" }
  ],
  "editor.fontSize": 14,
  "workbench.colorTheme": "Dark+",
  "... autres paramètres ..."
}

Vérification que la configuration fonctionne

Test 1 : Vérifier que le proxy est actif

Avant de tester l'extension, assurez-vous que le proxy tourne :

# macOS/Linux
lsof -i :8082

# Windows (PowerShell)
netstat -ano | findstr :8082

Résultat attendu : Une ligne montrant qu'un processus écoute sur le port 8082.

Si le proxy ne tourne pas, lancez-le :

# macOS/Linux
cd $HOME/Projets/free-claude-code
uv run uvicorn server:app --host 0.0.0.0 --port 8082 &

# Windows (PowerShell)
cd $env:USERPROFILE\Projets\free-claude-code
Start-Process powershell -ArgumentList "-NoExit", "-Command", "uv run uvicorn server:app --host 0.0.0.0 --port 8082" -WindowStyle Minimized

Test 2 : Ouvrir l'extension Claude Code dans VSCode

Cliquez sur l'icône Claude Code dans la barre latérale de VSCode
L'extension devrait se connecter automatiquement au proxy local
Aucun écran de connexion ne devrait apparaître si la configuration est correcte

Test 3 : Envoyer un message test

Dans l'interface Claude Code de VSCode :

Tapez un message simple : Hello, quel modèle es-tu ?
Envoyez le message
Claude devrait répondre via le modèle configuré dans votre .env (ex: GLM-4.7, Gemma-4, etc.)

Si vous voyez une réponse : ✅ La configuration fonctionne !

Dépannage VSCode

Problème : "Unable to connect" ou écran de connexion

Solutions :

Vérifiez le fichier settings.json :
- Pas de faute de frappe dans ANTHROPIC_BASE_URL
- Pas de /v1 à la fin de l'URL
- JSON valide (accolades, virgules)
Vérifiez que le proxy tourne (voir Test 1 ci-dessus)
Rechargez VSCode complètement :
- Fermez VSCode
- Rouvrez VSCode
- Attendez 5-10 secondes
Vérifiez les logs de l'extension :
- Ouvrez la Console de développement : Help > Toggle Developer Tools
- Onglet Console
- Cherchez des erreurs liées à claudeCode ou ANTHROPIC_BASE_URL

Problème : Le modèle ne répond pas comme attendu

Solutions :

Vérifiez les logs du proxy (Terminal 1 où tourne uvicorn)
Vérifiez votre fichier .env :
```
cat $HOME/Projets/free-claude-code/.env
```
Vérifiez que votre clé API est valide (NVIDIA NIM ou OpenRouter)

Points subtils à retenir

⚠️ Pas de /v1 à la fin de ANTHROPIC_BASE_URL (erreur courante)
⚠️ Le proxy doit tourner en arrière-plan pendant toute votre session VSCode
⚠️ Le token "freecc" est fictif : c'est normal, il sert uniquement en local
✅ Les variables s'appliquent à l'extension uniquement : elles ne modifient pas votre configuration globale Claude Code CLI

Utilisation Quotidienne

Méthode recommandée : Deux terminaux

C'est la méthode la plus stable et la plus facile à comprendre.

Terminal 1 : Lancer le proxy (serveur)

cd $HOME/Projets/free-claude-code
uv run uvicorn server:app --host 0.0.0.0 --port 8082

Ce que cette commande fait :

uv run : Exécute la commande dans l'environnement virtuel du projet
uvicorn : Serveur web ASGI (comme gunicorn mais pour Python asynchrone)
server:app : Le fichier server.py et la variable app (notation Python : module:variable pour l'application FastAPI)
--host 0.0.0.0 : Écoute sur toutes les interfaces (pas seulement localhost)
--port 8082 : Port d'écoute

⚠️ Laissez ce terminal ouvert ! Le proxy doit rester actif.

Terminal 2 : Lancer Claude Code (client)

ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude

Ce que cette commande fait :

Définit ANTHROPIC_AUTH_TOKEN pour cette session uniquement
Définit ANTHROPIC_BASE_URL pour rediriger vers le proxy local
Lance claude (CLI de Claude Code)

Note : Claude Code doit être installé séparément. Si ce n'est pas le cas :

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

Méthode alternative : Un seul terminal

Si vous préférez n'utiliser qu'un seul terminal :

cd $HOME/Projets/free-claude-code
uv run uvicorn server:app --host 0.0.0.0 --port 8082 &
sleep 3
ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude

Explication du & :

Le & à la fin de la première commande la met en arrière-plan
Le terminal peut alors exécuter la deuxième commande
Le proxy tourne en tâche de fond

Pour arrêter le proxy plus tard :

kill %1
# ou
pkill -f uvicorn

Vérifications et Dépannage Rapide

Principe de base

💡 Point important : Claude Code peut être lancé depuis n'importe quel dossier de votre système. Vous n'avez pas besoin d'être dans $HOME/Projets/free-claude-code ou $HOME/Projets/free-claude-code-guide.

Vérifications essentielles

1. Vérifier que le proxy tourne (port 8082)

lsof -i :8082

Résultat attendu : Vous devriez voir une ligne avec uvicorn et le port 8082.

Si aucun résultat : Le proxy ne tourne pas. Relancez-le :

cd $HOME/Projets/free-claude-code && uv run uvicorn server:app --host 0.0.0.0 --port 8082 &

2. Lancer Claude Code depuis n'importe où

Option A : Variables temporaires (recommandé)

ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude

Option B : Export puis lancement

export ANTHROPIC_BASE_URL="http://localhost:8082"
export ANTHROPIC_AUTH_TOKEN="freecc"
claude

Dépannage et Subtilités

Le proxy ne démarre pas

Vérifier que le fichier .env est correct :

cat $HOME/Projets/free-claude-code/.env | grep NVIDIA_NIM_API_KEY

La clé ne doit pas être vide.

Vérifier que le port 8082 n'est pas utilisé :

lsof -i :8082

Si quelque chose utilise le port, changez le port dans la commande (--port 8083 par exemple).

Claude Code ne se connecte pas

Symptôme : Claude Code affiche une erreur de connexion.

Vérifications :

Le proxy tourne (Terminal 1 actif)
L'URL est correcte : http://localhost:8082 (pas de /v1)
Le token est défini : ANTHROPIC_AUTH_TOKEN="freecc"

Les modèles ne répondent pas comme attendu

Vérifier les logs du proxy (Terminal 1) :

Les erreurs de l'API NVIDIA NIM s'affichent ici
Vérifiez que votre clé API est valide
Vérifiez que le modèle demandé existe sur NVIDIA NIM

Réinitialiser complètement

cd $HOME/Projets/free-claude-code
rm .env
cp .env.example .env
# Puis ré-éditer .env avec votre clé

Question fréquente : "Puis-je utiliser de vrais modèles Claude ?"

Oui, mais :

Il faut utiliser le provider open_router avec une clé API
Ce n'est pas gratuit (OpenRouter facture à l'usage)

Dans ce cas, configurez :

OPENROUTER_API_KEY="sk-or-votre-clé"
MODEL_OPUS="open_router/anthropic/claude-3-opus"

Résumé des Commandes Essentielles

Installation (à faire une seule fois)

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

# Installer Python 3.14
uv python install 3.14

# Cloner et installer le projet
cd $HOME/Projets
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
uv sync

Configuration (à faire une seule fois)

# Éditer le fichier .env
code $HOME/Projets/free-claude-code/.env
# Ajouter : NVIDIA_NIM_API_KEY="nvapi-votre-clé"

Utilisation quotidienne

# Terminal 1 : Démarrer le proxy
cd $HOME/Projets/free-claude-code
uv run uvicorn server:app --host 0.0.0.0 --port 8082

# Terminal 2 : Démarrer Claude Code
ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude

Vérifications

# Voir les processus uvicorn
ps aux | grep uvicorn

# Voir ce qui écoute sur le port 8082
lsof -i :8082

# Tester le proxy (curl)
curl http://localhost:8082/v1/models

Ressources et Liens

Dépôt Free Claude Code : GitHub
Obtenir une clé NVIDIA NIM : NVIDIA
Documentation uv : Docs
Claude Code CLI : Installation (documentation officielle Anthropic)

Avertissements et Bonnes Pratiques

Sécurité : Ne commitez jamais votre fichier .env avec la clé API
Mises à jour : Free Claude Code est un projet actif, faites git pull régulièrement
Limites de NVIDIA NIM : Le tier gratuit a une limite de 40 req/min
Stabilité : GLM-4.7 est le modèle par défaut car le plus testé avec Claude Code CLI
VSCode : L'extension nécessite que le proxy tourne en arrière-plan

Dernière mise à jour : Mai 2026 Guide créé par valorisa après session d'installation complète sur macOS Sequoia

Name		Name	Last commit message	Last commit date
Latest commit History 64 Commits
.github		.github
.dockerignore		.dockerignore
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
.markdownlint.json		.markdownlint.json
CHANGELOG.md		CHANGELOG.md
CODEOWNERS		CODEOWNERS
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
DEVELOPMENT.md		DEVELOPMENT.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
docker-commands.md		docker-commands.md
nginx.conf		nginx.conf
package.json		package.json

Folders and files

Latest commit

History

Repository files navigation

Free Claude Code - Guide Complet d'Installation et d'Utilisation

Table des matières

Instructions par Système d'Exploitation

Windows 10/11 Enterprise

macOS (Sequoia et versions antérieures)

Linux (Ubuntu/Debian/Fedora/Arch)

Qu'est-ce que Free Claude Code ?

Ce que ça fait :

Ce que ça N'EST PAS :

Architecture et Fonctionnement

Flux de données :

Points subtils à comprendre :

1. Le concept de "Proxy Sortant" (NVIDIA_NIM_PROXY)

2. Le routage Opus/Sonnet/Haiku

Emplacement du Projet

Pré-requis et Installation

Étape 1 : Installer uv (gestionnaire de paquets Python moderne)

Étape 2 : Installer Python 3.14

Étape 3 : Cloner le dépôt

Étape 4 : Installer les dépendances

Configuration Détaillée

Le fichier .env

1. Choix du Provider (OBLIGATOIRE)

2. Format des Modèles

3. Token d'authentification

4. Options de "Thinking" (Raisonnement)

5. Configuration du serveur

Comprendre le Routage des Modèles

La confusion "Opus 4.7"

Comparaison des modèles par Provider

Intégration VSCode

Pré-requis : Installer l'extension Claude Code

Emplacement du fichier settings.json

Configuration pas à pas

Étape 1 : Ouvrir le fichier settings.json

Étape 2 : Ajouter la configuration Free Claude Code

Étape 3 : Sauvegarder et recharger

Résultat attendu dans settings.json

Vérification que la configuration fonctionne

Test 1 : Vérifier que le proxy est actif

Test 2 : Ouvrir l'extension Claude Code dans VSCode

Test 3 : Envoyer un message test

Dépannage VSCode

Problème : "Unable to connect" ou écran de connexion

Problème : Le modèle ne répond pas comme attendu

Points subtils à retenir

Utilisation Quotidienne

Méthode recommandée : Deux terminaux

Terminal 1 : Lancer le proxy (serveur)

Terminal 2 : Lancer Claude Code (client)

Méthode alternative : Un seul terminal

Vérifications et Dépannage Rapide

Principe de base

Vérifications essentielles

1. Vérifier que le proxy tourne (port 8082)

2. Lancer Claude Code depuis n'importe où

Dépannage et Subtilités

Le proxy ne démarre pas

Claude Code ne se connecte pas

Les modèles ne répondent pas comme attendu

Réinitialiser complètement

Question fréquente : "Puis-je utiliser de vrais modèles Claude ?"

Résumé des Commandes Essentielles

Installation (à faire une seule fois)

Configuration (à faire une seule fois)

Utilisation quotidienne

Vérifications

Ressources et Liens

Avertissements et Bonnes Pratiques

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Le fichier `.env`

Packages