Tutorial a prova di principiante: usare Codex senza problemi in Cina, testato ed efficace

Ciao a tutti, sono Cang He.

Dopo che CodexGuide è andato online l'altro ieri, il backend è esploso.

La domanda più frequente è: Come si usa Codex in Cina? Posso usarlo senza un abbonamento Plus?

A essere sincero, capisco questa frustrazione.

Abbonarsi a Plus ha le sue barriere, e poi bisogna capire come pagare; è una scocciatura.

Così ho passato due giorni a testare ogni soluzione che ho trovato online, ho fatto molti errori e alla fine ho riassunto i tre metodi di accesso più affidabili.

Oggi li condivido tutti con voi: basta seguire i passaggi.

Il tutorial è anche disponibile su CodexGuide per essere consultato in qualsiasi momento.

Visto quanto ci ho lavorato, lasciate una stellina, ahahah.

Prima di tutto, un prerequisito: il modo più stabile per usare Codex è comunque accedere con un account GPT ufficiale.

Connettersi a un'API di terze parti è un'operazione avanzata; devi sapere cosa sono config.toml, API Key e Base URL.

Se non lo sai, nessun problema: segui e basta i passaggi qui sotto.

Come Scegliere tra i Tre Schemi

Ecco una tabella per trovare quello che fa per te:

Onestamente, se sei un principiante, guarda solo lo Schema 2; è quello con meno pensieri.

Se stai appena iniziando a imparare Codex, ti suggerisco di dare un'occhiata al mio tutorial precedente per principianti su Codex prima di mettere mano alle API di terze parti.

Schema 1: Configurazione Manuale

Questo metodo ha uno svantaggio: non puoi usare la funzione plugin dell'app Codex.

Se vuoi usare i plugin, salta direttamente allo Schema 2.

Il cuore della configurazione manuale è modificare un file:

Prima di modificare, fai un backup—abituati alle buone abitudini:

Due Approcci di Accesso

Un consiglio: non cambiare troppe cose in una volta. Aggiungi prima un solo provider e, una volta che funziona, allora metti mano a configurazioni multiple.

Esempio di Stato di Accesso GPT

Questo significa che il tuo Codex deve prima essere connesso a un account GPT.

Passo 1: Modifica il file di configurazione:

Apri ~/.codex/config.toml e aggiungi la seguente configurazione.

Nota: compila i campi e i valori in base al tuo servizio effettivo:

Alcuni errori comuni:

• model_provider deve essere identico a xxx in [model_providers.xxx]; non un solo carattere di differenza.
• base_url deve arrivare solo fino a /v1; non includere l'intero segmento /v1/responses.
• wire_api = "responses" significa richiedere nel formato API Responses; non cambiarlo.
• requires_openai_auth = false significa non usare lo stato di accesso ufficiale.

Passo 2: Imposta le variabili d'ambiente

Apri il terminale e digita:

Passo 3: Avvia l'app Codex dal terminale

C'è un trucco qui: gli utenti Mac devono avviarlo dal terminale; cliccando direttamente l'icona potrebbe non leggere il modello.

Chiudi completamente l'app Codex prima di avviarla, poi digita nel terminale:

Passo 4: Verifica l'effetto

Apri l'app Codex e vedrai che il modello è stato cambiato con successo:

Santo cielo, sta decollando.

Esempio di Accesso con API Key

Se stai usando il metodo API Key, ricorda un principio: metti la chiave segreta nelle variabili d'ambiente, non scriverla direttamente nel file di configurazione.

Configurazione config.toml corrispondente:

Una cosa da notare: se il tuo fornitore upstream supporta solo Chat Completions e non Responses API, solo modificare la configurazione non basta; devi usare un gateway come CCX per la conversione del protocollo, di cui parleremo nello Schema 3.

Modifica il file di autenticazione

Apri ~/.codex/auth.json e cambia OPENAI_API_KEY con la Key del tuo fornitore di modello:

Come Verificare il Successo della Configurazione

Non avere fretta dopo aver configurato; verifica prima:

1. Esci completamente da Codex e riaprirlo.
2. Fagli eseguire un'attività di sola lettura, come riassumere la struttura della directory corrente.
3. Se dà errore, controlla prima il nome model_provider, base_url e le variabili d'ambiente.
4. Se si verifica un errore di autenticazione, torna prima alla configurazione di backup; niente panico.

Schema 2: Codex++

Se trovi la configurazione manuale troppo complicata, dai un'occhiata a Codex++.

È uno strumento di gestione grafica che ti aiuta a gestire le configurazioni del relay con un clic, senza dover scrivere file toml a mano.

Inoltre, supporta le funzioni dei plugin, cosa che lo Schema 1 non può fare.

Adatto a queste persone:

