Come usare Codex — dall'installazione all'uso con una chiave API senza abbonamento, fino al costo effettivo di un'attività

Codex è l’agente di coding di OpenAI. Per iniziare, installa Codex CLI, che viene eseguito nel terminale (npm install -g @openai/codex), quindi esegui codex nel repository su cui lavorare e fai la richiesta in coreano. Esistono due modi per iniziare: accedere con un piano ChatGPT (Plus · Pro · Business ecc.) e usare il consumo incluso, oppure eseguirlo con una chiave API e pagare solo i token utilizzati. Poiché quasi tutti gli articoli coreani sull’utilizzo descrivono solo il primo metodo, questo articolo tratta il secondo — come eseguire Codex CLI senza abbonamento, come scegliere il modello per ogni attività e il costo effettivo di una singola attività — in ordine. I limiti di utilizzo per piano e le opzioni disponibili dopo averli esauriti sono riepilogati separatamente in Limiti di utilizzo di Codex.

Codex non è uno strumento in cui incollare codice nella chat: è un agente che legge e modifica i file nel repository ed esegue test e comandi. Dopo l’avvio puoi decidere cosa affidargli senza verifica tramite /permissions.

I due modi per usare Codex

Con una chiave API, la fatturazione viene calcolata separatamente dal consumo del piano ChatGPT. Puoi usare direttamente una chiave API OpenAI, ma questo articolo descrive come collegarsi a un endpoint compatibile con la Responses API. Con la stessa chiave puoi alternare modelli da GPT-6 Astra a GPT-5.6 Terra; ad esempio, GPT-5.6 Sol costa $2,00 / $12,00 per 1M di token, rispetto al prezzo ufficiale OpenAI di $5,00 / $30,00(OpenAI lo offre attualmente al prezzo promozionale di $4,00 / $20,00, che secondo la pagina dei prezzi resterà in vigore almeno fino al 21 novembre 2026) (le tariffe vengono lette direttamente dal catalogo).

Installazione di Codex — npm o Homebrew

# npm (Node.js만 있으면 macOS / Linux / Windows 공통)
npm install -g @openai/codex

# Homebrew (macOS)
brew install --cask codex

Entrambi i metodi sono riportati nel README ufficiale di OpenAI. Anche su Windows l’installazione avviene con il comando npm. Al termine, digita codex nella directory del repository su cui lavorare per avviare il programma. Se intendi usarlo accedendo con ChatGPT, puoi fermarti qui; non servono le impostazioni seguenti.

Emissione e configurazione della chiave API Codex — un blocco in config.toml

Per prima cosa crea un account e ricarica almeno $10, quindi crea la chiave nella schermata delle chiavi API. La chiave viene mostrata una sola volta, quindi salvala subito. Poi aggiungi un blocco del provider al file di configurazione di Codex.

# ~/.codex/config.toml (없으면 새로 만듭니다)
model          = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name     = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key  = "KUNAVO_API_KEY"   # 키 자체가 아니라 「환경 변수 이름」
wire_api = "responses"        # 유일하게 유효한 값. 생략해도 같습니다

Il punto in cui si commettono più errori è env_key. Qui devi inserire il nome della variabile d’ambiente che conterrà la chiave, non la chiave stessa. Poiché la chiave non entra nel file di configurazione, config.toml può essere sottoposto a commit o incollato in una richiesta senza rischi.

# env_key에 적은 이름의 변수에 키를 넣습니다 (키는 sk-kn-으로 시작)
export KUNAVO_API_KEY="sk-kn-..."

# 매번 export하지 않도록, 쓰는 셸의 설정 파일에 추가해 둡니다
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

In Windows PowerShell, esegui setx KUNAVO_API_KEY sk-kn-... e poi apri un nuovo terminale. Il file di configurazione si trova in %USERPROFILE%\.codex\config.toml. Prima di eseguire Codex, verificare chiave ed endpoint con una richiesta rende più semplice isolare i problemi.

# 코덱스를 의심하기 전에, 키와 엔드포인트만 요청 한 번으로 확인합니다
curl https://api.kunavo.com/v1/responses \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5-6-sol", "input": "OK라고만 답해줘"}'

Se viene restituito JSON, chiave ed endpoint sono corretti e il problema rimanente riguarda config.toml. Le impostazioni sono descritte in Documentazione sull’integrazione con Codex CLI (inglese); la spiegazione di come chiamare modelli Claude da Codex è disponibile in Guida alle chiavi API di Codex CLI (inglese).

Prima attività

# 1. 작업할 저장소로 들어가 실행합니다
cd ~/work/my-app
codex

# 2. AGENTS.md 초안을 만들게 합니다 (테스트 실행법이나 규칙을 적는 파일)
> /init

# 3. 이후엔 한국어로 요청합니다. 파일 경로를 붙일수록 빠르고 싸게 끝납니다
> src/utils/date.test.ts가 실패해. 원인을 찾아서 고치고 테스트가 통과하는지 확인해줘

