Facade Code Dokumentasi
Konfigurasi agen

Codex + penyedia Anda

Hubungkan satu setelan peluncuran Codex ke penyedia model sendiri, atau pakai profil Codex native yang sudah ada.

Siapkan detail penyedia

Pasang Codex dan dapatkan base URL, kunci API, dan ID model dari penyedia Anda. Endpoint harus mendukung OpenAI Responses API; kompatibilitas Chat Completions saja tidak cukup.

Contoh ini menambahkan Codex · work tanpa mengubah entri Codex lain atau menyunting konfigurasi global Codex.

Sudah punya profil Codex? Langsung ke Gunakan profil Codex yang sudah ada.

1. Tentukan penyedianya

Tambahkan penyiapan ini ke facade.json (lihat Pengaturan agen). Ganti base URL, kunci, dan ID model contoh:

facade.json
{
  "clis": {
    "Codex · work": {
      "type": "codex",
      "model": "YOUR_MODEL_ID",
      "args": [
        "-c",
        "model_provider=work",
        "-c",
        "model_providers.work.name=Work",
        "-c",
        "model_providers.work.base_url=https://api.example.com/v1",
        "-c",
        "model_providers.work.wire_api=responses",
        "-c",
        "model_providers.work.env_key=WORK_API_KEY"
      ],
      "env": {
        "WORK_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Gunakan ID penyedia yang sama, work, di model_provider=work dan di setiap pengaturan model_providers.work.…. Nama variabel kuncinya, WORK_API_KEY, harus sama dengan env_key.

2. Periksa pengaturan penyedia

PengaturanFungsinya
model_provider=workMemilih penyedia yang didefinisikan oleh pengaturan work.
model_providers.work.nameMemberi nama tampilan untuk penyedia tersebut.
model_providers.work.base_urlMenetapkan base URL API.
model_providers.work.wire_api=responsesMemakai format Responses API.
model_providers.work.env_key=WORK_API_KEYMemberi tahu Codex variabel lingkungan mana yang berisi kunci.
env.WORK_API_KEYMenyediakan kunci itu ke proses Codex.

Setiap -c menetapkan satu opsi Codex untuk agen yang dimulai dengan entri ini.

Contoh ini menyimpan kunci di facade.json. Jika kuncinya sudah ada dalam variabel lingkungan, setel env.WORK_API_KEY ke ${env:WORK_API_KEY}. Editor harus sudah memiliki variabel itu sebelum agen dimulai.

3. Mulai Codex dengan penyiapan ini

Simpan facade.json, pilih New Agent, lalu pilih Codex · work. Gunakan /model untuk memeriksa model yang dipilih, lalu kirim tugas singkat untuk proyek Anda.

Jika penyedia Anda melaporkan penggunaan, pastikan permintaannya tercatat di akun yang benar. Untuk memeriksa konfigurasi peluncurannya, jalankan Show Agent Launch dan pilih lokasi kerjanya. Temukan entri ini di laporan untuk melihat bagaimana agen berikutnya akan dimulai dengan pengaturan Anda saat ini.

Untuk kesalahan permintaan, lihat Pemecahan masalah.

Contoh: QwenCloud

Untuk kunci QwenCloud Token Plan, gunakan https://token-plan.maas.qwencloudapi.com/compatible-mode/v1 sebagai base URL dan pertahankan wire_api=responses. Gunakan model yang tersedia di paket Anda. Kunci pay-as-you-go memakai endpoint sesuai region-nya.

Setelan Codex QwenCloud yang berlaku saat ini ↗

Gunakan profil Codex yang sudah ada

Jika Anda sudah memakai profil Codex native, pilih profil itu lewat argumen entri:

facade.json
{
  "clis": {
    "Codex · profile": {
      "type": "codex",
      "args": [
        "--profile",
        "work"
      ]
    }
  }
}

Ganti work dengan profil yang Anda pakai. Letakkan konfigurasi penyedia di profil tersebut, bukan mengulanginya di entri Facade. Simpan, pilih New Agent, lalu pilih Codex · profile. Kirim tugas singkat dan pastikan permintaannya muncul di catatan penggunaan penyedia Anda, bila tersedia.

Lihat sebagai Markdown ↗Dokumentasi

Cari di dokumentasi

Cari di panduan ini. Gunakan ↑ ↓ untuk berpindah, Enter untuk membuka, Esc untuk menutup.