Gunakan Codex dengan CometAPI

Gunakan panduan ini untuk menjalankan Codex dengan CometAPI sebagai model provider. Referensi resmi:

Prasyarat

Persyaratan	Detail
OS	macOS, Linux, PowerShell native Windows, atau Windows dengan WSL
Git	2.23+ direkomendasikan
Codex	Instal aplikasi Codex atau Codex CLI dari Codex quickstart
CometAPI API key	Dapatkan dari dashboard CometAPI
Model ID	Gunakan model ID dari halaman Models

Pilih jalur penyiapan

Kami menyediakan dua opsi untuk membantu Anda mengonfigurasi Codex dengan cepat.

Opsi 1: Konfigurasikan Codex secara manual (direkomendasikan)

Edit file ~/.codex/config.toml tingkat pengguna secara langsung. Ini adalah jalur yang paling andal, terutama untuk pengguna Windows dan WSL.

Opsi 2: Konfigurasikan melalui skrip

Jalankan skrip penyiapan sebagai pintasan. Skrip ini menulis konfigurasi provider yang sama dan menyimpan CometAPI API key untuk Codex.

Konfigurasikan Codex secara manual

Codex membaca default provider pribadi dari file ~/.codex/config.toml pada level pengguna. Konfigurasikan provider CometAPI di sana, bukan di file proyek .codex/config.toml. Codex mengabaikan pengaturan provider dan provider-auth di file konfigurasi proyek. Pengaturan yang direkomendasikan menggunakan provider bernama cometapi dan autentikasi berbasis perintah. Ini menjaga CometAPI tetap terpisah dari provider OpenAI bawaan, tidak memerlukan pewarisan environment shell, dan tidak menggantikan ~/.codex/auth.json.

macOS / Linux / WSL
Windows PowerShell

Simpan API key CometAPI Anda di file key lokal:

mkdir -p "$HOME/.codex"
printf "%s\n" "$COMETAPI_KEY" > "$HOME/.codex/cometapi_key"
chmod 600 "$HOME/.codex/cometapi_key"

Tambahkan konfigurasi ini ke ~/.codex/config.toml:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"

[model_providers.cometapi.auth]
command = "sh"
args = ["-c", "cat \"$HOME/.codex/cometapi_key\""]

Simpan API key CometAPI Anda di direktori home Codex Windows:

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Content -NoNewline -Path "$HOME\.codex\cometapi_key" -Value $env:COMETAPI_KEY

Tambahkan konfigurasi ini ke $HOME\.codex\config.toml:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"

[model_providers.cometapi.auth]
command = "powershell.exe"
args = [
  "-NoProfile",
  "-Command",
  "$p=Join-Path $HOME '.codex/cometapi_key'; (Get-Content -Raw $p).Trim()",
]

Codex native Windows menggunakan $HOME\.codex, biasanya C:\Users\<user>\.codex. WSL menggunakan ~/.codex milik distribusi Linux. Edit direktori yang sesuai dengan environment tempat agen Codex berjalan.

Gunakan autentikasi variabel environment

Jika Anda lebih memilih menyimpan API key CometAPI dalam variabel environment, gunakan env_key alih-alih blok [model_providers.cometapi.auth]. Gunakan konfigurasi provider ini hanya ketika COMETAPI_KEY tersedia di environment yang menjalankan Codex:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"
env_key = "COMETAPI_KEY"

Jangan gabungkan env_key dengan [model_providers.cometapi.auth]. Codex mendukung satu metode autentikasi per custom provider.

Jalankan skrip setup

Skrip setup bersifat opsional. Skrip ini menulis konfigurasi provider cometapi yang sama ke ~/.codex/config.toml, menyimpan CometAPI API key Anda di ~/.codex/cometapi_key, membuat cadangan sebelum mengubah file, dan memverifikasi konfigurasi dengan codex exec saat Codex CLI tersedia. Untuk macOS, Linux, atau WSL, jalankan installer interaktif:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh)"

