OpenAI Codex: Apakahnya, Cara Memasangnya dan Syarat Akses Mengikut Rantau pada 2026

Perkataan “Codex” dalam hasil carian merujuk kepada tiga perkara yang berbeza, dan orang yang mencarinya buat kali pertama biasanya tidak memahami apa yang mereka temui. Dahulu terdapat model Codex—model itu dihentikan pada 2023; kini, nama itu merujuk kepada program ejen, dan terdapat sedozen lagi produk bernama sama dalam campuran.

Saya hanya akan membincangkan satu Codex: ejen pengekodan OpenAI. Fungsinya, tempat ia dijalankan, kosnya, cara memasangnya dalam masa lima minit, dan perkara yang dinyatakan oleh OpenAI tentang negara. Semuanya berdasarkan dokumentasi rasmi, dengan pautan bagi setiap angka di penghujung.

Bahan tambahan tentang penyediaan alat terdapat dalam dokumentasi Ailoot.

Apakah OpenAI Codex?#

Bandingkan dengan sembang biasa. Dalam sembang, anda menyalin cebisan kod, menampalnya, menerima jawapan, kemudian menyalinnya semula. Ejen berfungsi secara berbeza: anda menerangkan tugasan dalam bahasa biasa, lalu ejen membuka fail berkaitan dalam folder projek anda, membuat perubahan, menjalankan pemeriksaan dan menunjukkan hasilnya.

OpenAI menerangkannya dalam satu ayat di repositorinya:

Secara setempat bermaksud program itu dimuat turun ke mesin anda, tempat ia boleh melihat fail anda dan menjalankan arahan dalam folder anda. Hanya permintaan kepada model dihantar ke awan.

Kod sumber terbuka tersedia di GitHub di bawah lesen Apache-2.0. Setakat 1 Ogos 2026, repositori itu mempunyai 103,000 bintang, dan versi terkini, 0.146.0, dikeluarkan pada 29 Julai. Kemas kini dikeluarkan hampir setiap hari, jadi versi anda berkemungkinan sudah berbeza.

Apakah perbezaan Codex pada 2026 dengan Codex lama yang telah dihentikan?#

Orang sering keliru kerana kedua-dua produk itu rasmi dan kedua-duanya daripada OpenAI. Tarikh kemunculannya membezakan mereka.

Yang pertama ialah sekumpulan model: code-davinci-001, code-davinci-002, code-cushman-001, code-cushman-002. Model-model itu melakukan satu perkara—melengkapkan kod untuk anda—dan menggerakkan GitHub Copilot yang pertama. Dalam senarai model yang dihentikan oleh OpenAI, keempat-empatnya disenaraikan pada satu baris: diumumkan pada 20 Mac 2023, dihentikan pada 23 Mac, dengan gpt-4o sebagai pengganti yang disyorkan.

Yang kedua ialah program yang dipasang pada komputer anda. Pakej @openai/codex muncul dalam daftar npm pada 16 April 2025. Model di dalamnya digantikan dengan model yang lebih baharu dari semasa ke semasa, manakala program itu sendiri kekal sama.

Apa-apa arahan tentang Codex yang dikeluarkan sebelum April 2025 menerangkan produk yang telah dihentikan. Jika anda menemui bahan yang menyebut Codex sebagai model dan mencadangkan supaya anda memanggilnya melalui code-davinci-002, tutuplah bahan itu.

Di manakah Codex berfungsi: terminal, editor, pelayar atau aplikasi?#

Anda tidak perlu memilih antara semuanya. Log masuknya sama, begitu juga akaunnya. Perbezaannya hanya pada tempat yang lebih mudah untuk anda bekerja.

Sambungan itu berfungsi secara berbeza untuk Xcode dan JetBrains berbanding editor lain:

