Un sito restituisce un errore 502. Invece di copiare i log in un chatbot, chiede a un agente IA sul server di ispezionare i file rilevanti e di spiegare il problema. È un uso pratico di Codex CLI su un VPS Linux.
Questa guida copre l'installazione, l'accesso da una sessione SSH e una prima attività con permessi limitati. Spieghiamo poi il vero test dietro il nostro video: Codex ha individuato una discrepanza di porta su un sito demo volutamente guasto.
Cosa viene eseguito e dove: l'agente Codex e i suoi strumenti a riga di comando funzionano sul suo VPS. Con la configurazione OpenAI descritta qui, il modello di IA gira nel cloud di OpenAI. Le serve un account ChatGPT idoneo di sua proprietà oppure un accesso API OpenAI fatturato separatamente. Un VPS SharpHeberg non include questo accesso.
Prima di iniziare
- Un VPS Linux accessibile tramite SSH, con accesso HTTPS in uscita. I comandi dei pacchetti qui sotto riguardano Debian e Ubuntu.
- Un utente Linux normale con sudo disponibile per installare i pacchetti di sistema. Esegua Codex con quell'utente, non come root.
- Un account OpenAI con accesso a Codex. Verifichi la disponibilità e i limiti attuali del suo piano; la fatturazione API è separata da un abbonamento ChatGPT.
- Un progetto di prova o un ambiente di staging. Tenga le credenziali di produzione e i file dei clienti non pertinenti fuori dall'account e dal workspace accessibili all'agente.
Per questo flusso di lavoro basato sul cloud non è necessario ospitare i pesi del modello né predisporre una GPU. Le risorse consumate dai suoi progetti, dagli strumenti di build e dai servizi restano comunque importanti nella scelta di un VPS.
Ambito di validazione: la nostra dimostrazione diagnostica è stata eseguita su un VPS Debian 12 usa e getta con Codex CLI 0.164.0. Quell'esperimento isolato ha usato un account di diagnostica con privilegi elevati; non è la configurazione dell'account che raccomandiamo per la produzione. Abbiamo inoltre verificato l'installer standalone ufficiale in una directory di installazione Linux x86-64 isolata e controllato la versione della CLI e le opzioni di login/sandbox. Non abbiamo testato ogni release di Ubuntu né ogni configurazione di VPS.
1. Si colleghi al suo VPS
Dal suo computer, si colleghi con l'account SSH non root già esistente. Sostituisca l'utente e l'indirizzo di esempio:
ssh youruser@YOUR_VPS_IP
Se il suo server ha solo un account root, crei e verifichi prima un account separato seguendo le istruzioni di amministrazione del suo sistema operativo. Non dovrebbe dare a un agente IA una shell root solo per iniziare.
Su Debian o Ubuntu, installi gli strumenti di download e di progetto usati in questa guida:
sudo apt update
sudo apt install ca-certificates curl git less
Questi comandi installano pacchetti di sistema; non aggiornano l'intero server né modificano il firewall.
2. Installi Codex CLI
OpenAI documenta un installer standalone per macOS e Linux, oltre alle alternative npm e Homebrew. La strada standalone non richiede di installare prima Node.js e npm. Consulti la guida ufficiale all'installazione di Codex CLI.
Scarichi l'installer nella sua directory in modo da poterlo ispezionare prima di eseguirlo:
mkdir -p "$HOME/codex-setup"
curl -fsSL https://chatgpt.com/codex/install.sh -o "$HOME/codex-setup/install.sh"
less "$HOME/codex-setup/install.sh"
Prema q per uscire da less. Dopo aver esaminato lo script, lo esegua con il suo utente normale:
sh "$HOME/codex-setup/install.sh"
export PATH="$HOME/.local/bin:$PATH"
codex --version
codex --help
L'installer ufficiale usa per impostazione predefinita ~/.local/bin e gestisce il proprio pacchetto standalone nella directory utente di Codex. Può aggiornare il file di avvio della sua shell. Riapra il terminale quando richiesto; anche l'export qui sopra rende disponibile il percorso di installazione predefinito nella sessione corrente.
Se l'URL di download breve non funziona: il sorgente dell'installer è disponibile anche nel repository ufficiale di OpenAI Codex. Scarichi quel sorgente, lo ispezioni, poi segua gli stessi passaggi di installazione:
curl -fsSL https://raw.githubusercontent.com/openai/codex/main/scripts/install/install.sh -o "$HOME/codex-setup/install.sh"
less "$HOME/codex-setup/install.sh"
sh "$HOME/codex-setup/install.sh"
Non lo sostituisca con uno script proveniente da un mirror sconosciuto. Se a fallire è il download del binario, OpenAI documenta CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false per selezionare GitHub Releases:
CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh "$HOME/codex-setup/install.sh"
Se gestisce già un'installazione supportata di Node.js/npm, l'alternativa npm documentata è npm install -g @openai/codex. Scelga un solo metodo di installazione, invece di mescolarne diversi e chiedersi quale codex si trovi nel PATH.
3. Acceda da un server headless
Il suo VPS di solito non ha un browser desktop. OpenAI raccomanda l'autenticazione con codice dispositivo per questa situazione:
codex login --device-auth
Segua il link mostrato nel terminale dal suo computer o dal suo telefono, acceda e inserisca il codice monouso. Potrebbe essere necessario prima abilitare l'accesso con codice dispositivo nelle impostazioni di sicurezza di ChatGPT, oppure chiedere all'amministratore del suo workspace di consentirlo. Non invii mai quel codice a nessuno.
Poi controlli il metodo di autenticazione:
codex login status
Se l'accesso con codice dispositivo non è disponibile, OpenAI documenta anche un tunnel SSH per il normale flusso di login via browser. Avvii questa connessione dal suo computer:
ssh -L 1455:localhost:1455 youruser@YOUR_VPS_IP
All'interno di quella sessione SSH, esegua codex login e apra il link di accesso nel browser locale. In questo modo il callback su localhost viene inoltrato senza esporre pubblicamente una porta di autenticazione. Consulti le istruzioni di OpenAI per il login su dispositivi headless se il suo ambiente usa una diversa configurazione del callback.
Usare invece una chiave API
Se preferisce un accesso API a consumo, predisponga in modo sicuro la sua chiave API OpenAI come variabile d'ambiente, quindi la passi tramite standard input:
printenv OPENAI_API_KEY | codex login --with-api-key
Non incolli una chiave API in chiaro in un comando salvato nella cronologia della shell. L'uso dell'API viene fatturato tramite il suo account OpenAI Platform e non viene detratto dalla fattura dell'hosting del VPS. Tratti le credenziali memorizzate da Codex come password e le tenga fuori da repository, screenshot e ticket di supporto. La guida ufficiale all'autenticazione spiega entrambi i metodi.
4. Inizi con un'attività in sola lettura
Si sposti in un progetto di prova di cui conosce i file. Se non ne ha uno, una directory vuota basta per aprire la CLI e ispezionare l'interfaccia:
mkdir -p "$HOME/codex-first-session"
cd "$HOME/codex-first-session"
codex --sandbox read-only --ask-for-approval on-request
In un vero repository di prova, un primo prompt utile è:
Spiega come si avvia questo progetto. Leggi i file di configurazione e il README rilevanti, individua il punto di ingresso ed elenca tutto ciò che non sei in grado di verificare. Non modificare file e non installare pacchetti.
read-only limita i comandi generati dal modello tramite la sandbox configurata. on-request consente al modello di chiedere un'approvazione aggiuntiva; non significa che ogni comando richieda automaticamente una conferma. Legga ogni richiesta di escalation prima di decidere se consentirla.
Un prompt che dice “non modificare nulla” non è di per sé un confine di sicurezza. Usi un account dedicato e un ambiente di prova, limiti i dati accessibili e controlli i permessi presentati dalla versione installata. L'accesso in sola lettura può comunque esporre al servizio del modello il contenuto dei file leggibili.
Consulti codex --help e il riferimento dei comandi della CLI prima di copiare flag da un tutorial più vecchio. Eviti di aggirare la sandbox o le approvazioni per risolvere un errore di installazione.
5. Passi da una spiegazione a un'attività utile sul server
Un passo successivo sensato è assegnare a Codex un ambito diagnostico piccolo ed esplicito. Prepari copie ripulite dei log e della configurazione rilevanti all'interno di una directory di prova, poi chieda:
Questo sito demo restituisce HTTP 502. Ispeziona solo la configurazione nginx fornita, il punto di ingresso dell'applicazione e il log degli errori. Spiega la causa e proponi la correzione più piccola possibile. Non modificare file, non installare pacchetti e non riavviare servizi.
Riveda la modifica proposta prima di applicarla personalmente. Per un servizio reale, esegua il backup della configurazione, la convalidi con il controllo proprio del servizio e prepari un rollback. La spiegazione di un'IA non è la prova che una modifica sia sicura per la produzione.
Cosa è successo nella nostra dimostrazione
Abbiamo configurato volutamente in modo errato un sito demo su un VPS usa e getta. Nginx inoltrava le richieste alla porta 3000, mentre l'applicazione era in ascolto sulla 3001. Il sito restituiva HTTP 502.
Codex ha ispezionato in modalità di sola lettura la configurazione, l'applicazione e il log degli errori selezionati. Ha individuato la discrepanza e proposto una correzione di una sola riga in circa 22 secondi, senza modificare i file forniti. Il nostro operatore di produzione ha applicato la proposta, controllato la configurazione di nginx, ricaricato il servizio e verificato una risposta HTTP 200.
È stato un unico test controllato con un guasto noto, introdotto deliberatamente. Non è un benchmark, né una garanzia sui tempi di riparazione, né una dimostrazione di ripristino in produzione senza supervisione.
Se qualcosa non funziona
codex: command not found: riapra il terminale, controllicommand -v codexe verifichi che la directory dell'installer sia nel PATH.- L'URL dell'installer o il download è bloccato: usi il sorgente del repository ufficiale e la selezione di GitHub Releases documentata qui sopra. Non disattivi la verifica TLS.
- Il login non riesce ad aprire un browser: usi l'accesso con codice dispositivo o il tunnel SSH documentato. Non pubblichi le porte di autenticazione di localhost.
- Ha raggiunto un limite di utilizzo: controlli l'account e il metodo di autenticazione mostrati da
codex login status. Installare la CLI o acquistare un VPS non elimina i limiti di utilizzo di OpenAI. - Errori di sandbox o di helper: mantenga integra l'intera installazione ufficiale e verifichi il supporto della sua distribuzione per i meccanismi di isolamento richiesti. Un container o un VPS con restrizioni può avere ulteriori vincoli. Non risolva il problema eseguendo Codex come root o disattivando le sue protezioni.
Guardi la dimostrazione, poi provi sul suo VPS
Il video che accompagna questa guida segue l'esempio diagnostico dal sito guasto fino alla risposta verificata. Mostra su cosa l'agente installato può aiutarla a indagare; i comandi di installazione si trovano in questa guida.
Dimostrazione controllata su un VPS di prova usa e getta: Codex propone la correzione; il nostro operatore la applica e la verifica. Guardi la dimostrazione su YouTube.
Inizi con un progetto di prova, mantenga ristretti i permessi dell'agente e verifichi ogni risultato. Se le serve un server per quel workspace, scopra i piani VPS Linux di SharpHeberg. Il suo account OpenAI e il relativo utilizzo restano separati dal servizio di hosting.