• Chi usa principalmente l'app desktop Codex.
• Chi non vuole scrivere file di configurazione a mano.
• Chi vuole tornare alla modalità ufficiale in qualsiasi momento.

Passaggi di Installazione

1. Apri Codex++ Releases e scarica il pacchetto di installazione.

Vedrai due pacchetti di installazione: "Codex++ Management Tool" e "Codex++ app"; installali entrambi.

1. Apri il "Codex++ Management Tool" dopo l'installazione.

Se appare questo errore la prima volta che lo apri, niente panico:

Vai su "Impostazioni di Sistema" - "Privacy e Sicurezza" e clicca su "Apri comunque":

Dopo l'apertura, entra nell'interfaccia di gestione:

Installa l'app Codex++ allo stesso modo; è corretto se il rilevamento del management tool è tutto verde:

Conferma che lo stato di accesso GPT è stato rilevato.

1. Aggiungi la configurazione del relay.

Seleziona "Configurazione Provider" - Aggiungi Provider e inserisci il tuo Base URL e Key.

Nota: seleziona "Pure API" per il metodo di accesso:

La lista dei modelli può essere ottenuta automaticamente dall'upstream; se stai configurando una stazione di relay, ci saranno molti modelli tra cui scegliere qui:

In sostanza, questo strumento ti aiuta a scrivere le configurazioni più comodamente, risparmiandoti la modifica manuale dei file:

Testa la connettività dopo aver salvato; se non ci sono problemi, usalo direttamente:

1. Avvia Codex dal punto di ingresso di Codex++.

Nota: avvia da Codex++, non dal Codex originale:

Dopo il riavvio, vedrai che Codex sta già usando il provider di modello personalizzato e il numero di modelli opzionali è improvvisamente aumentato:

I plugin possono anche essere usati direttamente; questa è l'esperienza completa:

Devi ammetterlo, questo schema è il più fluido che abbia usato finora; lo consiglio vivamente.

E se volessi tornare indietro?

• Pulisci la modalità API nel management tool e torna alla configurazione ufficiale.
• Se Codex++ smette di funzionare dopo un aggiornamento di Codex, aspetta solo che venga adattato; non influisce sull'uso della versione originale.

Schema 3: CCX + CC Switch

Questo schema è adatto agli utenti esperti, separando il "gateway" e lo "strumento di cambio":

• CCX: Gateway proxy API, responsabile della conversione del protocollo e del routing. Supporta vari punti di ingresso come Claude, OpenAI, Codex, Gemini, ecc.
• CC Switch: Strumento di gestione desktop, cambio con un clic di diverse configurazioni del provider.

Quando usare questo schema? Quando hai più API di modelli domestici, più servizi di relay, più Key, o quando l'upstream supporta solo Chat Completions e necessita di conversione a Responses API.

Passo 1: Distribuisci CCX

Usa Docker con un singolo comando:

Dopo l'avvio, puoi vederlo aprendo il browser.

Passo 2: Aggiungi Canali Upstream

Aggiungi i tuoi canali nell'interfaccia di gestione CCX:

1. Seleziona il tipo di servizio upstream.
2. Inserisci API Key e Base URL.
3. Configura il mapping dei modelli e le regole di routing.
4. Usa la funzione di test integrata per confermare la connettività.

C'è un punto chiave qui: Codex ha bisogno di un punto di ingresso API Responses. Se l'upstream ha solo Chat Completions, CCX ti aiuterà a eseguire la conversione del protocollo, che è la ragione principale per usarlo.

Passo 3: Installa CC Switch

Installazione da riga di comando:

Inizializzazione:

Durante l'inizializzazione, inserisci l'indirizzo CCX come punto di ingresso del relay.

Passo 4: Cambia Configurazione e Avvia

Comando a riga singola per cambiare provider:

Poi riavvia Codex per farlo effettivo.

Dopo il cambio, si consiglia di aprire ~/.codex/config.toml per verificare:

• model_provider è quello che hai appena selezionato?
• base_url punta a CCX?
• Hai accidentalmente scritto la Key in un repository pubblico (questo è molto importante)?

Riepilogo degli Errori Comuni

Per finire, ecco una tabella per la risoluzione dei problemi; controllala prima se incontri problemi:

A essere sincero, ho eseguito con successo tutti e tre gli schemi, ma quello che uso di più per l'uso quotidiano è lo Schema 2, Codex++; è senza pensieri.

Se sei quel tipo di utente esperto con diverse Key e diversi provider, lo Schema 3 è più adatto a te.

Bene, per oggi è tutto.

Se questo tutorial ti è stato utile, lascia un like per farmelo sapere, e continuerò ad aggiornare con altri trucchi pratici su Codex in futuro.

Se hai domande, chiedi direttamente nei commenti; risponderò a tutte quelle che vedo.