Awan berfungsi secara berbeza daripada empat pilihan yang lain. Tugasan dihantar ke bekas OpenAI, tempat satu salinan repositori dikeluarkan daripada GitHub. Ejen bekerja tanpa menggunakan komputer anda, dan kemudian anda menyemak hasilnya serta memutuskan sama ada hendak membawa perubahan itu ke dalam salinan anda sendiri. Persediaan memerlukan tiga langkah: sambungkan GitHub, cipta persekitaran dengan kebergantungan yang diperlukan dan berikan tugasan.

Jika anda log masuk dengan kunci API, terminal, editor dan aplikasi boleh digunakan. Awan tidak tersedia dengan kunci, begitu juga ciri-ciri yang berkaitan dengannya seperti semakan kod automatik dan pelancaran tugasan daripada Slack. Anda perlu log masuk dengan akaun ChatGPT untuk menggunakan ciri-ciri tersebut.

Model apakah yang berjalan dalam Codex?#

OpenAI merumuskannya dalam satu ayat:

Di sebelah model terdapat kawalan kedua: tahap penaakulan. Terdapat empat tetapan: Low (dipanggil Light dalam aplikasi dan editor), Medium, High dan Extra High. OpenAI mengesyorkan penggunaan tahap paling rendah yang memberikan hasil yang diperlukan dan menaikkannya apabila tugasan memerlukan perancangan.

Terdapat dua mod lagi di atasnya. Max memberikan model lebih banyak masa untuk sesuatu tugasan. Ultra membahagikan kerja kepada beberapa bahagian dan memberikan setiap bahagian kepada subejen secara serentak. Dokumentasi menyatakan secara langsung bahawa kebanyakan tugasan tidak memerlukan kedua-duanya.

Terdapat juga pilihan berasingan, gpt-5.3-codex-spark—versi penyelidikan untuk lelaran pantas, yang hanya tersedia pada pelan Pro.

Pemilihan model dan tahap penaakulan sudah pun merupakan kejuruteraan konteks: anda menentukan sejauh mana ejen berfikir dan perkara yang dibawanya ke dalam tugasan. Gabungan ini mempunyai tiga tunjang: klon AI (metodologi anda dalam ejen), Otak Kedua (struktur pengetahuan tentang projek) dan kejuruteraan konteks. Tanpa gabungan ini, ejen AI mula mereka-reka sesuatu.

Berapakah kos Codex dan apakah yang termasuk dalam pelan?#

Saya menyemak harga pada halaman harga rasmi pada 1 Ogos 2026.

Business berharga $25 bagi setiap tempat duduk dengan pengebilan bulanan, bukannya $20.

Sekarang tentang had. OpenAI tidak menetapkan satu angka tetap:

Daripada memberikan satu angka, OpenAI menerbitkan julat: bilangan mesej yang boleh anda hantar dalam tempoh lima jam ketika bekerja pada mesin sendiri. Angkanya sama untuk Plus dan Business:

Dalam pelan Pro $100, semua angka didarab dengan lima; dalam pelan Pro $200, dengan dua puluh. OpenAI turut menyebut had mingguan selain tempoh lima jam, tetapi tidak menerbitkan angka khusus untuknya.

Julat sepuluh kali ganda bagi satu model mempunyai penjelasan mudah. Satu mesej boleh menggunakan sama ada satu peratus atau sepuluh peratus daripada kuota harian anda, kerana jumlah kerja yang dilakukanlah yang dikira, manakala bilangan permintaan hanya memberi sedikit kesan. Saya menerangkan dengan terperinci cara token digunakan dalam amalan dengan Claude sebagai contoh dalam Had Claude Pro dan Max—mekaniknya sama sepenuhnya.

Apabila had anda habis, terdapat tiga pilihan: beli kredit tambahan tanpa menukar pelan, beralih kepada model yang lebih ringan atau mulakan sesi dengan kunci API dan bayar token mengikut penggunaan.

Apakah sekatan rantau yang dikenakan pada Codex?#

OpenAI menerbitkan senarai rasmi negara dan wilayah yang disokong secara terbuka. Belarus tiada dalam senarai. Kazakhstan, Armenia, Georgia, Turki, Serbia dan Ukraine tersenarai.

