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

> Codex daripada OpenAI: aplikasi ejen, kaedah pemasangan, antara muka, model, pelan, kebenaran dan syarat akses mengikut rantau.

Source: https://ailoot.ai/blog/ms/openai-codex-install/
Canonical: https://ailoot.ai/blog/ms/openai-codex-install/
Language: ms
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-080
Revision: sha256-42d6a989201d8c134d7703d7c4b292c218d92ca7d8890878cf32ed06d69dfbb1


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](https://ailoot.ai/docs/).

<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Ailoot Guides">

[Ailoot Guides](https://ailoot.ai/docs/)

</div>

<div class="aside" data-semantic="callout" role="note" aria-label="Perhatian">

Perhatian

Bahan ini untuk rujukan sahaja. Saya bukan peguam dan tidak memberikan nasihat undang-undang.

</div>

## Apakah OpenAI Codex?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti utama">

Inti utama

Codex ialah ejen pengekodan OpenAI. Ia membaca projek, menyunting fail dan menjalankan arahan tertakluk pada kebenaran aktif serta dasar kelulusan; sesetengah tindakan dibenarkan berjalan tanpa permintaan berasingan. Ia berfungsi dalam terminal, editor, aplikasi ChatGPT, pelayar dan awan. Ia disertakan dengan semua pelan ChatGPT, termasuk pelan percuma.

</div>

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:

<figure>
<blockquote>
<p>Codex CLI ialah ejen pengekodan OpenAI yang berjalan secara setempat pada komputer anda.</p>
</blockquote>
<figcaption>— OpenAI, https://github.com/openai/codex</figcaption>
</figure>

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti utama">

Inti utama

Kedua-duanya ialah produk berlainan yang mempunyai nama sama. Codex lama ialah rangkaian model `code-davinci` dan `code-cushman` yang berjalan dalam GitHub Copilot dan dihentikan pada 23 Mac 2023. Codex baharu muncul pada April 2025 dan menjadi ejen, bukannya model. Satu-satunya persamaan mereka ialah nama.

</div>

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.

| Ciri | Versi sebelum 2023 | Versi semasa |
|----|----|----|
| Apakahnya | sekumpulan model API | program ejen pada komputer anda |
| Cara penggunaannya | pelengkapan kod dalam editor | terangkan tugasan, kemudian ejen melaksanakannya |
| Tempat ia berjalan | dalam GitHub Copilot dan API | terminal, editor, aplikasi, pelayar, awan |
| Status | dihentikan pada 23 Mac 2023 | dikemas kini hampir setiap hari |

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti utama">

Inti utama

Codex berfungsi di lima tempat, dan ejen yang sama berada di sebalik antara muka yang berbeza. CLI berjalan dalam terminal, sambungan disepadukan dengan editor, mod berasingan tersedia dalam aplikasi ChatGPT untuk macOS dan Windows, ChatGPT dalam pelayar menjawab soalan pantas, manakala Codex cloud menjalankan tugasan dalam bekas OpenAI yang terpencil.

</div>

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

| Tempat ia berfungsi | Tempat ia berjalan | Kegunaannya |
|----|----|----|
| CLI | terminal pada mesin anda | menyunting projek, menjalankan arahan, bekerja dengan skrip |
| Sambungan editor | VS Code, Cursor, Windsurf, Xcode, JetBrains | menyunting di sebelah fail yang dibuka, melihat perubahan di tempatnya |
| Aplikasi ChatGPT | macOS dan Windows | tugasan panjang, bekerja dengan fail di luar terminal |
| ChatGPT dalam pelayar | mana-mana komputer, tanpa pemasangan | soalan pengekodan pantas apabila anda tiada terminal berdekatan |
| Awan | bekas OpenAI, log masuk di chatgpt.com/codex | tugasan serentak, melancarkan tugasan daripada GitHub, Linear dan Slack |

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

<figure>
<blockquote>
<p>Pilih editor anda. VS Code dan editor yang serasi menggunakan sambungan Codex; Xcode dan JetBrains mempunyai penyepaduan tersendiri.</p>
</blockquote>
<figcaption>— Dokumentasi Codex, https://learn.chatgpt.com/docs/codex/ide</figcaption>
</figure>

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti utama">

Inti utama

Keluarga GPT-5.6 mempunyai tiga model: Sol untuk tugasan kompleks, Terra untuk kerja harian dan Luna untuk tugasan pantas serta berulang. Tukar model dengan `/model`; tahap penaakulan juga boleh dilaraskan. GPT-5.4 dan GPT-5.4 mini akan dikeluarkan daripada Codex pada 31 Ogos 2026 dan masing-masing digantikan dengan Terra dan Luna.

</div>

OpenAI merumuskannya dalam satu ayat:

<figure>
<blockquote>
<p>Codex menawarkan tiga model GPT-5.6: Sol untuk penerokaan yang lebih mendalam dan terperinci, Terra sebagai model serba guna untuk kerja harian, dan Luna untuk kerja mudah yang berulang. Jika anda tidak pasti, mulakan dengan Sol.</p>
</blockquote>
<figcaption>— Dokumentasi Codex, https://learn.chatgpt.com/docs/models</figcaption>
</figure>

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.

<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Ailoot Guides">

[Ailoot Guides](https://ailoot.ai/docs/)

</div>

## Berapakah kos Codex dan apakah yang termasuk dalam pelan?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti utama">

Inti utama

Codex disertakan dengan semua pelan ChatGPT, termasuk pelan percuma. Free berharga 0 dolar, Go 8, Plus 20, Pro bermula pada 100, dan Business berharga 20 bagi setiap tempat duduk dengan pengebilan tahunan. Tiada langganan Codex yang berasingan: anda membayar untuk ChatGPT dan Codex disertakan bersamanya. Anda juga boleh log masuk dengan kunci API dan membayar token mengikut penggunaan.

</div>

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

| Pelan | Harga bulanan | Kandungannya |
|----|----|----|
| Free | \$0 | Codex untuk tugasan ringkas |
| Go | \$8 | Codex untuk tugasan ringan |
| Plus | \$20 | Codex dalam terminal, editor, web dan iOS, dengan keluarga GPT-5.6 |
| Pro | bermula dari \$100 | 5 kali had Plus; pelan \$200 memberikan 20 kali had |
| Business | \$20 bagi setiap tempat duduk dengan pengebilan tahunan | minimum 2 tempat duduk, ruang kerja kongsi, log masuk tunggal |
| Enterprise dan Edu | atas permintaan | pemprosesan keutamaan, log audit, kawalan pengekalan data |
| Kunci API | bagi setiap token | terminal, editor dan SDK, tanpa ciri awan |

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

Sekarang tentang had. OpenAI tidak menetapkan satu angka tetap:

<figure>
<blockquote>
<p>Bilangan mesej yang boleh anda hantar bergantung pada model yang anda pilih, saiz dan kerumitan tugasan, serta sama ada anda menjalankannya secara setempat atau dalam awan.</p>
</blockquote>
<figcaption>— Dokumentasi Codex, https://learn.chatgpt.com/docs/pricing</figcaption>
</figure>

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:

| Model | Mesej setiap 5 jam |
|---------------|----------------------|
| GPT-5.6 Sol | 10–100 |
| GPT-5.6 Terra | 25–200 |
| GPT-5.6 Luna | 250–2 000 |
| GPT-5.5 | 15–80 |
| GPT-5.4 | 20–100 |
| GPT-5.4 mini | 60–350 |

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](https://ailoot.ai/blog/ms/claude-pro-max-usage-limits/)—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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti utama">

Inti utama

Program ini boleh dimuat turun dan dijalankan di mana-mana, tetapi tidak berguna tanpa akaun OpenAI, dan sekatan itu dikenakan pada akaun itu sendiri. Pemeriksaan negara berlaku semasa log masuk dan mengembalikan kod 403. Tiada cara rasmi untuk memintasnya, dan saya tidak akan menunjukkannya.

</div>

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:

<figure>
<blockquote>
<p>Akses kepada perkhidmatan kami, atau pemberian akses kepadanya, di luar negara dan wilayah yang disenaraikan di bawah boleh menyebabkan akaun digantung atau ditamatkan.</p>
</blockquote>
<figcaption>— OpenAI, https://developers.openai.com/api/docs/supported-countries</figcaption>
</figure>

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:

```json
{
  "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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti utama">

Inti utama

Pemasangan mengambil masa lima minit. Pada macOS dan Linux, pasangkannya dengan satu arahan melalui pemasang rasmi; pada Windows, gunakan PowerShell. npm dan Homebrew juga tersedia. Kemudian jalankan `codex` dalam folder projek, log masuk melalui pelayar dan anda boleh memberikan tugasan pertama. Pada Linux dan WSL2, pasang bubblewrap terlebih dahulu.

</div>

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:

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

Pada Windows, gunakan pemasang yang sama melalui PowerShell:

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

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

```bash
npm install -g @openai/codex
```

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

```bash
brew install --cask codex
```

<div class="aside" data-semantic="callout" role="note" aria-label="Perhatian">

Perhatian

Semak nama pakej sebelum memasangnya melalui npm. Saya menyemak daftar itu: sejak 1 Oktober 2011, terdapat pakej milik orang lain yang disenaraikan dengan nama `codex` tanpa awalan. Pakej itu ialah penjana tapak statik dan versi terkini ialah 0.2.3. Ia dipasang tanpa sebarang mesej dan tidak akan berfungsi. Nama yang betul ialah `@openai/codex`: tanda at, nama syarikat dan garis miring.

</div>

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

```bash
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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti utama">

Inti utama

Arahan ringkas dengan garis miring berfungsi dalam sesi. Mulakan dengan `/status`, yang menunjukkan model, dasar kelulusan dan folder kerja. Kemudian cuba `/permissions` untuk melihat perkara yang dibenarkan kepada ejen. `/model` menukar model, `/init` mencipta fail yang menerangkan projek dan `/review` menyemak perubahan tanpa menyunting fail.

</div>

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:

```bash
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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti utama">

Inti utama

AGENTS.md ialah fail teks dalam akar projek tempat anda menulis peraturan dengan kata-kata sendiri: cara menjalankan ujian, pengurus pakej yang perlu digunakan dan perkara yang tidak boleh disentuh. Ejen membacanya sebelum memulakan kerja. Terdapat fail global dalam folder rumah anda dan fail peringkat projek; peraturan daripada kedua-duanya digunakan bersama. Jumlah saiznya dihadkan kepada 32 kilobait.

</div>

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

<figure>
<blockquote>
<p>Codex membaca fail AGENTS.md sebelum memulakan sebarang kerja.</p>
</blockquote>
<figcaption>— Dokumentasi Codex, https://learn.chatgpt.com/docs/agent-configuration/agents-md</figcaption>
</figure>

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:

```markdown
# 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](https://ailoot.ai/blog/ms/agents-md-claude-md-one-instruction-file/).

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti utama">

Inti utama

Terdapat dua tetapan yang berasingan. Sandbox menentukan tempat ejen boleh menulis dan sama ada ia boleh mengakses rangkaian. Dasar kelulusan menentukan bila ia berhenti dan bertanya. Secara lalai, dalam folder git, ejen menyunting fail dalam folder kerja secara sendiri dan hanya memerlukan kelulusan untuk bekerja di luar folder itu atau mengakses rangkaian.

</div>

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

<figure>
<blockquote>
<p>Menukar pihak yang menyemak permintaan tidak meluaskan sandbox.</p>
</blockquote>
<figcaption>— Dokumentasi Codex, https://learn.chatgpt.com/docs/permission-modes</figcaption>
</figure>

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.

| Keadaan | Cadangan program | Maksudnya |
|----|----|----|
| Folder di bawah kawalan git | `Auto` | menyunting fail dalam folder kerja sendiri; kelulusan diperlukan untuk bekerja di luar folder itu atau mengakses rangkaian |
| Folder tanpa git | `read-only` | membaca dan membalas, tetapi tidak membuat perubahan |
| Codex cloud | bekas OpenAI | kebergantungan dipasang semasa persediaan; selepas itu kerja diteruskan tanpa akses rangkaian |

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti utama">

Inti utama

Kedua-dua alat dibina dengan cara yang sama: ejen dalam terminal, sambungan editor, aplikasi dan awan. Perbezaannya terletak pada model, harga permulaan dan butiran seperti nama fail peraturan projek. Pilihan paling murah untuk Codex bermula pada sifar; untuk Claude Code, bermula pada 17 dolar.

</div>

| Ciri | Codex | Claude Code |
|----|----|----|
| Penyedia | OpenAI | Anthropic |
| Model | GPT-5.6: Sol, Terra, Luna | Opus, Sonnet, Haiku |
| Fail peraturan projek | `AGENTS.md` | `CLAUDE.md` |
| Log masuk | akaun ChatGPT atau kunci API | langganan Claude atau pengebilan Console |
| Pilihan paling murah | Free pada \$0, Go pada \$8 | Pro pada \$17 dengan pengebilan tahunan |
| Tempat ia berfungsi | terminal, editor, aplikasi, web, awan | terminal, editor, aplikasi, web |
| Sandbox | rangkaian dimatikan secara lalai, menulis dalam folder kerja | mod kebenaran, boleh dikonfigurasikan |
| Senarai negara yang disokong | diterbitkan oleh OpenAI | diterbitkan oleh Anthropic |

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](https://ailoot.ai/blog/ms/codex-vs-claude-code-choice/), dan jika anda mahu memindahkan tetapan kerja anda daripada satu alat ke alat yang lain, terdapat [panduan migrasi](https://ailoot.ai/blog/ms/migrate-claude-code-to-codex/).

## Apakah yang paling kerap bermasalah semasa pelancaran pertama?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti utama">

Inti utama

Lima masalah lazim: pakej npm yang salah dipasang, bubblewrap tidak dipasang pada Linux, akses ditolak berdasarkan negara semasa log masuk, pengesahan nombor telefon diperlukan atau had penggunaan habis secara tidak dijangka.

</div>

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti utama">

Inti utama

Pasang program dan buka projek, kemudian periksa `/status` dan `/permissions` sebelum memberikan tugasan. Pilih serta sahkan akses baca sahaja jika tugasan pertama hanya patut menerangkan fail. Mod Auto boleh menyunting folder kerja tanpa bertanya bagi setiap perubahan; jangan simpulkan perlindungan baca sahaja daripada prompt yang kedengaran tidak berbahaya atau ketiadaan Git. Seterusnya, tambah AGENTS.md dengan tiga peraturan dan bandingkan respons.

</div>

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.

<div class="section" role="doc-bibliography" aria-label="Sumber">

### Sumber

- [Codex CLI: pemasangan dan pelancaran pertama](https://learn.chatgpt.com/docs/codex/cli) - dokumentasi rasmi OpenAI
- [Sambungan Codex untuk editor](https://learn.chatgpt.com/docs/codex/ide) - senarai editor yang disokong
- [Codex cloud](https://learn.chatgpt.com/docs/cloud) - tugasan dalam persekitaran terpencil
- [Model Codex](https://learn.chatgpt.com/docs/models) - GPT-5.6 Sol, Terra, Luna dan tarikh model lama dihentikan
- [Pelan dan had Codex](https://learn.chatgpt.com/docs/pricing) - harga pelan dan bilangan mesej yang tersedia setiap lima jam
- [Kaedah log masuk](https://learn.chatgpt.com/docs/auth) - akaun ChatGPT dan kunci API
- [Sandbox dan kelulusan](https://learn.chatgpt.com/docs/sandboxing) - mod akses, bubblewrap pada Linux
- [Kebenaran dan keselamatan ejen](https://learn.chatgpt.com/docs/agent-approvals-security) - laluan terlindung, bendera berbahaya, cadangan lalai
- [Mod kebenaran](https://learn.chatgpt.com/docs/permission-modes) - Ask for approval, Approve for me, Full access
- [AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md) - cara ejen membaca peraturan projek
- [Negara dan wilayah yang disokong](https://developers.openai.com/api/docs/supported-countries) - senarai rasmi OpenAI
- [Model OpenAI yang dihentikan](https://developers.openai.com/api/docs/deprecations) - tarikh Codex lama dihentikan
- [repositori openai/codex](https://github.com/openai/codex) - kod sumber terbuka, laporan pengguna, keluaran
- [pakej @openai/codex dalam daftar npm](https://registry.npmjs.org/@openai/codex) - versi dan tarikh penerbitan
- [Keluaran Codex di GitHub](https://github.com/openai/codex/releases) - nombor versi dan tarikh keluaran


</div>

**Klon AI + Otak Kedua + Kejuruteraan Konteks** — dapatkan bahan tambahan tentang penggunaan alat dalam [dokumentasi Ailoot](https://ailoot.ai/docs/).



<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Ailoot Guides">

[Ailoot Guides](https://ailoot.ai/docs/)

</div>

<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Pergi ke Ailoot">

[Pergi ke Ailoot](https://ailoot.ai/)

</div>

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

### Adakah Codex bertanya sebelum setiap perubahan fail?

Tidak. Dalam aliran Auto diterangkan, suntingan dibenarkan dalam folder kerja boleh berjalan tanpa kelulusan individu. Periksa /status dan /permissions sebelum tugasan pertama, dan pilih akses baca sahaja secara jelas apabila hanya mahukan penerangan.

### Mengapakah pemasangan berjaya tetapi log masuk gagal dengan ralat serantau?

Memasang CLI dan mendapatkan akses model ialah langkah berasingan. Ralat 403 dengan unsupported_country_region_territory berkaitan akses akaun, bukan Node atau pemasang; bandingkan rantau akaun dengan maklumat negara disokong OpenAI.


## Ailoot · Syarikat dan portfolio projeknya

Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.

Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.

Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.
