Yang perlu disiapkan
- Codex CLI. Salah satu cara memasangnya lewat npm:
npm install -g @openai/codex(butuh Node.js). - Akun MaCloud AI dengan saldo (top up mulai Rp 10.000) atau paket coding.
- API key dari tab API Key di konsol.
- Nama model GPT dari halaman model, misalnya
tt-6-luna.
Langkah singkat
- Buat API key di konsol, beri nama misalnya "codex-laptop", lalu salin.
- Simpan key di environment variable
MACLOUD_API_KEY(contoh di bawah). - Buka atau buat file
~/.codex/config.toml, lalu tambahkan provider MaCloud AI. - Buka terminal baru, masuk ke folder proyek, jalankan
codex. - Kirim pesan pendek, lalu cek tab Pemakaian di konsol.
Simpan API key
echo 'export MACLOUD_API_KEY=sk-...' >> ~/.zshrc # Linux: ~/.bashrc
source ~/.zshrcsetx MACLOUD_API_KEY "sk-..."
# tutup lalu buka lagi PowerShellTambahkan provider di config.toml
model_provider = "macloud"
model = "tt-6-luna"
[model_providers.macloud]
name = "MaCloud AI"
base_url = "https://api.macloudai.com/v1"
env_key = "MACLOUD_API_KEY"
wire_api = "responses"Letak filenya: ~/.codex/config.toml di macOS / Linux, atau %USERPROFILE%\.codex\config.toml di Windows. Kalau file sudah ada, tambahkan baris di atas tanpa menghapus pengaturan lain.
Untuk Codex, base URL pakai /v1. model_provider dan model harus ditulis di config.toml milik user (folder home), bukan di config.toml milik proyek.
Cara cek dan atasi error
| Gejala | Penyebab biasa |
|---|---|
| Error 401 | Variabel MACLOUD_API_KEY belum terbaca (buka terminal baru) atau key salah |
| Error 403 | Saldo habis dan kuota paket hari ini juga habis |
| Error 404 / model tidak ditemukan | Nama model salah ketik, atau /v1 tertinggal di base_url |
| Diminta login akun ChatGPT | Codex belum memakai provider MaCloud AI; cek model_provider = "macloud" ada di bagian paling atas config.toml |
Lebih praktis lewat aplikasi
Kalau tidak mau mengedit file, pakai CC Switch: isi base URL dan key di form, klik Enable. Claude Code dan Gemini CLI juga bisa diatur dari aplikasi yang sama.
Pertanyaan umum
Q1Apakah perlu langganan ChatGPT Plus?
Tidak. Dengan cara ini Codex memakai API key dan saldo atau paket MaCloud AI. Tidak perlu akun ChatGPT berbayar atau kartu kredit.
Q2Model apa yang dipakai di Codex?
Codex paling cocok dengan model GPT. Lihat nama model di halaman model, lalu tulis di baris model di config.toml.
Q3Kenapa wire_api harus responses?
Versi Codex terbaru memakai format OpenAI Responses. MaCloud AI melayani format itu langsung di https://api.macloudai.com/v1.
Q4Apakah paket coding bisa dipakai di Codex?
Bisa. Paket menempel ke akun, jadi Codex memakai kuota paket yang sama dengan Claude Code dan Gemini CLI.
Panduan lain
- Cara pakai Claude API di Indonesia tanpa kartu kredit
- Cara pakai Claude Code dengan bayar Rupiah (tanpa kartu kredit)
- Cursor dengan API key sendiri (Claude/GPT, bayar Rupiah)
- Cara bikin bot WhatsApp yang dijawab AI (Python + OpenAI SDK)
- Cara pakai API GPT (format OpenAI) dengan bayar QRIS
- Cara setting Cline di VS Code pakai Claude API bayar Rupiah
- Otomasi n8n dengan AI: OpenAI node + base URL, contoh UMKM
Cara menghitung biaya API AI (token) dalam dolar dan Rupiah
Paket coding bulanan: pilih Pemula, Menengah atau Pro- Cara pakai CC Switch untuk Claude Code, Codex dan Gemini CLI
- Cara pakai Gemini CLI dengan bayar Rupiah (tanpa kartu kredit)