Kandungan pada halaman yang sama:

Memasang dan menjalankan program ialah satu perkara; mengakses model ialah perkara lain. Pemeriksaan negara bermula semasa log masuk: kedua-dua log masuk melalui ChatGPT dan log masuk menggunakan kunci API menuju ke akaun OpenAI.

Laporan di GitHub menunjukkan rupa penolakan berkaitan negara. Pada Januari 2026, seorang pembangun dari Venezuela menulis bahawa dia menggunakan Codex 0.88.0 dalam PowerShell dan menerima mesej yang sama setiap kali mencuba:

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

Kod unsupported_country_region_territory dan status 403 menunjukkan penolakan berkaitan negara. Jika anda melihatnya, ini bermakna anda tidak melakukan apa-apa kesilapan semasa pemasangan, dan Node tiada kaitan dengannya.

Terdapat satu lagi halangan yang langsung tidak diterangkan dalam dokumentasi tetapi lebih kerap timbul dalam kehidupan sebenar. Halangan itu ialah pengesahan nombor telefon. Laporan “Pengesahan nombor telefon tidak berfungsi” mempunyai 206 komen; laporan kedua, tentang nombor lama yang sudah tidak boleh diakses dan tidak boleh digantikan, telah dibuka sejak Jun 2026 dan mempunyai 71 komen. Kisah yang sama berulang: ChatGPT berfungsi dalam pelayar menggunakan akaun yang sama, tetapi Codex meminta pengesahan telefon dan tiada cara untuk mengatasinya. OpenAI tidak menerbitkan senarai negara yang nombor telefonnya diterima, jadi anda tidak boleh menyemak lebih awal sama ada nombor anda akan diterima.

Saya tidak akan membincangkan cara memintas sekatan; artikel ini menerangkan cara alat tersebut berfungsi.

Anthropic juga menerbitkan senarai negara yang disokong, dan cara kerjanya sama. Bahan yang menggambarkan satu alat sebagai “dibenarkan” dan satu lagi sebagai “disekat” hanya mengelirukan pembaca—dari segi rasmi, kedudukan kedua-duanya sama. Kedua-dua senarai berubah, jadi semak versi terkini.

Cara memasang Codex: langkah demi langkah#

Bahagian teknikal bermula di sini, untuk mereka yang sudah mempunyai akaun OpenAI yang aktif.

1. Pasang program

   Pilih kaedah yang sesuai untuk sistem anda. Gunakan kaedah yang sama kemudian untuk mengemas kini program kepada versi terkini.

2. Buka folder projek

   Ejen bekerja dalam folder tempat anda melancarkannya. Pergi ke folder itu sebelum menjalankan arahan pertama.

3. Log masuk ke akaun anda

   Kali pertama anda menjalankan codex, ia akan menawarkan pilihan untuk log masuk. Pelayar akan dibuka dan selepas anda log masuk, kawalan akan kembali kepada terminal.

4. Berikan tugasan pertama

   Terangkan perkara yang anda perlukan dalam bahasa biasa. Mulakan dengan sesuatu yang tidak berbahaya, seperti memintanya menerangkan projek.

Arahan pemasangan untuk macOS dan Linux:

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

Pada Windows, gunakan pemasang yang sama melalui PowerShell:

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

Jika anda sudah mempunyai Node, anda boleh memasangnya melalui npm:

npm install -g @openai/codex

Homebrew berfungsi pada macOS. Pastikan anda menggunakan --cask; tanpanya, anda akan memasang perkara yang salah:

brew install --cask codex

Pada Linux dan WSL2, sandbox dibina berasaskan bubblewrap, yang perlu dipasang terlebih dahulu:

sudo apt install bubblewrap

Pada Fedora dan sistem yang berkaitan, gunakan sudo dnf install bubblewrap. Selain itu, WSL versi 1 disokong sehingga versi 0.114; bermula dengan versi 0.115, sandbox beralih kepada bubblewrap dan WSL1 tidak lagi berfungsi. Namun, pada Windows, semuanya juga berfungsi tanpa WSL, menggunakan sandbox terbina dalamnya sendiri.

