Skip to main content

​
Biarkan agen saya menyiapkan ini

Salin tugas ini ke agen yang sudah berjalan di komputer Anda:

​
Cara kerja koneksi

OpenCodex adalah proxy lokal antara Codex dan API model. Panduan ini menggunakan OpenCodex 2.73.0 dan Codex CLI 0.149.0. Integrasi Chat Completions pada preset TokenLab dirilis dan diverifikasi secara end-to-end pada versi 2.72.0. Versi 2.73.0 mempertahankan integrasi tersebut dan menambahkan perutean Responses dan Anthropic Messages khusus model. Rute yang tercantum di bawah ini telah diperiksa terhadap TokenLab dengan streaming teks dan round trip function-call/result. Codex mengirimkan permintaan Responses ke proxy OpenCodex lokal. OpenCodex kemudian mengirimkan permintaan model yang dipilih ke TokenLab. Permintaan Responses pada koneksi lokal bukan berarti model tersebut dipanggil melalui API Responses TokenLab. Base URL preset adalah https://api.tokenlab.sh/v1. Jangan diubah: OpenCodex membangun sendiri URL Messages atau Responses yang cocok. Model di luar default Responses yang tercantum dan perutean Claude menggunakan adapter Chat preset. TokenLab mendukung API native Gemini untuk model yang mendeklarasikannya, namun preset TokenLab OpenCodex 2.73.0 memanggil Gemini melalui Chat Completions. Jangan mengubah keseluruhan provider menjadi Responses atau Gemini; hal itu juga akan mengubah permintaan untuk model yang tidak menerima format tersebut.

​
Instal atau perbarui

Gunakan Node.js 18 atau yang lebih baru untuk instalasi npm:
Codex juga harus terinstal. OpenCodex menyediakan petunjuk instalasi dan instruksi koneksi Codex. Windows native dan WSL memiliki konfigurasi terpisah; jalankan penyiapan dan Codex di lingkungan yang sama.

​
Tambahkan TokenLab

Buat key di TokenLab API Keys. Untuk penyiapan terminal, ikuti Panduan Cepat untuk menyetel TOKENLAB_API_KEY tanpa memasukkan nilainya ke dalam riwayat perintah. Mulai OpenCodex dari terminal tersebut; background service memerlukan variabel tersebut di lingkungan peluncurannya sendiri. Untuk instalasi baru OpenCodex, jalankan ocx init, pilih TokenLab, dan masukkan key secara lokal atau gunakan referensi variabel lingkungan literal ${TOKENLAB_API_KEY}. Tinjau pilihan koneksi Codex dan autostart pada wizard sebelum menerapkannya. Untuk instalasi yang sudah ada, tambahkan preset tanpa mengganti provider lain:
Tanda petik tunggal menyimpan referensi variabel lingkungan, bukan nilai dari key tersebut. Perintah ini juga berfungsi di PowerShell. Jika tokenlab sudah ada, edit provider tersebut di dasbor alih-alih menimpanya dengan --force. Anda juga dapat memilih TokenLab di daftar Add provider pada dasbor dan memasukkan key di sana. OpenCodex menyimpan konfigurasinya di bawah $OPENCODEX_HOME/config.json, biasanya ~/.opencodex/config.json. Mulai proxy jika belum berjalan, lalu buka dasbornya:
Di halaman provider, periksa Base URL dan model yang ditemukan. Preset menemukan GET /v1/models?category=chat dan mempertahankan model dengan kemampuan tool-use. Gambar, video, audio, embedding, dan model keputusan dikecualikan. Penemuan dengan sebuah key mencerminkan izin model dan kebijakan pengiriman (delivery policy) dari key tersebut. Jalankan ocx sync untuk menghubungkan Codex dan memperbarui katalog modelnya, lalu mulai sesi Codex baru. Ini akan mengubah koneksi proxy dan katalog Codex; tinjau pengaturan custom-provider yang ada dan simpan cadangan sebelum melakukan sinkronisasi. Hal ini tidak memerlukan penggantian akun atau kebijakan izin Anda.

​
Pilih model dan verifikasi permintaan