Untuk setup non-interaktif, berikan API key secara eksplisit:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY"

Untuk Windows PowerShell native, jalankan installer interaktif:

powershell -c "irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1' | iex"

Untuk setup Windows non-interaktif, berikan API key secara eksplisit:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY"

Secara default, skrip tidak mengganti ~/.codex/auth.json dan tidak menghapus login ChatGPT. Gunakan --force-auth-json atau -ForceAuthJson hanya jika Anda ingin skrip mengelola login API-key Codex melalui auth.json.

Pilih atau ubah model ID

Gunakan model ID dari halaman Models. Dalam konfigurasi manual, ubah nilai model di ~/.codex/config.toml. Untuk macOS, Linux, atau WSL, berikan --model saat Anda menjalankan skrip setup:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY" --model your-model-id

Untuk Windows PowerShell native, berikan -Model saat Anda menjalankan skrip setup:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY -Model 'your-model-id'"

Skrip menggunakan CODEX_HOME jika disetel. Jika tidak, skrip akan menulis ke ~/.codex pada environment saat ini.

Verifikasi setup

Untuk memverifikasi setup dengan Codex CLI, jalankan perintah hanya-baca ini dari proyek lokal mana pun:

codex exec --ephemeral --skip-git-repo-check --sandbox read-only --color never "Reply exactly with: COMETAPI_CODEX_OK"

Jika Codex CLI tidak tersedia di PATH, buka aplikasi Codex dan kirim Prompt singkat dari proyek lokal.

Pemecahan masalah

Codex masih menggunakan provider OpenAI default

Pastikan model_provider = "cometapi" ada di file ~/.codex/config.toml tingkat pengguna.

API key berubah

Perbarui ~/.codex/cometapi_key, atau jalankan ulang skrip setup dengan nilai $COMETAPI_KEY yang telah diperbarui.

Skrip PowerShell gagal saat pemeriksaan pra-penerbangan

Gunakan langkah PowerShell native Windows manual, lalu jalankan perintah verifikasi.

Setup shell yang dipipe tidak meminta API key

Gunakan --key "$COMETAPI_KEY", set COMETAPI_KEY, atau jalankan perintah interaktif sh -c "$(curl ...)".

Koneksi mengalami time out atau menggunakan base URL yang salah

Pastikan base_url adalah https://api.cometapi.com/v1 di ~/.codex/config.toml.

Model tidak ditemukan

Periksa halaman Models untuk model ID yang tersedia.

Setup Windows memengaruhi environment yang salah

Edit $HOME\.codex untuk mode native Windows, atau edit ~/.codex di dalam WSL untuk mode agen WSL.

Ikhtisar

Agen coding AI

Agen AI

Klien chat AI

Terjemahan dan bahasa

Platform otomasi

Observabilitas dan evaluasi

Framework AI

Prasyarat

Pilih jalur penyiapan

Opsi 1: Konfigurasikan Codex secara manual (direkomendasikan)

Opsi 2: Konfigurasikan melalui skrip

Konfigurasikan Codex secara manual

Gunakan autentikasi variabel environment

Jalankan skrip setup

Pilih atau ubah model ID

Verifikasi setup

Pemecahan masalah

​Prasyarat

​Pilih jalur penyiapan

Opsi 1: Konfigurasikan Codex secara manual (direkomendasikan)

Opsi 2: Konfigurasikan melalui skrip

​Konfigurasikan Codex secara manual

​Gunakan autentikasi variabel environment

​Jalankan skrip setup

​Pilih atau ubah model ID

​Verifikasi setup

​Pemecahan masalah

Prasyarat

Pilih jalur penyiapan

Konfigurasikan Codex secara manual

Gunakan autentikasi variabel environment

Jalankan skrip setup

Pilih atau ubah model ID

Verifikasi setup

Pemecahan masalah