OpenAI Codex: mikä se on, miten se asennetaan ja alueellisen käytön ehdot vuonna 2026

Sana ”Codex” tarkoittaa hakutuloksissa kolmea eri asiaa, eivätkä sitä ensimmäistä kertaa etsivät yleensä ymmärrä, mitä ovat löytäneet. Codex-malli oli olemassa, mutta se poistettiin käytöstä vuonna 2023. Nykyään nimi kuuluu agenttiohjelmalle, ja samalla nimellä on liikkeellä vielä tusinan verran muita tuotteita.

Käsittelen tässä vain yhtä Codexia: OpenAI:n koodausagenttia. Mitä se tekee, missä se toimii, paljonko se maksaa, miten sen asentaa viidessä minuutissa ja mitä OpenAI kertoo maista. Kaikki perustuu viralliseen dokumentaatioon, ja jokaisen luvun lähde löytyy lopun linkeistä.

Lisämateriaalia työkalujen käyttöönotosta on Ailoot-dokumentaatiossa.

Mikä OpenAI Codex on?#

Vertaa sitä tavalliseen chattiin. Chatissa kopioit koodinpätkän, liität sen, saat vastauksen ja kopioit vastauksen takaisin. Agentti toimii eri tavalla: kuvailet tehtävän omin sanoin, ja agentti avaa projektikansiostasi asiaankuuluvat tiedostot, tekee muutoksia, suorittaa tarkistuksia ja näyttää tuloksen.

OpenAI kuvaa sen yhdellä virkkeellä repositoriossaan:

Paikallisesti tarkoittaa, että ohjelma ladataan koneellesi, missä se voi tarkastella tiedostojasi ja suorittaa komentoja kansiossasi. Vain mallille lähetettävä pyyntö menee pilveen.

Avoimen lähdekoodin koodi on GitHubissa Apache-2.0-lisenssillä. Elokuun 1. päivänä 2026 repositoriolla on 103 000 tähteä, ja uusin versio 0.146.0 julkaistiin heinäkuun 29. päivänä. Päivityksiä julkaistaan lähes päivittäin, joten käyttämäsi versio on todennäköisesti jo erilainen.

Miten vuoden 2026 Codex eroaa vanhasta, käytöstä poistetusta Codexista?#

Ihmiset sekoittavat ne jatkuvasti, koska molemmat tuotteet ovat virallisia ja OpenAI:n valmistamia. Päivämäärät erottavat ne toisistaan.

Ensimmäinen oli mallijoukko: code-davinci-001, code-davinci-002, code-cushman-001, code-cushman-002. Niillä oli yksi tehtävä: täydentää koodia puolestasi. Ne olivat myös ensimmäisen GitHub Copilotin taustalla. OpenAI:n käytöstä poistettujen mallien luettelossa kaikki neljä ovat samalla rivillä: ilmoitettu 20. maaliskuuta 2023, poistettu käytöstä 23. maaliskuuta, suositeltuna korvaajana gpt-4o.

Toinen on tietokoneelle asennettava ohjelma. Paketti @openai/codex ilmestyi npm-rekisteriin 16. huhtikuuta 2025. Sen sisällä oleva malli vaihtuu ajan myötä uudempaan, mutta ohjelma itsessään pysyy samana.

Kaikki ennen huhtikuuta 2025 laaditut Codex-ohjeet kuvaavat käytöstä poistettua tuotetta. Jos löydät materiaalia, jossa Codexia kutsutaan malliksi ja neuvotaan käyttämään sitä code-davinci-002-mallin kautta, sulje sivu.

Missä Codex toimii: päätteessä, editorissa, selaimessa vai sovelluksessa?#

Sinun ei tarvitse valita vain yhtä. Kirjautuminen on sama, samoin tili. Ero on ainoastaan siinä, missä sinun on kätevintä työskennellä.

Xcoden ja JetBrainsin laajennus toimii eri tavalla kuin muiden editorien:

