Alat coding

OpenCodex

Hubungkan Codex ke TokenLab melalui OpenCodex dengan perutean API khusus model

Biarkan agen saya yang melakukan pengaturan ini

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

Read https://tokenlab.sh/docs/id/integrations/opencodex and help me connect OpenCodex to TokenLab.
Check my installed OpenCodex and Codex versions, active configuration, and running proxy first.
Preserve existing accounts, providers, models, and permissions. Back up files before changing them.
Have me enter the API key locally; never ask for, print, or paste it in chat.
Use the TokenLab preset and the selected model's documented API format.
Check configuration loading first. Explain the cost before running a small real request.
Match the reply with its TokenLab request record.

Cara kerja koneksi ini

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 telah dirilis dan diverifikasi secara menyeluruh di versi 2.72.0. Versi 2.73.0 mempertahankan integrasi tersebut dan menambahkan perutean Responses khusus model serta Anthropic Messages. Rute yang tercantum di bawah ini telah diperiksa terhadap TokenLab dengan teks yang di-stream dan siklus panggilan fungsi/hasil.

Codex mengirimkan permintaan Responses ke proxy OpenCodex lokal. OpenCodex kemudian mengirimkan permintaan model yang dipilih ke TokenLab. Permintaan Responses pada koneksi lokal tidak berarti bahwa model dipanggil melalui API Responses milik TokenLab.

Model yang dipilih di CodexOpenCodex → TokenLab
gpt-6-astra, gpt-6.1-sol, gpt-6-sol, gpt-6-luna, grok-4.7, deepseek-v4.1-flash, deepseek-v4-pro, kimi-k3, glm-5.3Responses: POST /v1/responses
claude-opus-5, claude-opus-5-5, claude-sonnet-5, claude-sonnet-5-5, claude-fable-5, claude-fable-5-1Anthropic Messages: POST /v1/messages
gemini-3.8-flashChat Completions: POST /v1/chat/completions

Base URL preset adalah https://api.tokenlab.sh/v1. Biarkan tidak berubah: OpenCodex akan membangun sendiri URL Messages atau Responses yang sesuai. Model di luar default Responses yang tercantum dan perutean Claude menggunakan adapter Chat dari preset.

TokenLab mendukung API asli Gemini untuk model yang menyatakannya, namun preset TokenLab pada OpenCodex 2.73.0 memanggil Gemini melalui Chat Completions. Jangan ubah seluruh penyedia (provider) menjadi Responses atau Gemini; hal itu juga akan mengubah permintaan untuk model yang tidak menerima format tersebut.

Instalasi atau pembaruan

Gunakan Node.js 18 atau yang lebih baru untuk instalasi npm:

npm install -g @bitkyc08/opencodex@2.73.0
ocx --version
codex --version

Codex juga harus diinstal. OpenCodex menyediakan instruksi instalasi dan instruksi koneksi Codex. Windows asli dan WSL memiliki konfigurasi terpisah; jalankan pengaturan dan Codex di lingkungan yang sama.

Menambahkan TokenLab

Buat kunci di TokenLab API Keys. Untuk pengaturan terminal, ikuti Panduan Cepat untuk menetapkan TOKENLAB_API_KEY tanpa memasukkan nilainya ke dalam riwayat perintah. Jalankan OpenCodex dari terminal tersebut; layanan latar belakang memerlukan variabel tersebut di lingkungan peluncurannya sendiri.

Untuk instalasi OpenCodex baru, jalankan ocx init, pilih TokenLab, dan masukkan kunci secara lokal atau gunakan referensi lingkungan literal ${TOKENLAB_API_KEY}. Tinjau pilihan koneksi Codex dan autostart dari wizard sebelum menerapkannya.

Untuk instalasi yang sudah ada, tambahkan preset tanpa mengganti penyedia lain:

ocx provider add tokenlab --api-key '${TOKENLAB_API_KEY}'

Tanda kutip tunggal menyimpan referensi variabel lingkungan, bukan nilai kuncinya. Perintah ini juga berfungsi di PowerShell. Jika tokenlab sudah ada, edit penyedia tersebut di dasbor alih-alih menimpanya dengan --force.

Anda juga dapat memilih TokenLab di daftar Add provider pada dasbor dan memasukkan kuncinya di sana. OpenCodex menyimpan konfigurasinya di $OPENCODEX_HOME/config.json, biasanya ~/.opencodex/config.json.

Jalankan proxy jika belum berjalan, lalu buka dasbornya:

ocx start
ocx status
ocx gui

Di halaman penyedia, periksa Base URL dan model yang ditemukan. Preset ini menemukan GET /v1/models?category=chat dan menyimpan model dengan kemampuan tool-use. Gambar, video, audio, embedding, dan model keputusan dikecualikan. Penemuan dengan kunci mencerminkan izin model dan kebijakan pengiriman kunci tersebut.

Jalankan ocx sync untuk menghubungkan Codex dan menyegarkan katalog modelnya, lalu mulai sesi Codex baru. Ini akan mengubah koneksi proxy dan katalog Codex; tinjau pengaturan penyedia kustom yang ada dan simpan cadangan sebelum melakukan sinkronisasi. Ini tidak mengharuskan penggantian akun atau kebijakan izin Anda.

