Die OpenAI CLI ist OpenAIs offizielles Kommandozeilen-Tool für die OpenAI REST API. Sie installieren eine openai-Binärdatei, setzen OPENAI_API_KEY und rufen die API von Ihrem Terminal oder einem Shell-Skript aus auf: openai responses create, openai files upload, openai batches create, openai images generate. Es ist nicht die Codex CLI. Codex ist ein Coding-Agent; openai sendet einen API-Request pro Befehl.
Dieser Leitfaden behandelt Installation, Authentifizierung, die ersten ausprobierenswerten Befehle und den Vergleich mit der Codex CLI und dem alten openai-Befehl, den das Python SDK in Ihren PATH gelegt hat. Jeder Befehl und jede Ausgabe unten stammt aus Version 1.44.1, installiert und ausgeführt am 28. Oktober 2026.
Was ist die OpenAI CLI?
Die OpenAI CLI ist eine quelloffene Go-Binärdatei, veröffentlicht von OpenAI unter github.com/openai/openai-cli unter der Apache-2.0-Lizenz. Ihre Befehle spiegeln die Ressourcen der API wider (responses, files, batches, images, audio, vector-stores, admin), sodass alles, was Sie mit curl oder einem SDK senden würden, zu einem Terminalbefehl mit Flags wird.
Sie ist nicht brandneu. Version 1.0.0 wurde am 5. Mai 2026 veröffentlicht, und das Projekt hat seitdem 99 Releases herausgebracht; 1.44.1 erschien am 27. Oktober 2026. Betrachten Sie es also als ausgereiftes Tool, das Sie vielleicht verpasst haben, nicht als Neuerscheinung.
Das erwartet Sie beim ersten Start:
Die Hilfe gruppiert Befehle nach Aufgabe: Inhalte generieren (responses, chat, images, audio, videos), Daten und Abruf (files, uploads, vector-stores, embeddings), Modelle und Jobs, Administration sowie eine Reihe lokaler Tools, die niemals das Netzwerk berühren. Die Hilfe selbst benötigt keinen API-Schlüssel und keine Verbindung, was openai <command> --help zum schnellsten Weg macht, die Flags zu lernen.
Es eignet sich für Entwickler, die einen Prompt ohne Skript testen möchten, für Ops-Leute, die Datei-Uploads und Batches in einem Cron-Job wollen, und für Coding-Agents, die eine dokumentierte Schnittstelle statt handgeschriebenem curl benötigen.
Wie man die OpenAI CLI installiert
Sie haben drei Installationswege, alle im README des Projekts aufgeführt:
- Vorgefertigte Binärdatei. Laden Sie das Archiv für Ihr Betriebssystem und Ihre Architektur von GitHub Releases herunter (macOS-, Linux- und Windows-Builds werden veröffentlicht), entpacken Sie es und legen Sie
openaiin Ihren PATH. - Homebrew.
brew install openai/tools/openai
- Go. Erfordert Go 1.26 oder neuer.
go install 'github.com/openai/openai-cli/cmd/openai@latest'
export PATH="$PATH:$(go env GOPATH)/bin"
Selbstverwaltete Release-Installationen können sich während interaktiver Läufe selbst aktualisieren. Wenn Sie Versionen in CI pinnen, setzen Sie OPENAI_CLI_NO_AUTO_UPDATE=1, um automatische Installationen zu stoppen, oder OPENAI_CLI_NO_UPDATE_CHECK=1, um Update-Prüfungen vollständig abzuschalten. Homebrew- und Go-Installationen behalten ihre Update-Hinweise, überlassen Upgrades aber dem Paketmanager.
Wie die Authentifizierung der OpenAI CLI funktioniert
Die CLI liest einen Standard-API-Schlüssel aus OPENAI_API_KEY (oder dem --api-key-Flag, das Sie vermeiden sollten, weil es in der Shell-Historie landet). Wenn Sie noch keinen haben, führt Sie unser Leitfaden zum Abrufen eines OpenAI API-Schlüssels durch den Prozess.
Die schnellste Einrichtung ist der integrierte Leitfaden:
openai help setup
Er verweist Sie auf die API-Schlüssel-Seite und gibt Ihnen eine read -rs OPENAI_API_KEY-Zeile für Bash oder zsh, sodass der Schlüssel verdeckt eingegeben und niemals angezeigt wird.
Vergessen Sie den Schlüssel, erhalten Sie einen klaren, skriptfähigen Fehler. Dies ist die echte Ausgabe ohne gesetzten Schlüssel:
Es beendet sich mit Status 1 und teilt Ihnen genau mit, woher ein Schlüssel kommen kann. Fügen Sie --format-error json hinzu, wenn ein Skript den rohen Fehlerkörper benötigt.
Die anderen Authentifizierungseinstellungen:
| Einstellung | Flag | Umgebungsvariable | Verwenden für |
|---|---|---|---|
| API-Schlüssel | --api-key |
OPENAI_API_KEY |
Jeder normale API-Aufruf |
| Admin-Schlüssel | --admin-api-key |
OPENAI_ADMIN_KEY |
openai admin ... (Nutzung, Projekte); ein Projektschlüssel kann ihn nicht ersetzen |
| Basis-URL | --base-url |
OPENAI_BASE_URL |
Die CLI auf einen anderen Host oder ein Gateway richten |
| mTLS-Zertifikat und -Schlüssel | --mtls-client-cert-file, --mtls-client-key-file |
OPENAI_MTLS_CLIENT_CERT_FILE, OPENAI_MTLS_CLIENT_KEY_FILE |
Mutual TLS, das eine explizite HTTPS-Basis-URL erfordert |
Erste auszuführende OpenAI CLI-Befehle
Die Befehlsform folgt der API: openai <resource> [subresource...] <command> [flags...]. Dies sind die Befehle, die einen Platz in der Toolbox verdienen.
Einen Responses-API-Aufruf durchführen
openai responses create \
--model gpt-5.5 \
--input "Say this is a test"
Lange Prompts müssen nicht escaped werden. JSON-Eingabe-Flags lesen aus einer Datei mit @path:
openai responses create --model gpt-5.5 --input @prompt.txt
Wenn Sie JSON oder YAML aus einer nicht vertrauenswürdigen Quelle pipen, setzen Sie OPENAI_UNTRUSTED_STDIN=1, damit die Eingabe keine lokalen Dateilesevorgänge auslösen kann.
Dateien hochladen und abrufen
openai files upload report.txt --purpose user_data
openai files get file-example
openai files download file-example --output downloaded-report.txt
Einen Batch ausführen
Legen Sie eine Anfrage pro Zeile in requests.jsonl ab, jede mit einer eindeutigen custom_id, dann:
openai files upload requests.jsonl --purpose batch
openai batches create --input-file-id file-example \
--endpoint /v1/responses --completion-window 24h
openai batches wait batch_example --output-dir ./results
batches wait pollt, bis der Batch abgeschlossen ist, und speichert die Ergebnisdateien, was die Polling-Schleife erspart, die Sie sonst schreiben müssten. Der Batch-Leitfaden des Projekts listet die aktuellen Limits mit 50.000 Anfragen und 200 MB pro Eingabedatei bei einem 24h-Abschlussfenster auf. Die Batch-Preisgestaltung unterscheidet sich von synchronen Aufrufen; lesen Sie unsere OpenAI API-Preisübersicht, bevor Sie einen großen Job einreihen.
Tokens lokal zählen, ohne Schlüssel
Der tokenizer-Befehl läuft vollständig offline: keine Anmeldedaten, kein Netzwerk, keine gespeicherte Eingabe.
Die Standardkodierung ist o200k_base, und openai tokenizer encodings listet die anderen auf (cl100k_base plus zwei Legacy-Kodierungen). Die Hilfe ist ehrlich bezüglich der Grenzen: Eine Nur-Text-Zählung schließt Anfragestruktur und multimodale Eingaben aus, ist also keine Abrechnungszahl. Für eine serverseitige Zählung verwenden Sie openai responses input-tokens count.
Ausgabe erhalten, die ein Skript parsen kann
Die Standardausgabe ist lesbarer Text, auch wenn sie gepipet wird. Fordern Sie Daten explizit an:
openai models list --format jsonl | jq '.id'
openai files list --format json > files.json
openai files get file-example --transform filename --raw-output
--format akzeptiert auto, text, json, jsonl, yaml, explore (einen interaktiven JSON-Viewer) und pretty. --transform extrahiert Felder mit GJSON-Syntax, und jq erledigt alles Ausgefallenere. Prüfen Sie immer den Exit-Status, bevor Sie einer umgeleiteten Datei vertrauen: Eine fehlgeschlagene Anfrage kann eine unvollständige hinterlassen.
Wenn sich ein Aufruf fehlerhaft verhält, fügt --debug HTTP-Timing pro Versuch hinzu; bereinigen Sie seine Logs, bevor Sie sie teilen. Wenn Sie auf 429er stoßen, erklärt unser OpenAI-Rate-Limits-Leitfaden die Stufen.
OpenAI CLI vs. Codex CLI vs. der alte openai-Befehl
Drei Tools teilen einen Anbieter, und zwei teilen einen Namen. Dies ist die Kurzversion:
| OpenAI CLI | Codex CLI | Legacy Python openai |
|
|---|---|---|---|
| Befehl | openai |
codex |
openai |
| Was es ist | Ein Client für die REST API | Ein Coding-Agent, der Code in Ihrem Projekt liest, bearbeitet und ausführt | Eine CLI, die mit dem openai-Python-Paket gebündelt ist |
| Installation | Binärdatei, Homebrew oder Go | npm install -g @openai/codex oder brew install --cask codex |
pip install openai |
| Authentifizierung | OPENAI_API_KEY |
Behandelt seine eigene Anmeldung | API-Schlüssel |
| Verwenden Sie es, wenn | Sie einen bestimmten API-Aufruf oder API-Schritte in einem Skript möchten | Sie möchten, dass ein Agent eine Änderung implementiert oder debuggt | Sie ältere Skripte pflegen, die darauf aufbauen |
Führen Sie openai codex aus, und die OpenAI CLI gibt selbst Codex-Installationsbefehle aus und weist darauf hin, dass es ein separates Tool mit eigener Anmeldung ist. Unser Codex CLI-Leitfaden behandelt die Agent-Seite, und der Quellcode liegt unter github.com/openai/codex.
Achten Sie auf den PATH-Konflikt
Das openai-Python-Paket installiert ebenfalls eine Binärdatei namens openai. Wenn Sie jemals pip install openai ausgeführt haben, haben Sie möglicherweise zwei:
Auf diesem Mac meldet die Python-Version openai 2.30.0 und bietet die Unterbefehle api, tools, migrate und grit; die Go-Version meldet openai version 1.44.1. Welches Verzeichnis in Ihrem PATH zuerst kommt, gewinnt. Führen Sie nach der Installation which -a openai und openai --version aus. Wenn die Ausgabe openai version 1.44.1 (oder neuer) sagt, haben Sie die richtige. Wenn sie eine bloße Versionsnummer wie openai 2.30.0 ausgibt, ordnen Sie Ihren PATH neu oder rufen Sie die neue Binärdatei mit ihrem vollständigen Pfad auf.
Wo die Apidog CLI neben der OpenAI CLI passt
Die OpenAI CLI macht Aufrufe an OpenAI. Sie weiß nichts über Ihre eigene API: die Endpunkte, die Ihre App zusätzlich zu OpenAI bereitstellt, die Umgebungen, in die Sie deployen, oder die Assertions, die beweisen, dass ein Release nichts kaputt gemacht hat. Das ist eine andere Aufgabe, und hier kommt die Apidog CLI ins Spiel. Sie wählen nicht eine statt der anderen; die meisten Teams, die ein KI-Feature ausliefern, wollen beide.
Noch besser: Lassen Sie Ihren Coding-Agent beide ausführen. Richten Sie die Apidog CLI einmal ein:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted
Dann geben Sie Ihrem Agent einen Prompt:
Use the openai CLI to confirm my key works with one responses create call on gpt-5.5.
Then import ./openapi.yaml into Apidog project <id>, create a test case for
POST /v1/summarize that asserts a 200 and a non-empty "summary" field, run it
against the staging environment and summarize any failures.
Der Agent prüft den Schlüssel mit openai und arbeitet dann die Apidog CLI durch. Er liest das Schema, bevor er eine Payload schreibt, validiert die Datei und erstellt und führt erst dann den Testfall aus:
apidog import --project <id> --format openapi --file ./openapi.yaml
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file case.json
apidog run --test-case <caseId> --project <id> -e <envId> -r cli,json
Zwei Details aus apidog test-case create --help sparen einen Roundtrip: Der Testfall benötigt eine gültige categoryId (listen Sie sie mit apidog test-case category --project <id> auf), und Payloads sollten aus cli-schema stammen, niemals aus dem Gedächtnis. Dieselbe apidog run-Zeile mit -r junit lässt sich in CI einbinden, wie unser Apidog CLI CI/CD-Leitfaden zeigt. Wenn Codex Ihr Agent ist, beginnen Sie mit Apidog CLI in Codex.
Der kostenlose Plan von Apidog deckt bis zu 4 Benutzer ab, sodass ein kleines Team dies ohne Kaufentscheidung ausprobieren kann.
FAQ
Ist die OpenAI CLI kostenlos? Das Tool ist kostenlos und Open Source unter Apache 2.0. Die API-Aufrufe, die es macht, werden Ihrem OpenAI-Konto zu normalen API-Preisen in Rechnung gestellt. Lokale Befehle wie openai tokenizer und jede --help-Seite kosten nichts und benötigen keinen Schlüssel.
Ist die OpenAI CLI dasselbe wie die Codex CLI? Nein. openai sendet direkte API-Anfragen, eine pro Befehl. codex ist ein Coding-Agent, der Ihr Projekt liest und bearbeitet und Befehle ausführt. Sie werden separat installiert und separat authentifiziert.
Wie installiere ich die OpenAI CLI auf einem Mac? Führen Sie brew install openai/tools/openai aus oder laden Sie die macos_arm64- (Apple Silicon) oder macos_amd64- (Intel) Zip-Datei von GitHub Releases herunter und legen Sie die Binärdatei in Ihren PATH. Führen Sie dann openai --version aus, um zu bestätigen, dass Sie nicht den älteren Python-openai-Befehl erwischen.
Funktioniert die OpenAI CLI in Shell-Skripten und CI? Ja, das ist ihr Hauptentwurfsziel. Verwenden Sie --format json oder jsonl für parsebare Ausgabe, prüfen Sie den Exit-Status, halten Sie den Schlüssel in OPENAI_API_KEY aus Ihrem Secret Manager und setzen Sie OPENAI_CLI_NO_AUTO_UPDATE=1, um die Version gepinnt zu halten.
Wann wurde die OpenAI CLI veröffentlicht? Version 1.0.0 wurde am 5. Mai 2026 auf GitHub veröffentlicht. Stand 28. Oktober 2026 ist die neueste Version 1.44.1 vom 27. Oktober.