Pilvi toimii eri tavalla kuin neljä muuta vaihtoehtoa. Tehtävä siirtyy OpenAI-konttiin, johon GitHubista haetaan kopio repositoriosta. Agentti työskentelee ilman tietokonettasi, ja voit myöhemmin tarkastella tulosta ja päättää, tuotko muutokset omaan kopioosi. Käyttöönotto vie kolme vaihetta: yhdistä GitHub, luo ympäristö tarvittavine riippuvuuksineen ja anna tehtävä.

Jos kirjaudut API-avaimella, pääte, editori ja sovellus toimivat. Pilvi ja siihen liittyvät ominaisuudet, kuten automaattinen koodikatselmointi ja tehtävien käynnistäminen Slackista, eivät ole käytettävissä avaimella. Niitä varten sinun on kirjauduttava ChatGPT-tilillä.

Mikä malli toimii Codexin sisällä?#

OpenAI tiivistää asian näin:

Mallin vieressä on toinen säätö: päättelytaso. Asetuksia on neljä: Low (sovelluksessa ja editorissa Light), Medium, High ja Extra High. OpenAI suosittelee käyttämään alinta tasoa, jolla saavutat tarvitsemasi tuloksen, ja nostamaan tasoa, kun tehtävä vaatii suunnittelua.

Näiden yläpuolella on vielä kaksi tilaa. Max antaa mallille enemmän aikaa tehtävään. Ultra jakaa työn osiin ja antaa osat aliagenteille suoritettaviksi rinnakkain. Dokumentaatiossa sanotaan suoraan, että useimmat tehtävät eivät tarvitse kumpaakaan.

Lisäksi on erillinen vaihtoehto gpt-5.3-codex-spark – tutkimusversio nopeisiin iterointeihin, joka on saatavilla vain Pro-tilauksella.

Mallin ja päättelytason valinta on jo kontekstisuunnittelua: päätät, kuinka paljon agentti ajattelee ja mitä se ottaa tehtävässä huomioon. Yhdistelmässä on kolme peruspilaria: AI-klooni (oma toimintatapasi agentissa), Second Brain (projektia koskevan tiedon rakenne) ja kontekstisuunnittelu. Ilman tätä yhdistelmää AI-agentti alkaa keksiä asioita.

Paljonko Codex maksaa ja mitä tilauksiin sisältyy?#

Tarkistin hinnat viralliselta hinnastosivulta 1. elokuuta 2026.

Business maksaa $25 paikkaa kohden kuukausilaskutuksella eikä $20.

Entä käyttörajat? OpenAI ei ilmoita yhtä kiinteää lukua:

Yhden luvun sijasta OpenAI julkaisee vaihteluvälit sille, montako viestiä saat viiden tunnin aikana työskennellessäsi omalla koneellasi. Plus- ja Business-tilausten luvut ovat samat:

100 dollarin Pro-tilauksella kaikki luvut kerrotaan viidellä; 200 dollarin Pro-tilauksella kahdellakymmenellä. OpenAI mainitsee viiden tunnin jakson lisäksi myös viikoittaiset käyttörajat, mutta ei julkaise niille tarkkoja lukuja.

Saman mallin kymmenkertainen vaihteluväli on helppo selittää. Yksi viesti voi käyttää joko yhden tai kymmenen prosenttia päivän käyttökiintiöstäsi, sillä ratkaisevaa on tehdyn työn määrä ja pyyntöjen lukumäärällä on vain vähän vaikutusta. Selitin tokenien kulumista käytännössä yksityiskohtaisesti Claude-esimerkin avulla artikkelissa Claude Pro- ja Max-käyttörajat – toimintaperiaate on täsmälleen sama.

Kun käyttökiintiö loppuu, vaihtoehtoja on kolme: osta lisäkrediittejä muuttamatta tilaustasi, vaihda kevyempään malliin tai aloita istunto API-avaimella ja maksa tokeneista käytön mukaan.

Mitä alueellisia rajoituksia Codexiin liittyy?#

OpenAI julkaisee virallisen luettelonsa tuetuista maista ja alueista. Valko-Venäjä ei ole luettelossa. Kazakstan, Armenia, Georgia, Turkki, Serbia ja Ukraina ovat siinä.

Saman sivun sanamuoto kuuluu:

Ohjelman asentaminen ja suorittaminen on yksi asia, mallin käyttäminen toinen. Maa tarkistetaan sisäänkirjautumisen yhteydessä: sekä ChatGPT:n kautta että API-avaimella kirjautuminen johtavat OpenAI-tiliin.

GitHub-raporteista näkee, miltä maahan liittyvä hylkäys näyttää. Tammikuussa 2026 venezuelalainen kehittäjä kertoi käyttäneensä Codex 0.88.0:aa PowerShellissä ja saaneensa jokaisella yrityksellä saman virheen:

{
  "error": {
    "code": "unsupported_country_region_territory",
    "message": "Country, region, or territory not supported",
    "type": "request_forbidden"
  }
}

unsupported_country_region_territory-koodi ja 403-tila ilmaisevat maahan liittyvän hylkäyksen. Jos näet tämän, et ole tehnyt mitään väärin asennuksen aikana, eikä Node liity asiaan.

On vielä toinen este, jota ei kuvata dokumentaatiossa lainkaan mutta joka tulee käytännössä vastaan useammin: puhelinnumeron vahvistaminen. Raportissa ”Phone number verification doesn’t work” on 206 kommenttia. Toinen raportti koskee vanhaa numeroa, johon ei enää ole pääsyä eikä jota voi vaihtaa; se on ollut avoinna kesäkuusta 2026 lähtien, ja siinä on 71 kommenttia. Sama tarina toistuu: ChatGPT toimii selaimessa samalla tilillä, mutta Codex pyytää vahvistamaan puhelinnumeron, eikä sitä voi kiertää. OpenAI ei julkaise luetteloa maista, joiden puhelinnumerot se hyväksyy, joten oman numeron kelpoisuutta ei voi tarkistaa etukäteen.

En käsittele kiertotapoja; tämä artikkeli kertoo työkalun toiminnasta.

Anthropic julkaisee myös oman luettelonsa tuetuista maista, ja käytäntö toimii samalla tavalla. Materiaalit, joissa yhtä työkalua kutsutaan ”sallituksi” ja toista ”estetyksi”, johtavat lukijoita harhaan – virallisesti niiden asema on sama. Molemmat luettelot muuttuvat, joten tarkista ajantasaiset versiot.

Codexin asennus vaihe vaiheelta#

Tekninen osuus alkaa tästä – niille, joilla on jo aktiivinen OpenAI-tili.

1. Asenna ohjelma

   Valitse järjestelmällesi sopiva tapa. Käytä myöhemmin samaa menetelmää ohjelman päivittämiseen uusimpaan versioon.

2. Avaa projektikansio

   Agentti toimii kansiossa, josta käynnistit sen. Siirry sinne ennen ensimmäisen komennon suorittamista.

3. Kirjaudu tilillesi

   Kun suoritat codex-komennon ensimmäisen kerran, ohjelma tarjoaa kirjautumista. Selain avautuu, ja sisäänkirjautumisen jälkeen ohjaus palaa päätteeseen.

4. Anna ensimmäinen tehtävä

   Kuvaile tarvitsemasi asia tavallisella kielellä. Aloita vaarattomalla tehtävällä, kuten pyydä ohjelmaa kuvailemaan projekti.

Asennuskomento macOS:lle ja Linuxille:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windowsissa käytä samaa asennusohjelmaa PowerShellin kautta:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Jos sinulla on jo Node, voit asentaa ohjelman npm:n kautta:

npm install -g @openai/codex

Homebrew toimii macOS:ssä. Muista käyttää --cask-valitsinta; ilman sitä asennat väärän ohjelman:

brew install --cask codex

Linuxissa ja WSL2:ssa hiekkalaatikko perustuu bubblewrapiin, joka on asennettava etukäteen:

sudo apt install bubblewrap

Fedorassa ja siihen liittyvissä järjestelmissä käytä komentoa sudo dnf install bubblewrap. Myös WSL-versiota 1 tuettiin versioon 0.114 asti; versiosta 0.115 alkaen hiekkalaatikko siirtyi bubblewrapiin, eikä WSL1 enää toiminut. Windowsissa kaikki toimii kuitenkin myös ilman WSL:ää sen omalla sisäänrakennetulla hiekkalaatikolla.

