Dokumentationsstand · CLI 7.30.1 · SDK 2.6.53. Desktop verwendet die mit seiner eigenen Version gelieferte Runtime. Befehle und Beispiele bleiben wie im englischen Original. Englische Fassung

Den ersten Modellanbieter verbinden

Verbindung auswählen

Ein Anbieter verbindet Sie mit einem Modelldienst; das Modell ist die konkrete Auswahl über diese Verbindung. Das Verbinden wählt weder alle Modelle aus noch erteilt es Kontozugriff.

Geben Sie in der Terminaloberfläche /connect ein und wählen Sie einen der folgenden Wege. Desktop hat eigene Anbietereinstellungen und eine mitgelieferte Laufzeit; diese Schrägstrichbefehle beziehen sich auf das Terminal.

Cloud-API: Wählen Sie API Cloud Provider, den Dienst und folgen Sie den Anmeldeschritten. Ein Chat-Abonnement umfasst nicht unbedingt API-Zugriff oder API-Guthaben.
Programmier-CLI: Installieren Sie zuerst eine unterstützte CLI und melden Sie sich dort an. Wählen Sie dann CLI Provider. AX Code nutzt diese lokale Anmeldung; die Fähigkeiten hängen vom Adapter ab.
Lokales Modell: Starten Sie Ollama oder LM Studio und laden Sie ein Modell mit Werkzeugaufrufen. Wählen Sie dann Local LLM runtime und bestätigen Sie den Endpunkt. AX-Engine runtime bietet auf unterstützten Macs eigene Einrichtung und Modelldownloads.
Gateway: Wählen Sie AX Trust für dessen Endpunkt, API Cloud Provider → Custom API provider für andere Gateways oder Private GPU cloud für eine dedizierte kompatible Bereitstellung. Geben Sie Dienst-URL, Token und exakt die angekündigten Modell-IDs ein.

Verbindung prüfen

Führen Sie diese Befehle in einem interaktiven Terminal aus. Die Anmeldung fragt Anbieter und Zugangsdaten ab; echte Schlüssel gehören weder in geteilte Befehle noch in Repository-Dateien.

ax-code providers login
ax-code providers list
ax-code models

Anbieter und nutzbare Modell-IDs sollten erscheinen. Gespeicherte Zugangsdaten oder eine erfolgreiche Modellabfrage beweisen allein keine Inferenzberechtigung. Fahren Sie mit der Modellauswahl fort und senden Sie eine kleine Testanfrage.

Zugangsdaten und Konfiguration verwalten

Mit /providers verwalten Sie Verbindungen, mit /connect ersetzen Sie Schlüssel. Deaktivieren behält gespeicherte Zugangsdaten; Trennen löscht sie. Umgebungsvariablen und konfigurierte Schlüssel können weiterhin Zugriff ermöglichen.

Nutzen Sie die Projektdatei ax-code.json für gemeinsame nicht geheime Einstellungen und die globale Datei ~/.config/ax-code/ax-code.json für persönliche Vorgaben. Geheimnisse gehören nicht in die Versionsverwaltung; verwenden Sie die Anmeldeabfrage oder Umgebungsverweise aus dem Gateway-Leitfaden. Starten Sie nach manuellen Änderungen neu.

Wenn die Einrichtung scheitert

Anmeldefehler: Prüfen Sie, ob der Schlüssel zum gewählten Dienst, Endpunkt und API-Tarif gehört. Prüfen Sie bei einer Programmier-CLI zuerst deren eigene Anmeldung.
Leere Modellliste oder abgelehnte Verbindung: Prüfen Sie Serverstart, geladenes Modell, URL und Port. Ollama verwendet normalerweise http://localhost:11434/v1, LM Studio http://localhost:1234/v1.
Modell abgelehnt: Verwenden Sie die genaue ID des Endpunkts und prüfen Sie Kontoberechtigungen. Bei Gateways kann der Anzeigename von der gesendeten Modell-ID abweichen.
Anbieter fehlt: Prüfen Sie enabled_providers und disabled_providers. Für Installationsdiagnosen führen Sie ax-code doctor aus; dies prüft kein Anbieterkonto.

Nächste Schritte

Anbieterkatalog und Anmeldung · Eigene Gateways und private GPU-Endpunkte · Modell auswählen · AX Wiki erstellen · Dokumentationsübersicht