Codex - Hubungkan asisten coding terminal OpenAI ke Model Studio - Alibaba Cloud Model Studio

Codex adalah asisten coding AI terminal dari OpenAI. Hubungkan ke Alibaba Cloud Model Studio melalui Token Plan (Team Edition), Coding Plan, atau pay-as-you-go.

Install Codex

Instal atau perbarui Node.js (v18.0 atau lebih baru).

Instal Codex:

npm install -g @openai/codex

Verifikasi instalasi:

codex --version

Konfigurasi Kredensial Akses

Edit ~/.codex/config.toml dan atur variabel lingkungan OPENAI_API_KEY sesuai rencana penagihan Anda:

Token Plan (Team Edition)

Untuk model, pilih model yang didukung. Atur variabel lingkungan OPENAI_API_KEY ke API Key khusus Token Plan (Team Edition).

Responses API (qwen3.7-max, qwen3.7-plus, qwen3.6-plus, qwen3.6-flash)

Model qwen3.7-max, qwen3.7-plus, qwen3.6-plus, dan qwen3.6-flash mendukung Responses API dan kompatibel dengan versi Codex terbaru.

model_provider = "Model_Studio_Token_Plan"
model = "qwen3.7-max"
[model_providers.Model_Studio_Token_Plan]
name = "Model_Studio_Token_Plan"
base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Chat/Completions API (model lainnya)

Model lainnya memerlukan Chat/Completions API. Instal Codex 0.80.0:

npm install -g @openai/codex@0.80.0

model_provider = "Model_Studio_Token_Plan"
model = "glm-5"
[model_providers.Model_Studio_Token_Plan]
name = "Model_Studio_Token_Plan"
base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

Konfigurasi Variabel Lingkungan

Atur variabel lingkungan OPENAI_API_KEY ke API Key khusus Token Plan (Team Edition).

macOS

Periksa shell default Anda:
```
echo $SHELL
```

Atur variabel lingkungan berdasarkan jenis shell Anda:

Zsh

# Ganti YOUR_API_KEY dengan API Key Token Plan (Team Edition)
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

Bash

# Ganti YOUR_API_KEY dengan API Key Token Plan (Team Edition)
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile

Terapkan perubahan:
Zsh
```
source ~/.zshrc
```
Bash
```
source ~/.bash_profile
```

Windows

CMD

Atur variabel lingkungan:

REM Ganti YOUR_API_KEY dengan API Key Token Plan (Team Edition)
setx OPENAI_API_KEY "YOUR_API_KEY"

Buka jendela CMD baru untuk verifikasi:
```
echo %OPENAI_API_KEY%
```

PowerShell

Atur variabel lingkungan:

# Ganti YOUR_API_KEY dengan API Key Token Plan (Team Edition)
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)

Buka jendela PowerShell baru untuk verifikasi:
```
echo $env:OPENAI_API_KEY
```

Coding Plan

Untuk model, pilih model yang didukung. Atur variabel lingkungan OPENAI_API_KEY ke API Key khusus Coding Plan.

Chat/Completions API

Coding Plan memerlukan Chat/Completions API. Instal Codex 0.80.0:

npm install -g @openai/codex@0.80.0

model_provider = "Model_Studio_Coding_Plan"
model = "qwen3.7-plus"
[model_providers.Model_Studio_Coding_Plan]
name = "Model_Studio_Coding_Plan"
base_url = "https://coding-intl.dashscope.aliyuncs.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

Konfigurasi Variabel Lingkungan

Atur variabel lingkungan OPENAI_API_KEY ke API Key khusus Coding Plan.

macOS

Periksa shell default Anda:
```
echo $SHELL
```

Atur variabel lingkungan berdasarkan jenis shell Anda:

Zsh

# Ganti YOUR_API_KEY dengan API Key Coding Plan
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

Bash

# Ganti YOUR_API_KEY dengan API Key Coding Plan
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile

Terapkan perubahan:
Zsh
```
source ~/.zshrc
```
Bash
```
source ~/.bash_profile
```

Windows

CMD

Atur variabel lingkungan:

REM Ganti YOUR_API_KEY dengan API Key Coding Plan
setx OPENAI_API_KEY "YOUR_API_KEY"

Buka jendela CMD baru untuk verifikasi:
```
echo %OPENAI_API_KEY%
```

PowerShell

Atur variabel lingkungan:

# Ganti YOUR_API_KEY dengan API Key Coding Plan
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)

Buka jendela PowerShell baru untuk verifikasi:
```
echo $env:OPENAI_API_KEY
```

Pay-as-you-go

Atur OPENAI_API_KEY ke API Key Model Studio Anda dan pilih dari model yang didukung.

Atur base_url sesuai Wilayah Anda. API Key harus sesuai dengan Wilayah yang dipilih:

China North 2 (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1
Singapore: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1. Ganti WorkspaceId dengan ID ruang kerja Anda yang sebenarnya.

Pay-as-you-go mendukung Responses API dan Chat/Completions API. Pilih berdasarkan model Anda:

Responses API

Untuk model yang mendukung OpenAI Responses API (seperti qwen3.7-max), kompatibel dengan versi Codex terbaru.

model_provider = "Model_Studio"
model = "qwen3.7-max"
[model_providers.Model_Studio]
name = "Model_Studio"
base_url = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Chat/Completions API

Untuk model yang hanya mendukung Chat/Completions API, instal Codex 0.80.0:

npm install -g @openai/codex@0.80.0

model_provider = "Model_Studio"
model = "qwen3.6-plus"
[model_providers.Model_Studio]
name = "Model_Studio"
base_url = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

Konfigurasi Variabel Lingkungan

Atur variabel lingkungan OPENAI_API_KEY ke API Key Model Studio.

macOS

Periksa shell default Anda:
```
echo $SHELL
```

Atur variabel lingkungan berdasarkan jenis shell Anda:

Zsh

# Ganti YOUR_API_KEY dengan API Key Model Studio
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

Bash

# Ganti YOUR_API_KEY dengan API Key Model Studio
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile

Terapkan perubahan:
Zsh
```
source ~/.zshrc
```
Bash
```
source ~/.bash_profile
```

Windows

CMD

Atur variabel lingkungan:

REM Ganti YOUR_API_KEY dengan API Key Model Studio
setx OPENAI_API_KEY "YOUR_API_KEY"

Buka jendela CMD baru untuk verifikasi:
```
echo %OPENAI_API_KEY%
```

PowerShell

Atur variabel lingkungan:

# Ganti YOUR_API_KEY dengan API Key Model Studio
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)

Buka jendela PowerShell baru untuk verifikasi:
```
echo $env:OPENAI_API_KEY
```

Verifikasi Konfigurasi

Buka terminal baru dan jalankan Codex:

codex

Jika antarmuka chat muncul, berarti konfigurasi telah berhasil.

FAQ

Apa yang harus saya lakukan jika tool pihak ketiga melaporkan "domestic models not supported" atau "check rejected / Bad request (400)"?

Penyebab: Beberapa tool manajemen pihak ketiga (seperti CC-Switch) mengirim permintaan probe "health check / connection test" saat beralih penyedia. Format probe tersebut berbeda dari format permintaan yang sebenarnya digunakan oleh Codex, sehingga gerbang Model Studio menolaknya dengan kode 400 Bad Request, dan tool tersebut kemudian melaporkan "domestic models not supported". Pesan ini hanya menunjukkan bahwa probe health check gagal; tidak berarti Model Studio tidak mendukung model domestik dan tidak memengaruhi penggunaan Codex secara aktual.

Catatan: Model Studio mendukung penggunaan model domestik seperti qwen3.7-max, qwen3.7-plus, qwen3.6-plus, qwen3.6-flash, dan glm-5 melalui Codex. Untuk detail konfigurasi, lihat Konfigurasi Kredensial Akses di atas.

Solusi: Konfigurasikan Codex langsung di ~/.codex/config.toml seperti yang dijelaskan dalam Konfigurasi Kredensial Akses, tanpa mengandalkan hasil health check dari tool pihak ketiga. Setelah dikonfigurasi, jalankan Codex seperti yang dijelaskan dalam Verifikasi Konfigurasi; jika antarmuka chat muncul secara normal, model domestik berfungsi.

Apa yang harus saya lakukan jika muncul error "wire_api = chat is no longer supported"?

Penyebab: Versi Codex terbaru menggunakan Responses API dan tidak lagi mendukung wire_api = "chat".

Solusi:

Token Plan (Team Edition) atau pay-as-you-go: Ubah wire_api menjadi responses dan pastikan base_url sudah benar.
Coding Plan: Turunkan ke versi lama:
```
npm install -g @openai/codex@0.80.0
```

Apa yang harus saya lakukan jika muncul error unexpected status 401 Unauthorized?

Penyebab:

Ketidaksesuaian API Key (kunci Token Plan, Coding Plan, dan pay-as-you-go tidak dapat saling ditukar)
Langganan telah kedaluwarsa
API Key disalin secara tidak benar (tidak lengkap, mengandung spasi, atau terdapat kesalahan ketik)

Solusi:

Pastikan Anda menggunakan API Key yang sesuai dengan rencana Anda.
Periksa halaman manajemen rencana Anda untuk masa berlaku langganan.
Salin ulang API Key tanpa spasi tambahan.
Jika error tetap muncul, reset API Key di halaman manajemen rencana Anda dan konfigurasikan ulang dengan kunci baru.

Apa yang harus saya lakukan jika muncul error unexpected status 404 Not Found?

Penyebab: base_url atau wire_api dalam file konfigurasi salah.

Solusi: Pastikan base_url dan wire_api sesuai dengan konfigurasi rencana Anda di Konfigurasi Kredensial Akses di atas.