OpenAI Codex: kas tai, kaip jį įdiegti ir regioninės prieigos sąlygos 2026 m.

Žodis „Codex“ paieškos rezultatuose reiškia tris skirtingus dalykus, ir pirmą kartą jį įvedę žmonės paprastai nesupranta, ką rado. Anksčiau buvo Codex modelis — 2023 m. jo veikla nutraukta; šiandien šis pavadinimas priklauso agento programai, o rinkoje yra dar keliolika produktų tuo pačiu pavadinimu.

Aptariu tik vieną Codex: OpenAI programavimo agentą. Ką jis daro, kur veikia, kiek kainuoja, kaip jį įdiegti per penkias minutes ir ką OpenAI sako apie šalis. Visa informacija pagrįsta oficialia dokumentacija, o nuorodos į kiekvieną skaičių pateiktos pabaigoje.

Daugiau medžiagos apie įrankių nustatymą rasite Ailoot dokumentacijoje.

Kas yra OpenAI Codex?#

Palyginkite jį su įprastu pokalbiu. Pokalbyje nukopijuojate kodo fragmentą, įklijuojate jį, gaunate atsakymą ir tada nukopijuojate jį atgal. Agentas veikia kitaip: paprasta kalba aprašote užduotį, o jis atidaro reikiamus failus jūsų projekto aplanke, atlieka pakeitimus, vykdo patikras ir parodo rezultatą.

Savo saugykloje OpenAI jį apibūdina vienu sakiniu:

Vietoje reiškia, kad programa atsisiunčiama į jūsų įrenginį, kuriame gali matyti failus ir vykdyti komandas jūsų aplanke. Į debesiją siunčiama tik užklausa modeliui.

Atvirojo kodo kodas yra „GitHub“ platformoje ir platinamas pagal Apache-2.0 licenciją. 2026 m. rugpjūčio 1 d. saugykla turi 103 000 žvaigždučių, o naujausia 0.146.0 versija išleista liepos 29 d. Atnaujinimai pasirodo beveik kasdien, todėl jūsų versija greičiausiai jau bus kitokia.

Kuo 2026 m. Codex skiriasi nuo senojo nutraukto Codex?#

Žmonės juos nuolat painioja, nes abu produktai yra oficialūs ir abu sukurti OpenAI. Juos atskiria datos.

Pirmasis buvo modelių rinkinys: code-davinci-001, code-davinci-002, code-cushman-001, code-cushman-002. Jie atliko vieną funkciją — už jus užbaigdavo kodą — ir veikė kaip pirmojo „GitHub Copilot“ pagrindas. OpenAI nutrauktų modelių sąraše visi keturi pateikti vienoje eilutėje: paskelbti 2023 m. kovo 20 d., nutraukti kovo 23 d., o rekomenduojamas pakaitalas — gpt-4o.

Antrasis yra jūsų kompiuteryje įdiegiama programa. Paketas @openai/codex npm registre pasirodė 2025 m. balandžio 16 d. Jame naudojamas modelis laikui bėgant pakeičiamas naujesniu, o pati programa lieka ta pati.

Visose instrukcijose apie Codex, parengtose iki 2025 m. balandžio, aprašomas nutrauktas produktas. Jei rasite medžiagos, kurioje Codex vadinamas modeliu ir siūloma jį iškviesti per code-davinci-002, uždarykite ją.

Kur veikia Codex: terminale, redaktoriuje, naršyklėje ar programėlėje?#

Nereikia rinktis tik vieno būdo. Prisijungimo duomenys ir paskyra tie patys. Skiriasi tik tai, kur jums patogiau dirbti.

Xcode ir JetBrains plėtinys veikia kitaip nei kituose redaktoriuose:

Debesija veikia kitaip nei kitos keturios aplinkos. Užduotis siunčiama į OpenAI konteinerį, kuriame iš „GitHub“ atliekama saugyklos kopija. Agentas dirba be jūsų kompiuterio, o vėliau peržiūrite rezultatą ir nusprendžiate, ar perkelti pakeitimus į savo kopiją. Nustatymas apima tris veiksmus: prijungti GitHub, sukurti aplinką su reikiamomis priklausomybėmis ir priskirti užduotį.

Jei prisijungsite API raktu, veiks terminalas, redaktorius ir programėlė. Naudojant raktą debesija nepasiekiama, kaip ir su ja susietos funkcijos, pavyzdžiui, automatinė kodo peržiūra ir užduočių paleidimas iš Slack. Joms reikia prisijungti su ChatGPT paskyra.

Koks modelis veikia Codex viduje?#

OpenAI tai apibendrina vienu sakiniu:

Šalia modelio yra antras valdiklis: samprotavimo pastangos. Jis turi keturis nustatymus: Žemos (programėlėje ir redaktoriuje vadinama Lengvomis), Vidutinės, Aukštos ir Ypač aukštos. OpenAI rekomenduoja naudoti žemiausią lygį, kuris suteikia reikiamą rezultatą, o jį didinti, kai užduočiai reikia planavimo.

Yra dar du aukštesni režimai. Max suteikia modeliui daugiau laiko užduočiai atlikti. Ultra suskaido darbą į dalis ir lygiagrečiai paskiria jas subagentams. Dokumentacijoje tiesiogiai teigiama, kad daugumai užduočių nereikia nė vieno iš jų.

Taip pat yra atskira parinktis gpt-5.3-codex-spark — tyrimų versija greitoms iteracijoms, prieinama tik Pro plane.

Modelio ir samprotavimo pastangų pasirinkimas jau yra konteksto inžinerija: nusprendžiate, kiek agentas mąstys ir kokią informaciją pateiksite užduočiai. Šį derinį sudaro trys ramsčiai: AI klonas (jūsų metodika agente), Antrasis protas (žinių apie projektą struktūra) ir konteksto inžinerija. Be šio derinio AI agentas pradeda išsigalvoti.

Kiek kainuoja Codex ir kas įtraukta į planus?#

Kainas oficialiame kainų puslapyje patikrinau 2026 m. rugpjūčio 1 d.

Mokant kas mėnesį Business kainuoja $25 už vietą, o ne $20.

O dabar apie limitus. OpenAI nenurodo vieno fiksuoto skaičiaus:

Vietoj vieno skaičiaus OpenAI pateikia intervalą: kiek pranešimų galite išsiųsti per penkias valandas dirbdami savo kompiuteryje. Plus ir Business skaičiai vienodi:

$100 Pro plane visi skaičiai dauginami iš penkių, o $200 Pro plane — iš dvidešimties. Be penkių valandų laikotarpio OpenAI mini ir savaitinius limitus, tačiau konkrečių jų skaičių neskelbia.

Dešimteriopas intervalas naudojant tą patį modelį paaiškinamas paprastai. Vienas pranešimas gali sunaudoti arba vieną, arba dešimt procentų jūsų dienos limito, nes svarbus atlikto darbo kiekis, o užklausų skaičius turi mažai įtakos. Kaip tokenai naudojami praktikoje, išsamiai paaiškinau Claude Pro ir Max limituose, remdamasis Claude pavyzdžiu — mechanika visiškai tokia pati.

Kai limitas baigiasi, turite tris galimybes: nusipirkti papildomų kreditų nekeičiant plano, pereiti prie lengvesnio modelio arba pradėti sesiją su API raktu ir mokėti už sunaudotus tokenus.

Kokie regioniniai apribojimai taikomi Codex?#

OpenAI viešai skelbia oficialų palaikomų šalių ir teritorijų sąrašą. Baltarusijos jame nėra. Kazachstanas, Armėnija, Sakartvelas, Turkija, Serbija ir Ukraina įtraukti.

Tame pačiame puslapyje rašoma:

Programos įdiegimas ir paleidimas yra viena, o prieiga prie modelio — kita. Šalies patikra atliekama prisijungiant: tiek prisijungus per ChatGPT, tiek naudojant API raktą gaunama OpenAI paskyra.

„GitHub“ pranešimuose matyti, kaip atrodo su šalimi susijęs atmetimas. 2026 m. sausį kūrėjas iš Venesuelos parašė, kad naudojo Codex 0.88.0 „PowerShell“ aplinkoje ir kiekvieną kartą gaudavo tą patį atsakymą:

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

Kodas unsupported_country_region_territory ir 403 būsena rodo su šalimi susijusį atmetimą. Jei tai matote, vadinasi, diegdami nieko nesugadinote ir Node su tuo nesusijęs.

Yra ir antra kliūtis, kurios dokumentacijoje visai neaprašyta, tačiau realiame gyvenime pasitaiko dažniau. Tai telefono numerio patvirtinimas. Pranešimas „Telefono numerio patvirtinimas neveikia“ turi 206 komentarus; antras pranešimas apie seną numerį, kuris nebepasiekiamas ir kurio negalima pakeisti, atviras nuo 2026 m. birželio ir turi 71 komentarą. Istorija kartojasi: ChatGPT veikia naršyklėje su ta pačia paskyra, tačiau Codex prašo patvirtinti telefono numerį ir nėra galimybės to apeiti. OpenAI neskelbia sąrašo šalių, kurių telefono numerius priima, todėl iš anksto patikrinti savo numerio negalima.

Apėjimo būdų nenagrinėju; šis straipsnis apie tai, kaip veikia įrankis.

