Codex Desktop + APIMaster.ai
Konfigurasikan Codex Desktop dengan API APIMaster.ai yang kompatibel dengan OpenAI. Pengaturan ~/.codex sama seperti Codex CLI; pengalihan penyedia opsional untuk pengguna berlangganan resmi.
Codex Desktop adalah agen pengkodean desktop dari OpenAI. Anda dapat mengarahkannya ke APIMaster.ai dengan file konfigurasi lokal yang sama seperti Codex CLI: ~/.codex/config.toml dan ~/.codex/auth.json.
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"
[features]
web_search_request = true
[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. |