Mitä kannattaa tehdä ensimmäisellä käynnistyskerralla?#

Siirry ensin projektikansioon ja kirjoita codex; istunto käynnistyy. Kuvaile sitten tehtävä tavallisella kielellä ilman erikoissyntaksia.

Viisi komentoa ensimmäisille minuuteille:

1. /status - malli, hyväksymiskäytäntö ja kansiot, joita agentti pitää työtilaanaan.
2. /permissions - nykyinen käyttöoikeustila ja ohjeet tilojen vaihtamiseen.
3. /model - vaihda mallia ja päättelytasoa.
4. /init - luo projektia kuvaavan AGENTS.md-tiedoston; siitä lisää seuraavassa osiossa.
5. /review - muutostesi erillinen tarkistus tiedostoja muokkaamatta.

Pelkkien codex-komentojen lisäksi on kolme hyödyllistä päätekomentoa:

codex resume                    # return to the previous conversation in this folder
codex exec "fix the tests"      # one-off run without a dialogue, for scripts
codex --image screenshot.png    # attach an image to the task

Sekä päätteen että laajennuksen dokumentaatiossa OpenAI toistaa saman neuvon: tee commit ennen tehtävää ja sen jälkeen. Agentti muokkaa tiedostoja itsenäisesti, ja muutokset kannattaa voida kumota yhdellä komennolla heti ensimmäisestä päivästä lähtien.

Miten selität projektisi Codexille AGENTS.md-tiedoston avulla?#

Järjestys on tarkka, ja dokumentaatio kertoo sen osion ensimmäisellä rivillä:

Ensin Codex lukee yleisen tiedoston ~/.codex/AGENTS.md, johon kirjoitat kaikissa projekteissasi noudatettavat käytännöt. Sitten se lukee projektin omat tiedostot: yhden joka kansiosta repositorion juuresta nykyiseen kansioon asti. Säännöt yhdistetään ylhäältä alas, ja lähempänä nykyistä kansiota oleva tiedosto ohittaa kauempana olevan. Siksi services/payments-kansion sääntö menee yleisen juuritason säännön edelle.

Yksinkertainen tiedosto näyttää tältä:

# AGENTS.md

## How to work with this project

- Run tests with `npm test`; don't run them one file at a time.
- Install packages with pnpm.
- Ask me before adding a new production dependency.
- Do not touch the `legacy/` folder at all.

Yhdistettyjen tiedostojen kokoraja on 32 kilotavua. Sen jälkeen tiedostoja ei enää lisätä, eikä siitä ilmoiteta. Ylisuurikokoinen AGENTS.md kuluttaa rajan myös jokaisella suorituskerralla, koska koko tiedosto sisällytetään kontekstiin.

Jos tunnet CLAUDE.md-tiedoston, toimintaperiaate vaikuttaa tutulta: kyseessä on sama tekniikka eri nimellä. Projektin sääntötiedosto toimii Second Brain -ajattelun perustana: agentti oppii työstäsi ennen kuin ehdit selittää sitä. Olen käsitellyt molempien tiedostojen käyttöä yhdessä projektissa artikkelissa AGENTS.md ja CLAUDE.md yhdessä.

Mitä Codex tekee itsenäisesti ja mihin se tarvitsee hyväksynnän?#

Nämä kaksi asetusta sekoitetaan usein keskenään, joten OpenAI tiivistää eron yhteen virkkeeseen:

Kun vaihdat tarkistuksen automaattiseksi, työkansion rajat pysyvät ennallaan. Automaatio poistaa vain napsautukset; se ei muuta agentin käyttöoikeuksia.

Sovelluksessa ja editorissa on kolme käyttötilaa. Pyydä hyväksyntä on aina käytettävissä ja suositeltu aloitusvaihtoehto. Hyväksy puolestani ja Täydet käyttöoikeudet on ensin otettava käyttöön asetuksissa.

Päätteellä on oma toimintalogiikkansa: ohjelma tarkistaa kansion ja ehdottaa sopivia käyttöoikeuksia.

Verkon käyttö on oletusarvoisesti poistettu käytöstä paikallisessa tilassa. Agentti suorittaa itse keksimiään komentoja, eikä kukaan antaisi niiden päästä oletuksena internetiin.

