Installez le code libre, l'agent de codage gratuit pour votre terminal
free-code lit votre projet, modifie des fichiers avec un diff que vous approuvez, exécute vos tests et corrige ce qui échoue. Une ligne l'installe sur macOS, Linux ou Windows.
curl -fsSL https://free.ai/install.sh | sh
irm https://free.ai/install.ps1 | iex
Pas de droits Python, pip ou admin nécessaires en premier. Exécutez de nouveau la même ligne pour la mettre à niveau.
Gratuit pour commencer: 6,000 jetons par jour sans compte, 30,000 par jour avec un compte libre confirmé.
Autres moyens d'installation
The one-line installer uses uv, then pipx, then a private Python environment, whichever works first. If you already use one of these tools, install the freeai-code package directly:
uv tool install freeai-code
pipx install freeai-code
pip install freeai-code
npm install -g freeai-code
Le paquet npm a besoin de Python 3.9 ou plus récent sur la machine.
Installer une version spécifique
# macOS / Linux
curl -fsSL https://free.ai/install.sh | FREE_CODE_VERSION=<version> sh
# Windows (PowerShell)
$env:FREE_CODE_VERSION = "<version>"; irm https://free.ai/install.ps1 | iex
Pour forcer une méthode d'installation, définissez FREE_CODE_INSTALLER à uv, pipx ou vrv de la même manière.
Vérifiez que ça a marché.
free-code --version
Première manche
Ouvrez un terminal dans votre dossier de projet et démarrez une session. Ça marche tout de suite sans compte.
cd your-project
free-code
# Or one task at a time
free-code ask "How does the auth system work?"
free-code run "Add unit tests for the User model"
Le mode de sécurité est activé par défaut : vous voyez un diff et approuvez chaque modification et commande de fichier avant qu'il ne soit exécuté. La première fois, le code libre demande une fois si vous devez envoyer des rapports anonymes de crash. La réponse par défaut est non.
Connexion et clés API
La connexion augmente votre allocation quotidienne gratuite et vous permet d'utiliser des modèles payés à partir de votre solde symbolique. Votre navigateur s'ouvre à Free.ai, vous appuyez sur Approuver, et le CLI reçoit automatiquement une clé.
free-code login # opens your browser
free-code login --no-browser # over SSH: approve from any device with a short code
free-code login --manual # paste a key or choose your own provider
free-code logout # forget the key on this machine
Vous pouvez également créer une clé vous-même dans votre compte et la définir, ce qui est pratique pour les serveurs et les IC:
free-code config set token sk-free-...
# or, for one shell or a CI job
export FREE_CODE_TOKEN=sk-free-...
Utilisez votre propre clé de fournisseur
free-code fonctionne également avec votre propre clé OpenAI, Anthropic, Google ou OpenRouter. Les demandes vont ensuite à ce fournisseur avec votre clé.
free-code config set provider anthropic
free-code config set api_key sk-ant-...
Choisir un modèle
code libre liste tous les modèles de Free.ai, les modèles de niveau libre d'abord. Les modèles de niveau gratuit ne coûtent pas de jetons dans votre allocation journalière; les modèles payés sont facturés en jetons.
free-code models # chat models, free tier first
free-code models --free # only models that cost no tokens
free-code models --type image # image, video, tts, stt, ocr, music ...
free-code config set model <id> # default model for new sessions
Dans une session, tapez /modèle pour basculer. Parcourir tous les modèles
Commandes communes
| Commande | Ce qu'il fait |
|---|---|
free-code | Démarrer une session interactive dans ce dossier |
free-code -c | Reprendre la dernière session de ce projet |
free-code ask "..." | Posez une question sur la base de codes |
free-code run "..." | Effectuer une tâche de codage |
free-code -p "..." | Imprimer la réponse et la sortie, pour les scripts et les CI |
free-code sessions | Liste des sessions sauvegardées que vous pouvez reprendre |
free-code tools | Afficher les outils que l'agent peut utiliser et qui doivent être approuvés |
free-code cloud "..." --repo URL | Exécutez une tâche dans le cloud Free.ai et obtenez un rapport |
free-code tasks | Énumérez vos tâches de cloud récentes |
free-code rc | Regarder et conduire la session depuis l'application Free.ai |
free-code mcp add | Connexion d'un serveur MCP |
free-code update | Mise à jour vers la dernière version |
free-code config | Afficher vos paramètres |
Outre l'édition de fichiers et de commandes en cours d'exécution, l'agent peut générer des images, des paroles, de la musique et de la vidéo dans votre projet, transcrire l'audio, lire du texte à partir de captures d'écran et de PDF, rechercher sur le Web avec des citations et traduire des fichiers locaux.
Mettre à jour et désinstaller
mise à jour de code libre par l'intermédiaire de tout ce qui l'a installé. Pour le supprimer, utilisez le même outil :
free-code update
uv tool uninstall freeai-code
pipx uninstall freeai-code
pip uninstall freeai-code
npm uninstall -g freeai-code
Si l'installateur a créé son propre environnement, supprimez le dossier.free-code dans votre répertoire d'origine et le fichier free-code dans.local/bin. Vos paramètres et sessions sauvegardées vivent également dans le code.free.
Dépannage
code libre : commande introuvable
Le dossier d'installation n'est pas encore sur votre PATH. Sur Windows, ouvrez un nouveau terminal. Sur macOS ou Linux, ajoutez-le à votre profil shell et ouvrez un nouveau terminal :
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc # or ~/.zshrc
La limite anonyme gratuite pour aujourd'hui est épuisée
Lancez une connexion au code gratuit pour vous connecter et obtenir l'allocation quotidienne plus importante d'un compte gratuit, ou ajoutez des jetons pour utiliser des modèles payants. Voir prix
L'installateur ne peut pas télécharger uv
Certains réseaux bloquent astral.sh. Installez avec pipx ou pip à la place, ou définissez FREE_CODE_INSTALLER=venv pour utiliser votre propre Python 3.9 ou plus récent.
python3 -m verv a échoué sur Debian ou Ubuntu
Installez le paquet python3-venv avec apt, puis exécutez à nouveau la ligne d'installation.
Toujours coincé? Tapez /feedback à l'intérieur du code libre, ou ouvrez un problème sur GitHub. GitHub issues
FAQ
Commencez à coder avec l'IA dans votre terminal
curl -fsSL https://free.ai/install.sh | sh
Windows et autres options d'installation · A propos de Free.ai Coder