Apakah yang patut anda lakukan semasa pelancaran pertama?#

Untuk bermula, pergi ke folder projek dan taip codex; satu sesi akan dibuka. Kemudian terangkan tugasan dalam bahasa biasa, tanpa sintaks khas.

Lima arahan untuk beberapa minit pertama anda:

1. /status - model, dasar kelulusan dan folder yang dianggap oleh ejen sebagai ruang kerjanya.
2. /permissions - mod akses semasa dan cara menukar mod.
3. /model - menukar model dan tahap penaakulan.
4. /init - mencipta fail AGENTS.md yang menerangkan projek; maklumat lanjut dalam bahagian seterusnya.
5. /review - semakan berasingan terhadap perubahan anda, tanpa menyunting fail.

Selain codex biasa, terdapat tiga arahan terminal yang berguna:

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

Dalam halaman dokumentasi terminal dan sambungan, OpenAI mengulangi nasihat yang sama: buat commit sebelum dan selepas tugasan. Ejen menyunting fail sendiri, dan anda pasti mahu dapat mengembalikan perubahan dengan satu arahan sejak hari pertama.

Bagaimanakah anda menerangkan projek kepada Codex menggunakan AGENTS.md?#

Susunannya ketat, dan dokumentasi menyatakannya pada baris pertama bahagian tersebut:

Mula-mula, Codex membaca fail global ~/.codex/AGENTS.md, tempat anda meletakkan amalan yang terpakai pada semua projek anda. Kemudian, ia membaca fail dalam projek itu sendiri: satu fail bagi setiap folder, dari akar repositori hingga folder semasa anda. Fail-fail itu digabungkan dari atas ke bawah, dan fail yang lebih dekat mengatasi fail yang lebih jauh. Ini bermakna peraturan dalam services/payments mengatasi peraturan umum dari akar repositori.

Fail yang ringkas kelihatan begini:

# AGENTS.md

## Cara bekerja dengan projek ini

- Jalankan ujian dengan `npm test`; jangan jalankannya satu fail pada satu masa.
- Pasang pakej dengan pnpm.
- Tanya saya sebelum menambah kebergantungan pengeluaran baharu.
- Jangan sentuh folder `legacy/` sama sekali.

Had untuk fail yang digabungkan ialah 32 kilobait. Selepas itu, fail seterusnya tidak lagi ditambahkan, tanpa sebarang pemberitahuan. AGENTS.md yang terlalu besar juga menggunakan had itu setiap kali dijalankan kerana keseluruhan fail dimasukkan ke dalam konteks.

Jika anda mengenali CLAUDE.md, mekanismenya tentu biasa: teknik yang sama dengan nama berbeza. Fail peraturan projek menjadi asas kepada Otak Kedua: ejen mempelajari kerja anda sebelum anda sempat menerangkannya. Saya membincangkan cara menggunakan kedua-dua fail dalam satu projek dalam AGENTS.md dan CLAUDE.md bersama-sama.

Apakah yang Codex lakukan sendiri, dan apakah yang memerlukan kelulusan?#

Kedua-dua tetapan ini sering dikelirukan, jadi OpenAI menjelaskan perbezaannya dalam satu ayat:

Menukar semakan kepada automatik mengekalkan sempadan folder kerja seperti asal. Automasi hanya menghapuskan klik; ia tidak mengubah kebenaran ejen.

Aplikasi dan editor mempunyai tiga mod akses. Ask for approval sentiasa tersedia dan disyorkan sebagai titik permulaan. Approve for me dan Full access perlu diaktifkan terlebih dahulu dalam tetapan.

Terminal mempunyai logiknya sendiri: program menyemak folder dan mencadangkan set kebenaran yang sesuai.

Akses rangkaian dimatikan secara lalai dalam mod setempat. Ejen menjalankan arahan yang diciptanya sendiri, dan tiada sesiapa akan membenarkan akses Internet secara lalai.

