Codex CLI
Guna Codex dengan kredit asAi.
asAi menyediakan endpoint POST /v1/responses yang serasi dengan Codex melalui HTTP streaming. codex-cli 0.148.0 telah diuji; kawalan model, baki prabayar dan log penggunaan terpakai seperti biasa.
Ini ialah lapisan compatibility Codex yang telah diuji, bukan keseluruhan OpenAI Responses API. Syarat pengesahan email, baki kredit, had kadar dan Logs asAi anda masih terpakai.
1. Sediakan API key
Cipta API key di API keys. Jangan tampal key sebenar dalam config.toml atau commit ke dalam repository. Simpan dalam environment variable ASAI_API_KEY. Format nilai ialah asai_sk_....
Linux, macOS atau Codespace:
export ASAI_API_KEY="asai_sk_..."
Windows PowerShell untuk terminal semasa:
$env:ASAI_API_KEY="asai_sk_..."
2. Pasang versi Codex yang disokong
npm install -g @openai/[email protected]
codex --version
Semakan versi patut paparkan codex-cli 0.148.0. Versi Codex lebih baru mungkin ubah format wire Responses, jadi anggap versi lain belum disahkan sehingga disenaraikan di sini.
3. Tetapkan provider asAi
Disyorkan — jalankan skrip setup dan ia uruskan semuanya:
macOS / Linux / WSL / Git Bash:
curl -fsSL https://serveras.click/static/codex-setup.sh | bash
Skrip ini akan:
- Prompt API key asAi anda (input disembunyikan)
- Simpan key sebagai environment variable
ASAI_API_KEY— tidak pernah di dalamconfig.toml - Buat backup
~/.codex/config.tomlsedia ada sebelum mengusiknya - Tulis hanya blok asAi yang bertanda jelas dalam
config.toml; konfigurasi lain tidak diusik
Untuk CI, Codespaces, atau mana-mana persekitaran yang sudah ada ASAI_API_KEY, hantar key secara terus dan pilih model (pilihan):
curl -fsSL https://serveras.click/static/codex-setup.sh | bash -s -- --key "$ASAI_API_KEY" --model asai/gpt-6-luna
Nilai --model yang disokong ialah entri asai/gpt-* dalam katalog model. Default ialah asai/gpt-6-sol.
Opsyen B — setup manual. Jika anda tidak mahu jalankan skrip setup, cipta atau edit ~/.codex/config.toml. Pada Windows, fail ini berada di %USERPROFILE%\.codex\config.toml:
model = "asai/gpt-6-sol"
model_provider = "asai"
model_reasoning_effort = "low"
approval_policy = "never"
sandbox_mode = "workspace-write"
[model_providers.asai]
name = "asAi"
base_url = "https://serveras.click/v1"
env_key = "ASAI_API_KEY"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false
request_max_retries = 0
stream_max_retries = 0
Kekalkan /v1 dalam base URL. Codex akan tambah /responses sendiri. Pengangkutan yang diuji ialah HTTP SSE, jadi WebSockets kekal dinyahdayakan.
Profil yang diuji menggunakan workspace-write dan approval_policy = "never". Mulakan Codex hanya dalam projek yang anda mahu ia ubah, dan semak diff sebelum commit.
4. Mulakan dan sahkan
cd path/to/your/project
codex
- Minta Codex baca fail kecil.
- Minta ia buat satu suntingan terkawal.
- Minta ia jalankan ujian berkaitan.
- Semak diff, kemudian semak Logs untuk request yang dicaj.
Compatibility yang disokong
- Arahan teks dan sejarah perbualan.
- Output Responses secara streaming dan bukan streaming.
- Function tools Codex, tool tambahan ber-namespace dan aliran custom tools
execyang diuji. - Panggilan tool berganda atau berpecah dengan kesinambungan hasil tool.
- Penyelesaian caj berasaskan penggunaan melalui saluran perakaunan asAi yang sama.
Had semasa
- Hanya model
asai/gpt-*diterima pada endpoint compatibility ini (senarai penuh GPT dalam katalog model). - HTTP SSE disokong; Responses melalui WebSocket tidak disokong.
previous_response_id, responses tersimpan dan mod latar belakang tidak disokong.- Ringkasan reasoning, struktur
text.format, input imej, PDF dan tool hos/pelayan tidak disokong. - Medan semantik yang tidak disokong ditolak secara jelas dan tidak diabaikan senyap-senyap.
Windows PowerShell
Setup yang sama tersedia sebagai skrip PowerShell:
irm https://serveras.click/static/codex-setup.ps1 | iex
Skrip ini simpan ASAI_API_KEY sebagai user environment variable dan tulis blok asAi yang sama ke dalam %USERPROFILE%\.codex\config.toml, dengan backup fail dahulu.
Buang pemasangan
Balikkan semua perubahan dengan satu command — blok asAi dibuang dari config.toml dan key yang disimpan dipadam:
macOS / Linux / WSL / Git Bash:
curl -fsSL https://serveras.click/static/codex-setup.sh | bash -s -- --uninstall
Windows PowerShell:
& ([scriptblock]::Create((irm https://serveras.click/static/codex-setup.ps1))) 'uninstall'
Penyelesaian masalah
- 401: sahkan
ASAI_API_KEYwujud dalam terminal yang memulakan Codex. Semak kewujudan tanpa cetak:test -n "$ASAI_API_KEY" && echo ready. - 402: baki kredit tidak mencukupi untuk tempahan request. Semak baki anda di Top up.
- 403: sahkan email anda dan pastikan akaun serta key berstatus aktif.
- 400 model tidak disokong: pastikan tetapan model adalah model
asai/gpt-*dari katalog. - Jika Codex menggunakan provider lain, sahkan
model_provider = "asai"dan mulakan sesi terminal baru selepas ubah config.