Panduan Instalasi Offline Codex CLI

Panduan instalasi offline Codex CLI di Windows dan macOS, termasuk struktur paket, script setup, masalah umum, dan cara menyiapkan API key yang lebih hemat.

Panduan ini ditujukan untuk pengguna baru yang ingin memasang Codex CLI tanpa bergantung pada jaringan eksternal yang stabil lalu langsung memakainya setelah setup.

Panduan ini cocok untuk siapa

Orang yang ingin mencoba Vibe Coding tanpa koneksi internet yang kuat

Pengguna Codex CLI pertama kali yang ingin jalur instalasi yang rapi

Tim yang perlu paket offline portabel untuk rekan kerja atau teman

Yang perlu disiapkan sebelum instalasi

Komputer target sebaiknya sudah memiliki Node.js dan npm. Cek dulu dari terminal.

node -v
npm -v

Struktur paket

Bundle offline dibagi berdasarkan platform: windows-x64, macos-arm64, dan macos-x64. Tiap folder memuat paket utama, paket runtime platform, script instalasi, dan script setup.

Kenali platform lebih dulu

Windows

Sebagian besar PC Windows biasa memakai windows-x64.

macOS

Gunakan macos-arm64 untuk Apple Silicon dan macos-x64 untuk Intel Mac. Di macOS kamu bisa cek dengan uname -m.

uname -m

Langkah instalasi Windows x64

Langkah 1: masuk ke direktori instalasi offline

cd "your-path\codex-npm-offline\windows-x64\npm-offline"

Langkah 2: jalankan script instalasi

.\install-codex-windows-x64.cmd

Langkah 3: lakukan instalasi manual jika perlu

npm install -g .\codex-npm-0.121.0-alpha.6.tgz @openai/codex-win32-x64@file:.\codex-npm-win32-x64-0.121.0-alpha.6.tgz

Langkah 4: verifikasi instalasi berhasil

codex --version

Jalankan script setup

.\run-codex-setup.cmd

Sesudah instalasi, script setup akan meminta Base URL dan API key.

Setup akan menulis konfigurasi ke file utama Codex dan biasanya membuat backup lebih dulu.

~/.codex/config.toml
~/.codex/auth.json

Instalasi macOS Apple Silicon

cd "/your-path/codex-npm-offline/macos-arm64/npm-offline"
bash ./install-codex-macos-arm64.sh

Kalau kamu lebih suka instalasi manual, pakai npm untuk memasang paket utama dan paket platform.

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-arm64@file:./codex-npm-darwin-arm64-0.121.0-alpha.6.tgz

Instalasi macOS Intel

cd "/your-path/codex-npm-offline/macos-x64/npm-offline"
bash ./install-codex-macos-x64.sh

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-x64@file:./codex-npm-darwin-x64-0.121.0-alpha.6.tgz

Masalah umum

Perintah codex tidak ditemukan setelah instalasi

Tutup terminal saat ini, buka terminal baru, lalu jalankan codex --version lagi.

Windows memblokir script

Gunakan entry script setup karena ia memanggil PowerShell dengan ExecutionPolicy Bypass.

macOS mengatakan script tidak executable

Jalankan script shell langsung melalui bash daripada double-click.

Cara mendapat API key yang stabil dan lebih hemat

Kalau kamu masih butuh key provider, daftar dulu, cek grup model dan harga, buat API token, lalu salin Base URL dan API key ke alur setup.

Jalur penggunaan tercepat

Pasang paket platform yang benar

Jalankan script setup dan isi Base URL serta API key

Mulai Codex dengan codex atau pakai codex --yolo untuk mode eksekusi yang lebih langsung

codex
codex --yolo