Installieren Sie den kostenlosen Code, den kostenlosen KI-Kodierungs-Agenten für Ihr Terminal
free-code liest Ihr Projekt, bearbeitet Dateien mit einem Diff, den Sie genehmigen, führt Ihre Tests aus und behebt, was fehlschlägt. Eine Zeile installiert es auf macOS, Linux oder Windows.
curl -fsSL https://free.ai/install.sh | sh
irm https://free.ai/install.ps1 | iex
Zuerst brauchten keine Python-, Pip- oder Admin-Rechte. Führen Sie die gleiche Zeile erneut zum Upgrade aus.
Start frei: 6,000 markiert einen Tag ohne Konto, 30,000 einen Tag mit einem bestätigten kostenlosen Konto.
Andere Möglichkeiten zur 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
Das npm-Paket benötigt Python 3.9 oder neuer auf der Maschine.
Eine bestimmte Version installieren
# 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
Um eine Installationsmethode zu erzwingen, setzen Sie FREE_CODE_INSTALLER auf uv, pipx oder venv auf die gleiche Weise.
Prüfen Sie, ob es funktioniert hat.
free-code --version
Erster Lauf
Öffnen Sie ein Terminal in Ihrem Projektordner und starten Sie eine Sitzung. Es funktioniert sofort ohne Konto.
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"
Der sichere Modus ist standardmäßig eingeschaltet: Sie sehen einen Diff und genehmigen jede Datei bearbeiten und Befehl, bevor es ausgeführt wird. Beim ersten Mal fragt free-code einmal, ob anonyme Absturzberichte gesendet werden sollen. Die Standardantwort ist nein.
Anmelden und API-Schlüssel
Signing in raises your daily free allowance and lets you use paid models from your token balance. Your browser opens at Free.ai, you press Approve, and the CLI receives a key automatically.
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
Sie können auch selbst einen Schlüssel in Ihrem Konto erstellen und ihn einstellen, was für Server und CI praktisch ist:
free-code config set token sk-free-...
# or, for one shell or a CI job
export FREE_CODE_TOKEN=sk-free-...
Erstellen Sie ein kostenloses Konto
Verwenden Sie Ihren eigenen Provider-Schlüssel
free-code funktioniert auch mit Ihrem eigenen OpenAI, Anthropoc, Google oder OpenRouter Schlüssel. Anfragen gehen dann mit Ihrem Schlüssel an diesen Anbieter.
free-code config set provider anthropic
free-code config set api_key sk-ant-...
Wählen Sie ein Modell
free-code lists every model Free.ai serves, free tier models first. Free tier models cost no tokens within your daily allowance; paid models are billed in tokens.
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
In einer Sitzung geben Sie /model umzuschalten. Alle Modelle durchsuchen
Gemeinsame Befehle
| Befehl | Was es tut |
|---|---|
free-code | Starten Sie eine interaktive Sitzung in diesem Ordner |
free-code -c | Die neueste Sitzung für dieses Projekt fortsetzen |
free-code ask "..." | Stellen Sie eine Frage über die Codebase |
free-code run "..." | Eine Kodierungsaufgabe ausführen |
free-code -p "..." | Drucken Sie die Antwort und den Ausgang, für Skripte und CI |
free-code sessions | Liste gespeicherte Sitzungen, die Sie wieder aufnehmen können |
free-code tools | Zeigen Sie die Werkzeuge, die der Agent verwenden kann und die Genehmigung benötigen |
free-code cloud "..." --repo URL | Führen Sie eine Aufgabe in der Free.ai Cloud aus und erhalten Sie einen Bericht |
free-code tasks | Liste deine aktuellen Cloud-Aufgaben auf |
free-code rc | Beobachten und fahren Sie die Sitzung von der Free.ai App |
free-code mcp add | Einen MCP-Server verbinden |
free-code update | Upgrade auf die neueste Version |
free-code config | Einstellungen anzeigen |
Neben der Bearbeitung von Dateien und der Ausführung von Befehlen kann der Agent Bilder, Sprache, Musik und Video in Ihr Projekt erzeugen, Audio transkribieren, Text aus Screenshots und PDFs lesen, das Web mit Zitaten durchsuchen und lokale Dateien übersetzen.
Aktualisieren und deinstallieren
Free-Code-Update-Upgrades durch was auch immer installiert. Um es zu entfernen, verwenden Sie das gleiche Werkzeug:
free-code update
uv tool uninstall freeai-code
pipx uninstall freeai-code
pip uninstall freeai-code
npm uninstall -g freeai-code
Wenn der Installer eine eigene Umgebung erstellt hat, löschen Sie den.free-code Ordner in Ihrem Home-Verzeichnis und die Free-code Datei in.local/bin. Ihre Einstellungen und gespeicherten Sitzungen leben auch in.free-code.
Fehlerbehebung
free-code: Befehl nicht gefunden
Der Installationsordner ist noch nicht auf Ihrem PATH. Öffnen Sie unter Windows ein neues Terminal. Fügen Sie es auf macOS oder Linux Ihrem Shell-Profil hinzu und öffnen Sie ein neues Terminal:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc # or ~/.zshrc
Das kostenlose anonyme Limit für heute wird aufgebraucht
Führen Sie einen Freicode-Login aus, um sich anzumelden und die größere Tageszulage eines kostenlosen Kontos zu erhalten, oder fügen Sie Token zur Verwendung bezahlter Modelle hinzu. Siehe Preisgestaltung
Der Installer kann nicht heruntergeladen werden uv
Einige Netzwerke blockieren astral.sh. Installieren Sie stattdessen mit Pipx oder Pip oder setzen FREE_CODE_INSTALLER=venv, um Ihre eigene Python 3.9 oder neuer zu verwenden.
python3 -m venv ist auf Debian oder Ubuntu fehlgeschlagen
Installieren Sie das Paket python3-venv mit apt und starten Sie die Installationszeile erneut.
Gib /feedback in free-code ein oder eröffne ein Problem auf GitHub. GitHub issues
FAQ
Codieren Sie mit AI in Ihrem Terminal
curl -fsSL https://free.ai/install.sh | sh
Windows und andere Installationsoptionen · Über Free.ai Coder