Walaupun dalam folder kerja, ejen hanya boleh membaca lokasi tertentu dalam setiap mod: .git, .agents dan .codex. Gunakan /status untuk melihat folder yang dianggap oleh ejen sebagai ruang kerjanya pada masa ini.

Terdapat juga mod akses penuh—bendera --dangerously-bypass-approvals-and-sandbox. Dokumentasi menandakannya sebagai lebih berisiko dan melabelkannya “tidak disyorkan”. Nama bendera itu sudah menjelaskan semuanya; tiada apa lagi yang perlu saya tambah.

Codex atau Claude Code: yang manakah patut anda pilih?#

Perbezaan antara alat-alat ini lebih kecil daripada yang mungkin anda simpulkan daripada perdebatan dalam talian. Kedua-duanya membaca projek anda dan menyunting fail sendiri, dan kedua-duanya bertanya sebelum bekerja di luar folder.

Pada mulanya, paling mudah untuk melihat perkara yang sudah anda bayar. Jika anda mempunyai langganan ChatGPT, Codex sudah disertakan; anda tidak perlu membayar secara berasingan. Saya membuat perbandingan terperinci berserta ukuran dalam artikel berasingan tentang Codex vs. Claude Code, dan jika anda mahu memindahkan tetapan kerja anda daripada satu alat ke alat yang lain, terdapat panduan migrasi.

Apakah yang paling kerap bermasalah semasa pelancaran pertama?#

Senarai ini berdasarkan laporan dalam repositori projek. Tiada tekaan di sini; setiap perkara datang daripada seseorang yang pernah mengalaminya.

1. Pakej yang salah dipasang. npm install -g codex tanpa awalan memasang penjana tapak statik dari tahun 2011. Pakej yang betul ialah @openai/codex.
2. bubblewrap tidak dipasang. Tanpanya, sandbox tidak bermula pada Linux dan WSL2. Codex beralih kepada pilihan sandaran terbina dalamnya dan memberikan amaran semasa permulaan. Pasangnya dengan satu arahan.
3. Akses ditolak berdasarkan negara. Kod unsupported_country_region_territory dan status 403 muncul semasa log masuk. Pemasangan tiada kaitan dengannya.
4. Pengesahan telefon diperlukan. Ini tidak berlaku kepada semua orang dan tidak diterangkan dalam dokumentasi. Tiada cara rasmi untuk menggantikan nombor yang tidak lagi boleh diakses; laporan tentangnya dibuka sejak Jun 2026.
5. Had penggunaan habis lebih awal daripada jangkaan. Laporan “Token habis dengan sangat cepat” merupakan laporan yang paling banyak dibincangkan dalam keseluruhan repositori, dengan 627 komen. Beralih kepada model yang lebih ringan dan mengurangkan tahap penaakulan boleh membantu.

Bahasa antara muka tidak mempengaruhi kerja ejen: bahasa tugasan tidak perlu sama dengan bahasa antara muka.

Apakah langkah seterusnya?#

Jam pertama dengan ejen sentiasa digunakan untuk perkara yang sama: mengetahui sejauh mana ia boleh bertindak sendiri. Anda hanya boleh mengetahuinya melalui projek sendiri; contoh dalam dokumentasi tidak akan memberitahu anda.

Berikut ialah urutan permulaan yang saya syorkan:

1. Pasang program dan log masuk ke akaun OpenAI yang aktif.
2. Buka folder projek sebenar dan jalankan codex.
3. Semak /status dan /permissions, pilih akses baca sahaja secara jelas untuk tugasan pemeriksaan sahaja dan sahkan mod aktif sebelum bertanya tentang susunan projek.
4. Buat commit dan berikan tugasan penyuntingan pertamanya.
5. Tulis AGENTS.md sepanjang tiga baris dan bandingkan respons ejen sebelum dan selepasnya.

Klon AI + Otak Kedua + Kejuruteraan Konteks — dapatkan bahan tambahan tentang penggunaan alat dalam dokumentasi Ailoot.