Langsung ke konten
Inferray
DashboardDapatkan kunci API
Dokumentasi · Codex

Codex

Codex CLI terhubung ke Inferray melalui Responses API. Hal ini lebih penting di sini dibandingkan untuk agent lain: sejak v0.122, Codex menghapus wire_api = "chat", sehingga provider yang hanya menyediakan Chat Completions sama sekali tidak akan berfungsi dengannya. Inferray menyediakan /v1/responses, sehingga Codex berfungsi tanpa lapisan penerjemah di antaranya.

Menambahkan provider

Codex dikonfigurasi melalui ~/.codex/config.toml. Tambahkan blok provider dan arahkan pengaturan tingkat atas ke blok tersebut:

model = "gpt-5.5"
model_provider = "inferray"

[model_providers.inferray]
name = "Inferray"
base_url = "https://api.inferray.com/v1"
env_key = "INFERRAY_API_KEY"
wire_api = "responses"

Lalu ekspor key yang disebutkan oleh env_key:

export INFERRAY_API_KEY="inferray_..."

env_key berisi nama environment variable, bukan key-nya sendiri, sehingga file konfigurasi tetap aman untuk di-commit.

Field yang penting

  • wire_api = "responses" — wajib. Ini juga merupakan nilai default jika tidak diisi, tetapi tetap tuliskan: baris inilah yang menjelaskan mengapa id provider harus mengarah ke tempat yang menyediakan /v1/responses.
  • base_url — sertakan /v1. Codex menambahkan /responses di belakangnya.
  • model_provider — harus sama dengan id di [model_providers.<id>]. Anda bebas memilih id, tetapi id tersebut tidak boleh memakai nama bawaan yang sudah dicadangkan seperti openai, ollama, atau lmstudio.
  • model — id apa pun dari katalog. Id Claude dan Gemini juga dapat digunakan di sini, karena setiap model merespons di endpoint Responses.

Mengganti model per run

codex --model claude-opus-4-8

Atau tetapkan default lain di config.toml. Picker /model menampilkan model yang dikenali oleh Codex; memasukkan id Inferray secara langsung adalah cara yang andal.

Memastikan konfigurasi berhasil

Kirim satu request langsung ke endpoint terlebih dahulu, sehingga jika gagal, penyebabnya jelas ada di konfigurasi, bukan di Codex:

curl https://api.inferray.com/v1/responses \
  -H "Authorization: Bearer $INFERRAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.5", "input": "ship it"}'

Body JSON dengan array output berarti URL dan key sama-sama berfungsi. Lalu jalankan codex dan kirim sebuah prompt.

Response yang disimpan

Codex menetapkan store sendiri, tergantung cara ia merangkai giliran percakapan, dan Inferray meneruskan flag tersebut sebagaimana dikirim. Inferray hanya menyediakan POST /v1/responses, sehingga endpoint untuk mengambil kembali response yang disimpan tidak tersedia melaluinya — jika Codex dikonfigurasi dengan cara yang bergantung pada pengambilan response tersimpan berdasarkan id, biarkan store nonaktif.