Cara Install Codex di Ubuntu 24.04

Codex adalah coding agent dari OpenAI yang berjalan di terminal dan bekerja pada repositori lokal: membaca berkas, mengubah kode, dan menjalankan perintah proyek. Pasang Codex CLI di Ubuntu 24.04 melalui npm, lalu selesaikan konfigurasi awal, verifikasi binary, dan pengujian subcommand tanpa memerlukan akun pada tahap instalasi.

Requirements

• Ubuntu 24.04 LTS.
• Akses sudo atau root untuk memasang paket sistem dan paket global npm.
• Node.js 18 atau lebih baru beserta npm.
• Akun ChatGPT atau API key OpenAI untuk login dan memakai Codex.
• Ruang disk sekitar 500 MB untuk Node.js, npm, dan binary Codex.

Environment

• Sistem operasi: Ubuntu 24.04 LTS (noble).
• Node.js: 18.19.1 dari paket nodejs Ubuntu.
• npm: 9.2.0 dari paket npm Ubuntu.
• Codex CLI: paket global npm @openai/codex.
• Hak akses: user dengan sudo.

Versi paket dapat berubah mengikuti pembaruan repositori Ubuntu dan registry npm.

Cara Install Codex

Pasang Node.js dan npm

1. Update indeks paket Ubuntu.

   sudo apt update

2. Pasang Node.js dan npm dari repositori Ubuntu.

   sudo apt install -y nodejs npm

   apt install memasang runtime Node.js beserta npm sekaligus.

3. Periksa versi yang terpasang.

   node --version
   npm --version

   v18.19.1
   9.2.0

Info

Paket @openai/codex mencantumkan syarat Node.js 16 atau lebih baru pada metadata npm. Node.js 18.19.1 dari Ubuntu 24.04 memenuhi syarat itu.

Pasang Codex CLI

1. Pasang paket global @openai/codex.

   sudo npm install -g @openai/codex

   Flag -g memasang paket untuk semua user, sedangkan sudo diperlukan karena npm menulis ke /usr/local.

2. Pastikan binary codex tersedia di PATH dan dapat dijalankan.

   command -v codex
   codex --version

   /usr/local/bin/codex
   codex-cli 0.156.1

Login ke Codex

Login hanya diperlukan untuk memakai model OpenAI; memasang binary tidak memerlukan akun.

1. Jalankan login interaktif.

   codex login

   Codex membuka alur autentikasi di browser. Pada server tanpa desktop, pilih Sign in with Device Code atau jalankan perintah berikut.

   codex login --device-auth

2. Sebagai alternatif, autentikasi memakai API key yang sudah ada di environment. Nilai key tidak ditulis ke berkas atau terminal.

   printenv OPENAI_API_KEY | codex login --with-api-key

3. Periksa metode autentikasi yang aktif.

   codex login status

   codex login status mengembalikan exit code 0 saat kredensial tersedia.

Verifikasi Instalasi

Periksa lokasi binary, versi yang aktif, dan paket npm yang terpasang.

command -v codex
codex --version
npm list -g --depth=0 @openai/codex

/usr/local/bin/codex
codex-cli 0.156.1
/usr/local/lib
└── @openai/codex@0.156.1

Versi pada codex --version harus sama dengan versi paket global @openai/codex.

Konfigurasi Dasar

Codex membaca konfigurasi user dari ~/.codex/config.toml. Berkas ini mengatur model default, kebijakan persetujuan, dan mode sandbox. Buat direktori konfigurasi terlebih dahulu.

mkdir -p ~/.codex

Tulis konfigurasi awal dengan tee.

tee ~/.codex/config.toml > /dev/null <<'EOF'
approval_policy = "on-request"
sandbox_mode = "workspace-write"
EOF

• approval_policy = "on-request" membuat Codex meminta persetujuan sebelum menjalankan aksi yang mengubah sistem.
• sandbox_mode = "workspace-write" membatasi penulisan berkas hanya di dalam workspace proyek.

Nilai di ~/.codex/config.toml dapat ditimpa oleh flag CLI dan berkas proyek .codex/config.toml. Verifikasi isi berkas.

cat ~/.codex/config.toml

approval_policy = "on-request"
sandbox_mode = "workspace-write"

Pengujian Fungsional

Uji binary, subcommand, dan pembuatan completion script tanpa login.

codex --version
codex --help > /tmp/codex-help.txt
test -s /tmp/codex-help.txt && echo "help OK"
codex completion bash > /tmp/codex-completion.bash
test -s /tmp/codex-completion.bash && echo "completion OK"

codex-cli 0.156.1
help OK
completion OK

codex --help menampilkan daftar subcommand utama, termasuk login, exec, review, dan completion. Completion script yang dihasilkan dapat dimuat pada sesi shell aktif dengan source /tmp/codex-completion.bash.

Troubleshooting

codex: command not found

Penyebab: shell belum memuat ulang PATH, atau /usr/local/bin tidak termasuk PATH.

Perbaikan: jalankan hash -r, lalu periksa echo $PATH. Keluar dan masuk kembali ke sesi SSH bila perlu. Pastikan /usr/local/bin ada di PATH.

npm ERR! code EACCES saat npm install -g

Penyebab: prefix npm menunjuk direktori yang tidak dapat ditulis user.

Perbaikan: jalankan instalasi dengan sudo seperti pada langkah sebelumnya, atau periksa prefix aktif dengan npm config get prefix.

codex login gagal membuka browser

Penyebab: server tanpa desktop tidak memiliki browser, atau callback localhost terblokir.

Perbaikan: jalankan codex login --device-auth, atau autentikasi dengan API key melalui printenv OPENAI_API_KEY | codex login --with-api-key.

Error TLS pada jaringan dengan proxy perusahaan

Penyebab: sertifikat root privat tidak dikenali oleh klien HTTPS Codex.

Perbaikan: arahkan CODEX_CA_CERTIFICATE ke bundel PEM yang sesuai sebelum login.

export CODEX_CA_CERTIFICATE=/path/to/corporate-root-ca.pem
codex login

codex --version masih menampilkan versi lama

Penyebab: binary lama masih terdaftar di PATH.

Perbaikan: periksa command -v codex, lalu ulangi sudo npm install -g @openai/codex.

Untuk diagnosis menyeluruh, jalankan codex doctor. Perintah ini memeriksa instalasi, konfigurasi, autentikasi, dan runtime Codex.

Verifikasi

1. Pastikan binary dapat dipanggil dari PATH.

   command -v codex
   codex --version

   /usr/local/bin/codex
   codex-cli 0.156.1

2. Pastikan berkas konfigurasi tersedia.

   test -f ~/.codex/config.toml && echo "config tersedia"

   config tersedia

3. Jalankan ulang pembuatan completion script.

   codex completion bash > /tmp/codex-completion.bash && test -s /tmp/codex-completion.bash && echo "completion OK"

   completion OK