Codex CLI dengan UberLLM: jalankan agen pengkodean OpenAI pada model apa pun

Langkah-langkah

1. Buat kunci di halaman kunci Anda dan tambahkan kredit.
2. Instal Codex jika Anda belum memilikinya: npm install -g @openai/codex.
3. Masukkan kunci ke profil shell Anda (~/.zshrc atau ~/.bashrc) dan buka terminal baru:

export UBERLLM_API_KEY="ull_..."

4. Buka ~/.codex/config.toml (buat jika belum ada) dan tambahkan:

model = "moonshotai/kimi-k3"
model_provider = "uberllm"
web_search = "disabled"

[model_providers.uberllm]
name = "UberLLM"
base_url = "https://api.uberllm.dev/v1"
env_key = "UBERLLM_API_KEY"
wire_api = "responses"

5. Jalankan codex di folder proyek dan berikan tugas.

Pertahankan base_url yang diakhiri dengan /v1: Codex menambahkan /responses ke dalamnya. env_key adalah nama variabelnya, bukan kuncinya sendiri.

Ganti model

Teruskan -m untuk satu sesi, misalnya codex -m deepseek/deepseek-v4.1-flash untuk perbaikan kecil, atau ubah model di dalam file. ID model chat apa pun dari uberllm.dev/models berfungsi.

Untuk skrip dan CI, codex exec menjalankan satu tugas tanpa layar interaktif:

codex exec --skip-git-repo-check "add a docstring to every function in utils.py"

Pengaturan yang Patut Ditambahkan

• model_context_window: Codex tidak tahu ukuran konteks model di luar daftar OpenAI dan mengasumsikan 272,000 token. Untuk model yang lebih kecil, atur angkanya dari halamannya di uberllm.dev/models (misalnya model_context_window = 131072), agar Codex memadatkan percakapan sebelum kehabisan ruang.
• model_reasoning_effort: "low", "medium" atau "high" diteruskan ke model yang berpikir (DeepSeek, Kimi Thinking, GLM, GPT-5). Biarkan kosong untuk pengaturan default model.
• web_search = "disabled": Pencarian web Codex berjalan di server milik OpenAI sendiri, jadi tidak bisa berjalan melalui penyedia lain. Dengan mematikannya, model tidak ditawari alat yang tidak bisa digunakannya.

---

Apa yang berfungsi

Setiap alat Codex adalah panggilan fungsi normal dari sisi API, jadi eksekusi perintah, pengeditan file, rencana, dan server MCP yang Anda tambahkan ke Codex semuanya berfungsi pada model apa pun yang menerima panggilan alat. Codex mengirimkan seluruh percakapan pada setiap giliran (store = false), jadi tidak ada yang disimpan di UberLLM di antara panggilan. Setiap panggilan muncul di Dashboard → Activity di bawah nama aplikasi codex, dengan biayanya.

Pemecahan Masalah

• wire_api = "chat" tidak lagi didukung: Codex 0.95 dan yang lebih baru hanya mendukung Responses API. Atur wire_api = "responses".
• 401 atau "Missing environment variable: UBERLLM_API_KEY": variabel tersebut tidak diekspor di terminal tempat Codex berjalan. Buka terminal baru setelah mengedit profil Anda, atau jalankan export UBERLLM_API_KEY=... terlebih dahulu.
• 404 di setiap giliran: base_url tidak memiliki /v1. Itu harus persis https://api.uberllm.dev/v1.
• "Model metadata for … not found. Defaulting to fallback metadata": Codex mencetak ini untuk setiap model di luar daftar OpenAI sendiri. Ini tidak berbahaya; atur model_context_window seperti di atas.
• Model menjawab tetapi tidak pernah menjalankan perintah: pilih model dari tabel pertama. Model kecil cenderung keluar dari format alat Codex.
• 402 kredit tidak mencukupi: tambahkan kredit di halaman kredit. Untuk batas keras, atur batas pengeluaran pada kunci tersebut.

---

Lanjutkan membaca

• Dokumen Codex · Referensi API Respons
• Penyiapan OpenCode · Penyiapan Cline