Memilih model dan memverifikasi permintaan

Pilih entri tokenlab/<model-id> di pemilih model Codex, atau pilih untuk satu peluncuran CLI:

codex -m "tokenlab/gpt-6.1-sol"

OpenCodex menggunakan tokenlab/ untuk memilih penyedia; ID model yang dikirim ke TokenLab adalah gpt-6.1-sol. Pilih ID yang tepat dan tersedia saat ini dari Models.

Untuk pemeriksaan koneksi singkat, kirimkan:

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

Permintaan ini menggunakan saldo TokenLab Anda. Periksa balasan serta model, waktu, dan status yang cocok di Requests. Penemuan penyedia dan keberhasilan startup saja tidak memverifikasi akses inferensi.

Streaming dan pemanggilan fungsi berfungsi pada rute di dalam tabel. Input gambar dan kontrol berpikir bergantung pada model yang dipilih: periksa kemampuannya, dan gunakan hanya pilihan upaya (effort) yang ditawarkan OpenCodex untuk model tersebut. Input gambar dan permintaan berpikir telah diperiksa pada model representatif untuk rute Responses dan Messages; input gambar Gemini telah diperiksa pada rute Chat-nya. Model yang mendukung berpikir tidak serta-merta menampilkan teks berpikir atau mendukung setiap tingkat upaya.

Mempertahankan model Responses pada Chat Completions

Untuk menggunakan jalur Chat bagi 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:

{
  "modelAdapters": {
    "gpt-6-astra": "openai-chat"
  }
}

Ini adalah contoh bidang penyedia, bukan pengganti untuk konfigurasi penuh. Pertahankan penggantian model, kredensial, dan penyedia lainnya, lalu mulai ulang proxy dan buka sesi Codex baru. Menghapus entri model ini saja akan mengembalikan default Responses-nya.

Perutean Messages milik Claude terikat pada endpoint TokenLab kanonik. Penggantian Chat di atas berlaku untuk default Responses; ini tidak mengalihkan Claude ke Chat. Untuk klien asli Chat, model Responses yang tercantum sudah menggunakan Chat tanpa penggantian ini. Lihat OpenCodex provider routing.

Kebijakan pengiriman dan alat TokenLab lainnya

Preset ini tidak memaksa header X-TokenLab-Delivery-Policy. TokenLab menggunakan default kebijakan pengiriman kunci API Anda. Memilih Chat, Responses, atau Messages terpisah dari memilih kebijakan pengiriman; lihat TokenLab provider settings.

TokenLab Skills menambahkan instruksi integrasi. Mereka tidak mengubah penyedia atau format API model utama.

JEV Auto di OpenCodex 2.73.0 menggunakan backend keputusan TypeSafe. Ini tidak menawarkan TokenLab sebagai backend tersebut. Memanggil System One API milik TokenLab melalui MCP adalah operasi terpisah; jangan masukkan kunci TokenLab di bidang kredensial TypeSafe.

Menghasilkan gambar dan video di agen yang sama

Codex juga dapat membuat gambar dan video pendek dengan server TokenLab MCP. Setiap pembuatan dibayar dari saldo TokenLab yang sama. OpenCodex hanya merutekan permintaan model, dan Codex sendiri yang memulai server MCP. Tambahkan server ke Codex di terminal tempat TOKENLAB_API_KEY ditetapkan:

codex mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=core \
  --env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.48

MCP tidak mengubah penyedia atau format API model utama. Jalankan codex mcp list dan periksa apakah tokenlab terdaftar. Kemudian coba di sesi Codex baru:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video mengembalikan ID tugas. Agen akan memanggil get_task_status hingga video siap.

Pemecahan masalah dan memulihkan pengaturan Anda

  • TokenLab tidak ada di pemilih: periksa ocx --version; panduan ini menargetkan 2.73.0. Segarkan katalog dengan ocx sync dan mulai sesi Codex baru.
  • 401 atau kredensial hilang: periksa apakah kunci aktif dan tersedia untuk proses yang menjalankan OpenCodex. Variabel lingkungan di terminal yang berbeda tidak memperbarui layanan yang sudah berjalan.
  • Model hilang: periksa ID yang tepat, izin kunci 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 penggantian adapter yang disimpan. Format yang diperlukan adalah tokenlab.accepted_request_formats di model details; daftar model bukanlah pengganti untuk bidang detail tersebut. Claude dan Gemini tidak boleh dikirim ke Responses hanya karena Codex menggunakan Responses secara lokal.
  • Alat atau input gambar gagal: simpan kesalahan asli dan ID Permintaan. Periksa kemampuan model dan rute OpenCodex yang aktif sebelum mengubah pengaturan; jangan hapus riwayat percakapan atau hasil alat untuk menyembunyikan kesalahan.

Untuk berhenti merutekan Codex melalui proxy, gunakan ocx stop; OpenCodex akan menghentikan proxy dan memulihkan koneksi Codex asli. ocx restore memulihkan koneksi asli sambil tetap menjalankan proxy untuk klien lain. Tinjau OpenCodex CLI reference sebelum mengubah instalasi yang digunakan bersama oleh klien lain.

Di halaman ini