Een site geeft een 502-fout. In plaats van logs in een chatbot te kopiëren, vraagt u een AI-agent op de server om de relevante bestanden te inspecteren en het probleem uit te leggen. Dat is één praktische toepassing van Codex CLI op een Linux VPS.
Deze gids behandelt de installatie, het inloggen vanuit een SSH-sessie en een eerste taak met beperkte rechten. Daarna lichten we de echte test achter onze video toe: Codex herkende een poortmismatch op een opzettelijk kapotte demosite.
Wat waar draait: de Codex-agent en zijn opdrachtregeltools draaien op uw VPS. Bij de hier beschreven OpenAI-configuratie draait het AI-model in de cloud van OpenAI. U hebt uw eigen geschikte ChatGPT-account of afzonderlijk gefactureerde OpenAI API-toegang nodig. Een SharpHeberg VPS bevat die toegang niet.
Voordat u begint
- Een Linux VPS waartoe u via SSH toegang hebt, met uitgaande HTTPS-toegang. De pakketopdrachten hieronder zijn bedoeld voor Debian en Ubuntu.
- Een gewone Linux-gebruiker met sudo voor het installeren van systeempakketten. Draai Codex als die gebruiker, niet als root.
- Een OpenAI-account met toegang tot Codex. Controleer de actuele beschikbaarheid en limieten van uw abonnement; API-facturering staat los van een ChatGPT-abonnement.
- Een testproject of stagingomgeving. Houd productiegegevens en niet-gerelateerde klantbestanden buiten het account en de werkruimte waartoe de agent toegang heeft.
U hoeft de gewichten van het model niet zelf te hosten of een GPU te provisionen voor deze cloudgebaseerde workflow. De resources die uw projecten, buildtools en services verbruiken, blijven wel belangrijk bij het kiezen van een VPS.
Reikwijdte van de validatie: onze diagnosedemonstratie draaide op een wegwerp-Debian 12 VPS met Codex CLI 0.164.0. Dat geïsoleerde experiment gebruikte een bevoorrecht diagnoseaccount; dit is niet de accountopzet die wij voor productie aanbevelen. We hebben ook het officiële standalone installatieprogramma gecontroleerd in een geïsoleerde Linux x86-64-installatiemap en de CLI-versie en de login-/sandboxopties geverifieerd. We hebben niet elke Ubuntu-release of VPS-configuratie getest.
1. Verbind met uw VPS
Maak vanaf uw eigen computer verbinding met uw bestaande non-root SSH-account. Vervang de voorbeeldgebruiker en het voorbeeldadres:
ssh youruser@YOUR_VPS_IP
Heeft uw server alleen een rootaccount, maak en verifieer dan eerst een apart account aan de hand van de beheerinstructies van uw besturingssysteem. U moet een AI-agent geen rootshell geven alleen om te kunnen beginnen.
Installeer op Debian of Ubuntu de download- en projecttools die in deze gids worden gebruikt:
sudo apt update
sudo apt install ca-certificates curl git less
Deze opdrachten installeren systeempakketten; ze upgraden niet de hele server en wijzigen uw firewall niet.
2. Installeer Codex CLI
OpenAI documenteert een standalone installatieprogramma voor macOS en Linux, evenals alternatieven via npm en Homebrew. Voor de standalone route hoeft u niet eerst Node.js en npm te installeren. Zie de officiële installatiegids van Codex CLI.
Download het installatieprogramma naar uw eigen map, zodat u het kunt inspecteren voordat u het uitvoert:
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"
Druk op q om less te verlaten. Voer het script na controle uit als uw gewone gebruiker:
sh "$HOME/codex-setup/install.sh"
export PATH="$HOME/.local/bin:$PATH"
codex --version
codex --help
Het officiële installatieprogramma gebruikt standaard ~/.local/bin en beheert zijn standalone pakket onder uw Codex-gebruikersmap. Het kan het opstartbestand van uw shell bijwerken. Open uw terminal opnieuw wanneer daarom wordt gevraagd; met de bovenstaande export is de standaardinstallatielocatie ook beschikbaar in de huidige sessie.
Als de korte download-URL mislukt: de broncode van het installatieprogramma is ook beschikbaar in de officiële OpenAI Codex-repository. Download die broncode, inspecteer hem en gebruik daarna dezelfde installatiestappen:
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"
Vervang dit niet door een script van een onbekende mirror. Mislukt de download van het binaire bestand zelf, dan documenteert OpenAI CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false om GitHub Releases te selecteren:
CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh "$HOME/codex-setup/install.sh"
Beheert u al een ondersteunde Node.js/npm-installatie, dan is het gedocumenteerde npm-alternatief npm install -g @openai/codex. Kies één installatiemethode in plaats van er meerdere te combineren en dan te moeten uitzoeken welke codex in uw PATH staat.
3. Inloggen vanaf een headless server
Uw VPS heeft meestal geen desktopbrowser. OpenAI raadt voor deze situatie device-code-authenticatie aan:
codex login --device-auth
Open de link die in uw terminal wordt getoond op uw eigen computer of telefoon, log in en voer de eenmalige code in. Mogelijk moet u eerst device-code-login inschakelen in uw ChatGPT-beveiligingsinstellingen, of moet de beheerder van uw werkruimte dit toestaan. Stuur die code nooit naar iemand anders.
Controleer vervolgens de authenticatiemethode:
codex login status
Is device-code-login niet beschikbaar, dan documenteert OpenAI ook een SSH-tunnel voor de normale browserlogin. Start deze verbinding vanaf uw computer:
ssh -L 1455:localhost:1455 youruser@YOUR_VPS_IP
Voer binnen die SSH-sessie codex login uit en open de loginlink in uw lokale browser. Hiermee wordt de localhost-callback doorgestuurd zonder een authenticatiepoort openbaar bloot te stellen. Raadpleeg de instructies van OpenAI voor headless login als uw omgeving een andere callbackconfiguratie gebruikt.
Een API-sleutel gebruiken
Geeft u de voorkeur aan API-toegang op basis van gebruik, stel dan uw eigen OpenAI API-sleutel veilig beschikbaar als omgevingsvariabele en geef hem door via standaardinvoer:
printenv OPENAI_API_KEY | codex login --with-api-key
Plak geen letterlijke API-sleutel in een opdracht die in de shellgeschiedenis wordt opgeslagen. Het API-gebruik wordt gefactureerd via uw OpenAI Platform-account en niet verrekend met uw VPS-hostingfactuur. Behandel de opgeslagen inloggegevens van Codex als wachtwoorden en houd ze buiten repositories, screenshots en supporttickets. De officiële authenticatiegids legt beide methoden uit.
4. Begin met een alleen-lezentaak
Ga naar een testproject waarvan u de bestanden begrijpt. Hebt u er geen, dan volstaat een lege map om de CLI te openen en de interface te bekijken:
mkdir -p "$HOME/codex-first-session"
cd "$HOME/codex-first-session"
codex --sandbox read-only --ask-for-approval on-request
In een echte testrepository is dit een nuttige eerste prompt:
Explain how this project starts. Read the relevant configuration and README files, identify the entry point, and list anything you cannot verify. Do not change files or install packages.
read-only beperkt door het model gegenereerde opdrachten via de geconfigureerde sandbox. Met on-request kan het model om extra goedkeuring vragen; het betekent niet dat elke opdracht automatisch een bevestiging vereist. Lees elk verzoek om verhoogde rechten voordat u beslist of u het toestaat.
Een prompt die zegt “wijzig niets” is op zichzelf geen beveiligingsgrens. Gebruik een apart account en een testomgeving, beperk de toegankelijke gegevens en controleer de rechten die uw geïnstalleerde versie toont. Alleen-lezentoegang kan nog steeds leesbare bestandsinhoud blootstellen aan de modelservice.
Raadpleeg codex --help en de CLI-opdrachtreferentie voordat u vlaggen uit een oudere tutorial overneemt. Omzeil de sandbox of goedkeuringen niet om een installatiefout te omzeilen.
5. Van uitleg naar een nuttige servertaak
Een verstandige volgende stap is Codex een kleine, expliciete diagnosescope te geven. Bereid in een testmap opgeschoonde kopieën van de relevante logs en configuratie voor en vraag dan:
This demo site returns HTTP 502. Inspect only the supplied nginx configuration, application entry point and error log. Explain the cause and propose the smallest fix. Do not edit files, install packages or restart services.
Beoordeel de voorgestelde wijziging voordat u die zelf toepast. Maak voor een echte service een back-up van de configuratie, valideer die met de eigen controle van de service en bereid een rollback voor. Een uitleg van een AI is geen bewijs dat een wijziging veilig is voor productie.
Wat er in onze demonstratie gebeurde
We hebben op een wegwerp-VPS opzettelijk een demosite verkeerd geconfigureerd. Nginx stuurde verzoeken door naar poort 3000, terwijl de applicatie luisterde op 3001. De site gaf HTTP 502 terug.
Codex inspecteerde de geselecteerde configuratie, de applicatie en het foutlog in alleen-lezenmodus. Het herkende de mismatch en stelde in ongeveer 22 seconden een correctie van één regel voor, zonder de aangeleverde bestanden te bewerken. Onze productieoperator paste dat voorstel toe, controleerde de nginx-configuratie, herlaadde de service en verifieerde een HTTP 200-respons.
Dit was één gecontroleerde test met een bekende, opzettelijk geïntroduceerde fout. Het is geen benchmark, geen garantie voor hersteltijd en geen demonstratie van onbeheerd productieherstel.
Als iets niet werkt
codex: command not found: open de terminal opnieuw, controleercommand -v codexen bevestig dat de map van het installatieprogramma in uw PATH staat.- De URL of download van het installatieprogramma is geblokkeerd: gebruik de broncode uit de officiële repository en de hierboven gedocumenteerde selectie van GitHub Releases. Schakel TLS-verificatie niet uit.
- Inloggen kan geen browser openen: gebruik device-code-login of de gedocumenteerde SSH-tunnel. Publiceer geen localhost-authenticatiepoorten.
- U bereikt een gebruikslimiet: controleer het account en de authenticatiemethode die
codex login statustoont. Het installeren van de CLI of het kopen van een VPS heft de gebruikslimieten van OpenAI niet op. - Sandbox- of helperfouten: houd de volledige officiële installatie bij elkaar en controleer of uw distributie de vereiste isolatiemechanismen ondersteunt. Een container of beperkte VPS kan extra beperkingen hebben. Los dit niet op door Codex als root te draaien of de beveiligingen uit te schakelen.
Bekijk de demonstratie en probeer het daarna op uw eigen VPS
Onze bijbehorende video volgt het diagnosevoorbeeld van de kapotte site tot de geverifieerde respons. Hij laat zien waarbij de geïnstalleerde agent u kan helpen bij het onderzoek; de installatieopdrachten staan in deze gids.
Gecontroleerde demonstratie op een wegwerp-test-VPS: Codex stelt de oplossing voor; onze operator past die toe en verifieert hem. Bekijk de demonstratie op YouTube.
Begin met een testproject, houd de rechten van de agent beperkt en verifieer elk resultaat. Hebt u een server nodig voor die werkruimte, ontdek dan de Linux VPS-pakketten van SharpHeberg. Uw OpenAI-account en -gebruik blijven los van de hostingdienst.