Agentti voi lukea kaikissa tiloissa vain tiettyjä sijainteja myös työkansion sisällä: .git, .agents ja .codex. Näet agentin nykyisen työtilan kansiot komennolla /status.

Käytössä on myös täydet käyttöoikeudet antava tila: --dangerously-bypass-approvals-and-sandbox-lippu. Dokumentaatio merkitsee sen suurempiriskiseksi ja luokittelee sen ”ei suositelluksi”. Lipun nimi kertoo kaiken; minulla ei ole lisättävää.

Codex vai Claude Code: kumpi kannattaa valita?#

Työkalujen välinen ero on pienempi kuin verkkokeskusteluista voisi päätellä. Molemmat lukevat projektisi ja muokkaavat tiedostoja itsenäisesti, ja molemmat kysyvät ennen kansiosta poistumista.

Aluksi kannattaa tarkistaa, mistä maksat jo nyt. Jos sinulla on ChatGPT-tilaus, Codex sisältyy siihen; sinun ei tarvitse maksaa erikseen. Tein yksityiskohtaisen, mittauksiin perustuvan vertailun erillisessä Codex vs. Claude Code -artikkelissa. Jos haluat siirtää työasetuksesi työkalusta toiseen, katso myös siirto-opas.

Mikä menee useimmiten pieleen ensimmäisellä käynnistyskerralla?#

Luettelo perustuu projektin repositoriossa julkaistuihin ilmoituksiin. Tässä ei arvailla: jokainen kohta perustuu jonkun kohtaamaan ongelmaan.

1. Väärä paketti asennettiin. npm install -g codex asentaa ilman etuliitettä staattisen sivustogeneraattorin vuodelta 2011. Oikea paketti on @openai/codex.
2. bubblewrap ei ole asennettu. Ilman sitä hiekkalaatikko ei käynnisty Linuxissa ja WSL2:ssa. Codex siirtyy sisäänrakennettuun vararatkaisuun ja ilmoittaa ongelmasta käynnistyksen yhteydessä. Asenna se yhdellä komennolla.
3. Käyttö estetään maan vuoksi. unsupported_country_region_territory-koodi ja 403-tila ilmestyvät sisäänkirjautumisen yhteydessä. Asennuksella ei ole tähän mitään vaikutusta.
4. Puhelinnumeron vahvistusta vaaditaan. Näin ei käy kaikille, eikä asiasta kerrota dokumentaatiossa. Virallista tapaa käyttökelvottoman numeron vaihtamiseen ei ole; sitä koskeva ilmoitus on ollut avoinna kesäkuusta 2026 lähtien.
5. Käyttörajat loppuvat odotettua aikaisemmin. ”Tokens burn up very quickly” on koko repositorion eniten kommentoitu ilmoitus, jossa on 627 kommenttia. Kevyempään malliin vaihtaminen ja päättelytason laskeminen voivat auttaa.

Käyttöliittymän kieli ei vaikuta agentin toimintaan: tehtävän kielen ei tarvitse vastata käyttöliittymän kieltä.

Mitä seuraavaksi?#

Agentin kanssa vietetyn ensimmäisen tunnin aikana selvitetään aina sama asia: kuinka pitkälle se voi edetä itsenäisesti. Sen voi oppia vain omassa projektissasi; dokumentaation esimerkki ei kerro sitä.

Suosittelen aloittamaan tässä järjestyksessä:

1. Asenna ohjelma ja kirjaudu aktiiviselle OpenAI-tilille.
2. Avaa oikea projektikansio ja suorita codex.
3. Tarkista /status ja /permissions, valitse tarkastelutehtävää varten nimenomaisesti vain luku -pääsy ja varmista aktiivinen tila ennen kuin kysyt projektin rakenteesta.
4. Tee commit ja anna agentille ensimmäinen muokkaustehtävä.
5. Kirjoita kolmirivinen AGENTS.md ja vertaa agentin vastauksia ennen muutosta ja sen jälkeen.

AI-klooni + Second Brain + kontekstisuunnittelu – lisää materiaalia työkalujen käyttöön löydät Ailoot-dokumentaatiosta.