GetAPI.ONE
Configurare Codex CLI per GetAPI.ONE
Installare Codex CLI dalla fonte ufficiale, conservare chiave ONE in variabile, configurare fornitore Responses e verificare connessione.
Ambito e prerequisiti
La guida copre Codex CLI nel terminale. Non prova compatibilità con tutti i client desktop, estensioni IDE, modelli o funzioni Codex.
- Account GetAPI.ONE con saldo utilizzabile o pacchetto.
- Chiave GetAPI.ONE nominata, limitata e privata.
- Modello attuale che elenchi Responses.
- Permesso di installare Codex CLI e modificare configurazione utente.
1. Installare e identificare Codex CLI
Usare la pagina Codex CLI ufficiale attuale per il proprio sistema. L'installatore macOS/Linux esaminato il 2026-09-07 usa il comando seguente. Su Windows seguire la scheda ufficiale Windows, senza eseguire alla cieca comandi Unix.
curl -fsSL https://chatgpt.com/codex/install.sh | shcodex --version2. Caricare la chiave nel terminale
Definire la chiave nel shell prima di avviare Codex. Gli esempi contengono segnaposto intenzionali.
export GETAPI_ONE_API_KEY="replace-with-your-private-key"$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"3. Configurare il fornitore ONE
Aprire config.toml utente (normalmente in .codex) e aggiungere il fornitore. Sostituire YOUR_RESPONSES_MODEL con un modello GetAPI.ONE attuale che dichiari Responses.
model_provider = "getapi_one"
model = "YOUR_RESPONSES_MODEL"
[model_providers.getapi_one]
name = "GetAPI One"
base_url = "https://www.getapi.one/v1"
env_key = "GETAPI_ONE_API_KEY"
wire_api = "responses"4. Eseguire e verificare
- Aprire un nuovo terminale se la variabile è persistente; altrimenti mantenere quello in cui è definita.
- Aprire una directory di progetto ed eseguire codex. Confermare fornitore/modello previsti.
- Inviare una richiesta minima solo accettando eventuale addebito.
- Servono risposta CLI valida e registro GetAPI.ONE corrispondente. Nessuna chiamata a modello effettuata preparando la guida.
Diagnosticare nell'ordine
| Sintomo | Verifiche |
|---|---|
| codex: command not found | Rivedere l'installatore ufficiale del sistema e la directory nel PATH. |
| Missing API key | Confermare GETAPI_ONE_API_KEY nello stesso ambiente che avvia Codex e grafia esatta di env_key. |
| 401 / Unauthorized | Ricopiare chiave ONE, confermare abilitazione e associazione a https://www.getapi.one/v1. |
| 404 / percorso incompatibile | Confermare /v1 in base_url e /v1/responses dichiarato dal gateway. |
| Model not found | Sostituire il segnaposto con nome esatto visibile al gruppo e marcato Responses. |
| Configurazione invariata | Controllare il file utente caricato da Codex, model_provider impostato a getapi_one e riavvio del terminale/client. |