Pilih entri tokenlab/<model-id> di pemilih model Codex, atau pilih untuk satu peluncuran CLI:
OpenCodex menggunakan tokenlab/ untuk memilih provider; ID model yang dikirimkan ke TokenLab adalah gpt-6.1-sol. Pilih ID persis yang saat ini tersedia dari Models. Untuk pemeriksaan koneksi kecil, kirimkan:
Permintaan ini menggunakan saldo TokenLab Anda. Periksa balasan beserta model, waktu, dan status yang cocok di Requests. Penemuan provider dan keberhasilan startup saja tidak memverifikasi akses inferensi. Streaming dan function calling berfungsi pada rute-rute dalam tabel. Input gambar dan kontrol thinking bergantung pada model yang dipilih: periksa kemampuannya, dan gunakan hanya pilihan effort yang ditawarkan OpenCodex untuk model tersebut. Permintaan input gambar dan thinking telah diperiksa pada model representatif untuk rute Responses dan Messages; input gambar Gemini telah diperiksa pada rute Chat-nya. Model yang mendukung thinking belum tentu menampilkan teks thinking atau mendukung setiap tingkat effort.

​
Pertahankan model Responses di Chat Completions

Untuk menggunakan jalur Chat pada salah satu model Responses yang tercantum, gabungkan entri modelAdapters ke dalam objek providers.tokenlab yang sudah ada di konfigurasi OpenCodex. Contoh ini mempertahankan gpt-6-astra pada Chat untuk Codex:
Ini adalah contoh field provider, bukan pengganti untuk konfigurasi penuh. Pertahankan override model, kredensial, dan provider lainnya, lalu restart proxy dan buka sesi Codex baru. Menghapus entri model ini saja akan mengembalikan default Responses-nya. Perutean Messages Claude terikat pada endpoint kanonikal TokenLab. Override Chat di atas berlaku untuk default Responses; ini tidak mengalihkan Claude ke Chat. Untuk klien native Chat, model Responses yang tercantum sudah menggunakan Chat tanpa override ini. Lihat Perutean provider OpenCodex.

​
Kebijakan pengiriman dan alat TokenLab lainnya

Preset ini tidak memaksakan header X-TokenLab-Delivery-Policy. TokenLab menggunakan default delivery policy dari API key Anda. Memilih Chat, Responses, atau Messages terpisah dari memilih kebijakan pengiriman; lihat Pengaturan provider TokenLab. Tambahkan Server MCP TokenLab untuk alat API lainnya, atau TokenLab Skills untuk petunjuk integrasi. Ini tidak mengubah provider atau format API model utama. JEV Auto di OpenCodex 2.73.0 menggunakan backend keputusan TypeSafe. Fitur ini tidak menawarkan TokenLab sebagai backend tersebut. Memanggil System One API TokenLab melalui MCP adalah operasi terpisah; jangan masukkan key TokenLab ke dalam field kredensial TypeSafe.

​
Pemecahan masalah dan memulihkan penyiapan Anda

  • TokenLab tidak ada di pemilih: periksa ocx --version; panduan ini menargetkan versi 2.73.0. Perbarui katalog dengan ocx sync dan mulai sesi Codex baru.
  • 401 atau kredensial hilang: periksa apakah key aktif dan tersedia untuk proses yang menjalankan OpenCodex. Variabel lingkungan di terminal yang berbeda tidak memperbarui service yang sudah berjalan.
  • Model hilang: periksa ID yang tepat, izin key Anda, dan ketersediaan saat ini. Model non-chat dan model chat tanpa tool-use tidak disertakan dalam preset ini.
  • Permintaan tidak didukung atau endpoint salah: bandingkan model yang dipilih dengan tabel perutean dan periksa override adapter yang tersimpan. Format yang diperlukan adalah tokenlab.accepted_request_formats di detail model; daftar model bukanlah pengganti untuk field detail tersebut. Claude dan Gemini tidak boleh dikirim ke Responses hanya karena Codex menggunakan Responses secara lokal.
  • Tools atau input gambar gagal: simpan error asli dan Request ID. Periksa kemampuan model dan rute OpenCodex yang aktif sebelum mengubah pengaturan; jangan menghapus riwayat percakapan atau hasil alat untuk menyembunyikan error.
Untuk berhenti merutekan Codex melalui proxy, gunakan ocx stop; OpenCodex menghentikan proxy dan memulihkan koneksi Codex native. ocx restore memulihkan koneksi native sambil tetap menjalankan proxy untuk klien lain. Tinjau Referensi CLI OpenCodex sebelum mengubah instalasi yang digunakan bersama oleh klien lain.