Anthropic taip pat skelbia palaikomų šalių sąrašą ir taiko tą patį principą. Medžiaga, kurioje vienas įrankis pristatomas kaip „leidžiamas“, o kitas kaip „blokuojamas“, tik klaidina skaitytojus — formaliai jų padėtis vienoda. Abu sąrašai keičiasi, todėl patikrinkite naujausias jų versijas.

Kaip įdiegti Codex: žingsnis po žingsnio#

Čia prasideda techninė dalis tiems, kurie jau turi aktyvią OpenAI paskyrą.

1. Įdiekite programą

   Pasirinkite savo sistemai tinkamą būdą. Tą patį būdą vėliau naudokite norėdami atnaujinti programą į naujausią versiją.

2. Atidarykite projekto aplanką

   Agentas dirba tame aplanke, iš kurio jį paleidote. Prieš vykdydami pirmą komandą, pereikite į jį.

3. Prisijunkite prie paskyros

   Pirmą kartą paleidus codex, programa pasiūlys prisijungti. Atsidarys naršyklė, o jums prisijungus valdymas grįš į terminalą.

4. Pateikite pirmą užduotį

   Paprasta kalba aprašykite, ko jums reikia. Pradėkite nuo nepavojingos užduoties, pavyzdžiui, paprašykite apibūdinti projektą.

Diegimo komanda macOS ir Linux sistemoms:

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

Windows sistemoje tą pačią diegimo programą naudokite per PowerShell:

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

Jei jau turite Node, galite įdiegti per npm:

npm install -g @openai/codex

Homebrew veikia macOS sistemoje. Būtinai naudokite --cask; be jo įdiegsite ne tą programą:

brew install --cask codex

Linux ir WSL2 sistemose smėliadėžė pagrįsta bubblewrap, kurį reikia įdiegti iš anksto:

sudo apt install bubblewrap

Fedora ir panašiose sistemose naudokite sudo dnf install bubblewrap. Be to, WSL 1 versija buvo palaikoma iki 0.114 versijos; nuo 0.115 smėliadėžė perkelta į bubblewrap ir WSL1 nustojo veikti. Windows sistemoje viskas veikia ir be WSL, naudojant integruotą smėliadėžę.

Ką daryti pirmą kartą paleidus?#

Norėdami pradėti, pereikite į projekto aplanką ir įveskite codex; bus atidaryta sesija. Tada paprasta kalba aprašykite užduotį, nenaudodami jokios specialios sintaksės.

Penkios komandos pirmosioms minutėms:

1. /status - modelis, patvirtinimo politika ir aplankai, kuriuos agentas laiko savo darbo sritimi.
2. /permissions - dabartinis prieigos režimas ir būdas perjungti režimus.
3. /model - modelio ir samprotavimo pastangų keitimas.
4. /init - sukuria projektą aprašantį AGENTS.md failą; apie jį daugiau rašoma kitame skyriuje.
5. /review - atskira pakeitimų peržiūra, neredaguojant failų.

Be paprasto codex, naudingi dar trys terminalo veiksmai:

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

Tiek terminalo, tiek plėtinio dokumentacijos puslapiuose OpenAI kartoja tą patį patarimą: prieš užduotį ir po jos sukurkite commit. Agentas pats redaguoja failus, todėl nuo pat pirmos dienos norėsite galėti vienu veiksmu grąžinti pakeitimus.

Kaip paaiškinti Codex savo projektą naudojant AGENTS.md?#

Tvarka yra griežta, o dokumentacija tai nurodo pačioje pirmoje skyriaus eilutėje:

Pirmiausia Codex perskaito visuotinį failą ~/.codex/AGENTS.md, kuriame aprašote įpročius, galiojančius visuose jūsų projektuose. Tada skaito pačiame projekte esančius failus: po vieną kiekviename aplanke nuo saugyklos šaknies iki dabartinio aplanko. Jie sujungiami iš viršaus žemyn, o arčiau esantis failas turi viršenybę prieš tolimesnį. Tai reiškia, kad services/payments aplanke esanti taisyklė turi viršenybę prieš bendrą taisyklę iš šakninio aplanko.

Paprastas failas atrodo taip:

# 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.

Bendras failų dydžio limitas yra 32 kilobaitai. Jį viršijus failai tiesiog nebepridedami, apie tai nepranešama. Per didelis AGENTS.md taip pat kaskart eikvoja limitą, nes visas failas įtraukiamas į kontekstą.

Jei pažįstate CLAUDE.md, mechanizmas atrodys pažįstamas: tai tas pats būdas kitu pavadinimu. Projekto taisyklių failas yra Antrojo proto pagrindas: agentas sužino apie jūsų darbą dar prieš jums ką nors paaiškinant. Kaip naudoti abu failus viename projekte, aprašiau straipsnyje AGENTS.md ir CLAUDE.md kartu.

Ką Codex daro pats ir kam reikia patvirtinimo?#

