Setup API Key Codex Desktop: pakai APIMaster dan klaim kredit GPT gratis $50
Pelajari cara menghubungkan Codex Desktop ke APIMaster dengan API key kustom dan base URL memakai file config.toml dan auth.json yang sama seperti Codex CLI. Pengguna baru bisa klaim kredit GPT gratis $50 dan langsung memakainya di Codex.
Anda bisa menghubungkan Codex Desktop ke APIMaster dengan mengedit file ~/.codex/config.toml dan ~/.codex/auth.json yang sama seperti di Codex CLI. Pengguna baru juga bisa klaim kredit GPT gratis $50 dan langsung memakainya di Codex setelah setup selesai.
Satu pengaturan mencakup Codex Desktop dan Codex CLI. Setelah menyelesaikan panduan ini, Desktop akan menampilkan Logged in with API key dan penyedia apimaster.
Prasyarat: Pemeriksaan lingkungan, Kunci API.
APIMaster.ai
| Item | Nilai |
|---|---|
| URL Dasar | https://apimaster.ai/v1 |
| Kunci API | Konsol |
| Model | Marketplace atau GET /v1/models |
Codex menggunakan https://apimaster.ai/v1 (kompatibel dengan OpenAI). Tidak ada jaminan harga atau model dalam dokumen ini.
Konfigurasi Codex (Desktop + CLI)
Beranda Codex: ~/.codex/ (macOS) atau %USERPROFILE%\.codex\ (Windows). Keluar dari Codex Desktop sebelum mengedit file.
Windows
Win + R → %userprofile%\.codex — buat folder jika belum ada.
config.toml
disable_response_storage = true
model = "gpt-5.4"
model_provider = "apimaster"
model_reasoning_effort = "high"
model_verbosity = "high"
[model_providers.apimaster]
base_url = "https://apimaster.ai/v1"
name = "apimaster"
requires_openai_auth = true
wire_api = "responses"
auth.json
{
"OPENAI_API_KEY": "YOUR_API_KEY"
}
Ganti YOUR_API_KEY dengan kunci APIMaster Anda dari Konsol.
macOS
Buka ~/.codex (Finder: Go → Go to Folder… → ~/.codex).
config.toml
model_provider = "apimaster"
model = "gpt-5.4"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
model_verbosity = "high"
[model_providers.apimaster]
name = "apimaster"
base_url = "https://apimaster.ai/v1"
wire_api = "responses"
requires_openai_auth = true
auth.json — sama seperti Windows.
Catatan
- Atur
modelkegpt-5.5dll. sesuai Model yang didukung. - Jika
wire_api = "responses"gagal pada versi Codex Anda, cobawire_api = "chat"atau hapus baris tersebut.
| Masalah | Perbaikan |
|---|---|
| 401 | Periksa kunci auth.json |
| 404 | ID model + akses akun |
| Timeout | base_url harus persis https://apimaster.ai/v1 |
Verifikasi Codex Desktop
- Buka kembali Codex Desktop.
- Konfirmasi Logged in with API key dan penyedia apimaster di antarmuka.
- Mulai obrolan — Anda akan menerima balasan melalui APIMaster.
Pengguna CLI juga dapat menjalankan codex di terminal untuk memverifikasi konfigurasi yang sama.
Lanjutan: alihkan langganan resmi ↔ APIMaster
Gunakan ini hanya jika Anda sudah menggunakan langganan ChatGPT resmi di Codex Desktop dan ingin mempertahankan riwayat sidebar proyek saat Anda mencapai batas penggunaan bergulir 5 jam.
Mengedit config.toml secara manual dalam situasi tersebut sering kali menyembunyikan thread proyek. codex-provider-switcher mengalihkan mode penyedia dan menyinkronkan metadata percakapan secara lokal — tidak ada unggahan, tidak ada penghapusan konten obrolan.
Kapan menggunakan ini
- Langganan resmi menampilkan You're out of Codex messages atau Usage remaining mendekati 0% dengan Resets every 5 hours.
- Anda ingin melanjutkan di thread proyek yang sama di APIMaster, lalu beralih kembali ke resmi saat batas direset.

Apa yang dilakukan alat ini
Repositori: github.com/RomaCredit/codex-provider-switcher
- Memperbarui konfigurasi Codex lokal (
config.toml,auth.json, SQLite, metadata sesi) - Menyimpan profil APIMaster dan resmi
- Membuat cadangan sebelum perubahan di bawah
~/.codex/provider-switcher
Windows
- Keluar dari Codex Desktop sepenuhnya.
- Klik dua kali
codex-provider-menu.bat. - Pilih 1 (APIMaster) atau 2 (resmi). Masukkan kunci API saat pertama kali beralih ke APIMaster.
- Buka kembali Codex Desktop — akan menampilkan Logged in with API key, penyedia apimaster, dan thread proyek Anda tetap terlihat.


Jika riwayat sidebar salah: opsi 6. Repair Desktop history list.
PowerShell:
.\switch-codex-provider.ps1 status
.\switch-codex-provider.ps1 apimaster
.\switch-codex-provider.ps1 official
.\switch-codex-provider.ps1 repair-history
macOS
chmod +x ./codex-provider-menu.command
./codex-provider-menu.command
Atau:
python3 codex_provider_switcher.py apimaster
python3 codex_provider_switcher.py official
python3 codex_provider_switcher.py repair-history
Keamanan
- Kunci dan cadangan hanya tersimpan di mesin Anda.
- Jangan tempel folder
.codexke dalam isu publik. - Keluar dari Codex Desktop sebelum beralih.
FAQ (pengalih)
| Pertanyaan | Jawaban |
|---|---|
| Riwayat dipertahankan? | File sesi tetap ada; alat menyinkronkan metadata untuk tampilan sidebar. |
| Beralih kembali ke resmi? | Ya — menu 2 atau official. |
| Lokasi kunci? | ~/.codex/auth.json lokal dan profil alat. |
| Menghapus obrolan? | Tidak. |