Erste Schritte
FeloAPI CLI
Installieren Sie die FeloAPI CLI und führen Sie npx feloapi-cli setup aus, um Codex oder Claude Code mit Ihrem Felo API-Schlüssel zu konfigurieren.
Konfigurieren Sie Felo-Modelle und Felo Skills für Codex oder Claude Code direkt in Ihrem Terminal. Sie können auch die Befehle für Felo Search, Slides, Web Fetch und LiveDocs verwenden.
Mit einem Befehl starten
Installieren Sie Node.js 22 oder neuer und führen Sie dann aus:
npx feloapi-cli setupAkzeptieren Sie die Installationsaufforderung von npm, falls sie erscheint. Ein npm-Konto oder eine globale Installation ist nicht erforderlich. Installieren Sie Codex oder Claude Code separat; die Modellkonfiguration für Codex erfordert Codex CLI 0.134.0+.
API-Schlüssel abrufen und Einrichtung abschließen
- Öffnen Sie die Seite „API-Schlüssel“ der Felo Console und melden Sie sich bei Felo an.
- Erstellen Sie einen Schlüssel und kopieren Sie den vollständigen Schlüssel aus dem Erstellungsergebnis. Die Liste zeigt nur einen maskierten Schlüssel; sie kann den vollständigen Wert nicht wiederherstellen. Wenn Sie ihn nicht mehr haben, erstellen Sie einen neuen Schlüssel.
- Führen Sie
npx feloapi-cli setupin Ihrem Terminal aus und wählen Sie Codex oder Claude Code. - Wählen Sie Models + Skills, Skills only oder Models only. Fügen Sie bei Aufforderung Ihren vollständigen Schlüssel ein; die Eingabe wird ausgeblendet.
- Wenn Sie ein Modell konfigurieren, wählen Sie ein für Ihr Konto verfügbares Modell. Codex benötigt ein Textmodell, das Responses unterstützt; Claude Code benötigt Anthropic Messages. Ein Modell in der Liste garantiert keine Client-Kompatibilität.
- Prüfen Sie die Konfigurationsvorschau und bestätigen Sie das Speichern.
Die CLI speichert Ihren Schlüssel lokal in ~/.feloapi/state.json. Diese Datei ist nicht verschlüsselt; halten Sie sie von Git und freigegebenen Ordnern fern. Fügen Sie Ihren Schlüssel nicht in Befehlsargumente oder öffentliche Logs ein. Die Einrichtungsaufforderung akzeptiert einen API-Schlüssel, kein Felo-Konto-Token und keine Schlüssel-ID.
Konfigurierten Agenten starten
Starten Sie nach der Einrichtung den Agenten, den Sie konfiguriert haben:
npx feloapi-cli run codexFür Claude Code:
npx feloapi-cli run claude-codeVerwenden Sie diesen Launcher, um den gespeicherten Schlüssel und die Felo-Konfiguration an den Agenten zu übergeben. Die Einrichtung erstellt eine separate Felo-Konfiguration; sie wechselt Ihren Standard-Modellanbieter nicht. Starten Sie eine neue Agent-Sitzung, um neu installierte Skills zu laden.
Global installieren oder Funktionen auswählen
Für häufige Nutzung installieren Sie das npm-Paket feloapi-cli global. Der installierte Befehl lautet feloapi:
npm install -g feloapi-cli
feloapi setup
feloapi run codexSo installieren Sie nur Felo Skills:
npx feloapi-cli setup --agent codex --skills-onlySo prüfen Sie eine Verbindung, ohne die Konfiguration zu speichern; ersetzen Sie YOUR_MODEL_ID durch eine verfügbare Modell-ID:
npx feloapi-cli models
npx feloapi-cli connect codex --model YOUR_MODEL_ID --dry-run--no-skills konfiguriert nur ein Modell. Wenn Sie die Einrichtung erneut ausführen, ersetzt sie die Felo-Verbindung dieses Agenten durch Ihre neuen Auswahl; wenn Sie nur Skills wählen, wird das zuvor verwaltete Modellprofil entfernt.
Felo-Tools verwenden und Einrichtung prüfen
Nachdem Sie Ihren Schlüssel gespeichert haben, verwenden Sie die vorhandenen Felo-Tools. API-Anfragen können das Kontingent Ihres Kontos verbrauchen:
npx feloapi-cli search "AI agent trends" --json
npx feloapi-cli web-fetch --url https://example.com --format markdownFühren Sie lokale Prüfungen aus oder rufen Sie die Befehlshilfe auf:
npx feloapi-cli doctor
npx feloapi-cli --helpdoctor prüft die lokale Konfiguration, ohne einen kostenpflichtigen API-Aufruf durchzuführen. doctor --online prüft zusätzlich die Modellerkennung; doctor --probe --agent codex sendet nach Bestätigung eine kleine Modellanfrage und kann Kosten verursachen.
| Problem | Was Sie tun sollten |
|---|---|
npx wird nicht gefunden oder Node ist zu alt | Installieren Sie Node.js 22+ und öffnen Sie Ihr Terminal erneut. Prüfen Sie node --version. |
| Der Schlüssel wird abgelehnt | Verwenden Sie den vollständigen Schlüssel aus dem Erstellungsergebnis. Aktualisieren Sie ihn mit npx feloapi-cli auth login. |
| Der Agent verwendet einen anderen Anbieter | Starten Sie ihn mit npx feloapi-cli run codex oder run claude-code; prüfen Sie Projekteinstellungen und ausdrückliche Überschreibungen. |
| Bestehende Konfigurationen stehen in Konflikt | Prüfen Sie die gemeldeten Dateien. Die CLI bewahrt Dateien auf, die sie nicht verwaltet, sowie Dateien, die außerhalb der CLI bearbeitet wurden. |
| Eine Verbindung entfernen | Führen Sie npx feloapi-cli disconnect codex oder disconnect claude-code aus. |
npx feloapi-cli auth logout entfernt nur den lokalen Schlüssel. Um einen Schlüssel zu widerrufen, verwenden Sie die Felo Console.
Zur manuellen Konfiguration siehe die Codex-Anleitung und die Claude Code-Anleitung.