Šie du nustatymai dažnai painiojami, todėl OpenAI skirtumą nusako vienu sakiniu:

Perjungus peržiūrą į automatinę, darbinio aplanko ribos lieka tos pačios. Automatizavus tiesiog nebereikia spaudyti mygtukų; agento leidimai nesikeičia.

Programėlėje ir redaktoriuje yra trys prieigos režimai. Prašyti patvirtinimo visada pasiekiamas ir rekomenduojamas kaip pradinis pasirinkimas. Patvirtinti už mane ir Visa prieiga pirmiausia reikia įjungti nustatymuose.

Terminalas veikia pagal atskirą logiką: programa patikrina aplanką ir pasiūlo tinkamą leidimų rinkinį.

Vietiniu režimu tinklo prieiga pagal numatytuosius nustatymus išjungta. Agentas vykdo savo sugalvotas komandas, todėl niekas pagal numatytuosius nustatymus neleistų joms pasiekti interneto.

Net darbinio aplanko viduje visais režimais agentas gali skaityti tik tam tikras vietas: .git, .agents ir .codex. Naudodami /status pamatysite, kuriuos aplankus agentas šiuo metu laiko savo darbo sritimi.

Taip pat yra visos prieigos režimas — vėliavėlė --dangerously-bypass-approvals-and-sandbox. Dokumentacijoje nurodyta, kad jis kelia didesnę riziką ir yra „nerekomenduojamas“. Vėliavėlės pavadinimas pasako viską; neturiu ką pridurti.

Codex ar Claude Code: kurį pasirinkti?#

Įrankiai skiriasi mažiau, nei galėtumėte spręsti iš ginčų internete. Abu perskaito jūsų projektą ir patys redaguoja failus, o prieš išeidami už aplanko ribų paprašo leidimo.

Pradžioje lengviausia atsižvelgti į tai, už ką jau mokate. Jei turite ChatGPT prenumeratą, Codex jau įtrauktas; atskirai mokėti nereikia. Išsamų palyginimą su matavimais pateikiau atskirame straipsnyje apie Codex ir Claude Code, o jei norite perkelti darbinius nustatymus iš vieno įrankio į kitą, rasite migravimo vadovą.

Kas dažniausiai sugenda pirmą kartą paleidus?#

Šis sąrašas sudarytas pagal pranešimus projekto saugykloje. Čia nieko nespėliojama — kiekvieną punktą pateikė žmogus, su tuo susidūręs.

1. Įdiegtas netinkamas paketas. npm install -g codex be prefikso įdiegia 2011 m. sukurtą statinių svetainių generatorių. Tinkamas paketas yra @openai/codex.
2. Neįdiegtas bubblewrap. Be jo Linux ir WSL2 smėliadėžė nepasileidžia. Codex persijungia į integruotą atsarginį režimą ir paleidimo metu pateikia klaidą. Įdiekite jį viena komanda.
3. Prieiga atmesta dėl šalies. Kodas unsupported_country_region_territory ir 403 būsena pasirodo prisijungiant. Diegimas su tuo nesusijęs.
4. Reikia patvirtinti telefono numerį. Taip nutinka ne visiems ir tai neaprašyta dokumentacijoje. Nėra oficialaus būdo pakeisti numerį, prie kurio nebeturite prieigos; pranešimas apie tai atviras nuo 2026 m. birželio.
5. Naudojimo limitai baigiasi greičiau, nei tikėjotės. Pranešimas „Tokenai sunaudojami labai greitai“ yra daugiausiai aptariamas visoje saugykloje — jame 627 komentarai. Gali padėti perėjimas prie lengvesnio modelio ir mažesnės samprotavimo pastangos.

Sąsajos kalba neturi įtakos agento darbui: užduoties kalba neprivalo sutapti su sąsajos kalba.

Ką daryti toliau#

Pirmąją valandą su agentu visada siekiama to paties: išsiaiškinti, kiek jis gali nuveikti savarankiškai. Tai suprasite tik naudodami savo projektą; dokumentacijos pavyzdys to neparodys.

Rekomenduoju pradėti tokia tvarka:

1. Įdiekite programą ir prisijunkite prie aktyvios OpenAI paskyros.
2. Atidarykite tikrą projekto aplanką ir paleiskite codex.
3. Patikrinkite /status ir /permissions, tik apžiūrai aiškiai pasirinkite tik skaitymo prieigą ir prieš klausdami apie projekto struktūrą patikrinkite aktyvų režimą.
4. Sukurkite commit ir pateikite pirmąją redagavimo užduotį.
5. Parašykite trijų eilučių AGENTS.md ir palyginkite agento atsakymus prieš pakeitimą ir po jo.

AI klonas + Antrasis protas + Konteksto inžinerija — daugiau medžiagos apie darbą su įrankiais rasite Ailoot dokumentacijoje.