Il file AGENTS.md creato da /init contiene regole che «non puoi sapere semplicemente leggendo il codice», come come eseguire i test, quali librerie usare e quali percorsi non modificare; viene letto automaticamente nelle sessioni successive. Il contenuto generato è una bozza, quindi rifiniscilo manualmente.

I suggerimenti per le richieste sono gli stessi di Claude Code. Includi il percorso del file e non affidare un’attività enorme tutta in una volta. Ridurrai i token usati per l’esplorazione, ottenendo risultati più rapidi e accurati e una fattura più bassa. Le procedure operative per Claude Code sono raccolte in Come usare Claude Code.

Scegliere il modello per ogni attività — il costo effettivo di una singola attività

Il principale vantaggio dell’esecuzione con una chiave API è poter scegliere il modello in base al peso dell’attività. model è solo il nome del modello dell’endpoint, quindi per cambiarlo non servono una nuova chiave o impostazioni aggiuntive.

# config.toml의 기본값(gpt-5-6-sol)은 그대로 두고, 이번 실행만 모델을 바꿉니다
codex -m gpt-6-astra     # 원인을 모르는 버그, 여러 모듈에 걸친 변경
codex -m gpt-5-6-terra   # 정형화된 수정, 일괄 치환, 로그 요약 같은 가벼운 작업

Per «una singola attività» si considera la correzione di un test fallito in 20 passaggi. Un passaggio comprende 25.000 token di input (prompt di sistema + cronologia della conversazione + file letti) e 1.200 token di output (una modifica o spiegazione), quindi una singola attività utilizza 500.000 token di input e 24.000 di output. Con GPT-5.6 Sol il risultato è $1,29, pagando gli stessi token direttamente a OpenAI al prezzo promozionale attuale: $2,48(al prezzo ufficiale: $3,22). I modelli economici possono richiedere più andirivieni per correggere e ricorreggere; se non termina al primo tentativo, aumentare di un livello è l’approccio più realistico. Per inserire direttamente il tuo numero di token, usa il calcolatore dei costi.

Questo calcolo non considera la cache. Codex reinvia la cronologia della conversazione a ogni passaggio, quindi l’input già memorizzato nella cache viene fatturato a 0,10 volte la tariffa di input (per GPT-5.6 Sol, $0,20 per 1M di token), mentre la parte scritta per la prima volta nella cache viene fatturata a 1,25 volte la tariffa di input. Inoltre, per la serie GPT-5.6 e GPT-6 Astra, se il prompt di una richiesta supera 272K token, l’intera richiesta viene fatturata a 2 volte la tariffa di input e 1,5 volte la tariffa di output. Non concentrare troppe attività in una sola sessione: è più sicuro avviare una nuova esecuzione per ogni attività. I token di ragionamento dei modelli di ragionamento vengono fatturati come output, quindi le attività difficili aumentano anche l’output. Controlla l’importo effettivo in usage nella risposta e nei Dettagli di utilizzo. Le specifiche del modello sono nella pagina del modello GPT-5.6 Sol, le tariffe complete nel listino prezzi e il confronto affiancato delle tariffe per token dei modelli GPT usati da Codex in Prezzi dell’API GPT.

Errori frequenti

Con franchezza — quando il piano ChatGPT è migliore

Se lavori con Codex per diverse ore ogni giorno, un piano a tariffa fissa è generalmente più economico. La fatturazione a consumo è direttamente proporzionale ai token, quindi più l’utilizzo è intenso e costante, maggiore è il vantaggio del piano fisso. Il criterio è «canone mensile ÷ costo di una singola attività»; il punto di pareggio rispetto al piano è calcolato in Prezzi di Codex.

Ci sono altri due aspetti da sapere. Secondo la documentazione OpenAI, le funzioni che dipendono da workspace ChatGPT o dal cloud possono essere limitate o non disponibili quando usi una chiave API. Inoltre, il percorso Kunavo utilizza capacità condivisa, quindi non offre una quota dedicata né uno SLA contrattuale. Se ti servono limiti o SLA garantiti, è più appropriato stipulare un contratto direttamente con OpenAI.

Al contrario, la chiave API è adatta a chi usa il servizio in modo discontinuo, vuole scegliere il modello per ogni attività, vuole dividere limiti e dettagli di utilizzo tra le chiavi del team oppure vuole continuare a lavorare solo nei giorni in cui il limite del piano è esaurito. Puoi usare entrambi i metodi. Elimina la riga model_provider di config.toml per tornare all’accesso ChatGPT; se vuoi cambiare metodo a ogni esecuzione, usa --profile di Codex.

La ricarica Kunavo avviene con carta, Apple Pay, Google Pay e altri metodi; quando la schermata di pagamento è mostrata in won, compaiono anche Kakao Pay, Naver Pay, PAYCO, Samsung Pay e le carte coreane (incluse quelle per cui i pagamenti internazionali non sono abilitati). Toss non è supportato. Il saldo non scade e le richieste fallite non vengono addebitate. Se stai valutando Codex e Claude Code, consulta Codex vs Claude Code.

Domande frequenti