Skip to main content

Codex

Gunakan model Alibaba Cloud Model Studio di Codex.

Mulai Cepat

  1. 1

    Buka atau buat file konfigurasi

    • macOS / Linux: ~/.codex/config.toml
    • Windows: C:\Users\<username>\.codex\config.toml
  2. 2

    Konfigurasikan model

    Untuk berpindah antar model, lihat Konfigurasikan metadata model.
    • Token Plan
    • Bayar sesuai pemakaian
    • Coding Plan
    Ganti OPENAI_API_KEY dengan Token Plan API Key Anda:
    model_provider = "Token_Plan"
    model = "auto"
    
    [model_providers.Token_Plan]
    name = "Token_Plan"
    base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
    env_key = "OPENAI_API_KEY"
    wire_api = "responses"
    
  3. 3

    Verifikasi

    Jalankan perintah berikut di direktori proyek Anda:
    codex exec "Hello"
    

Konfigurasikan metadata model

Metadata model digunakan untuk berpindah antar model di Codex. Tanpa konfigurasi ini, model yang ditentukan di config.toml tetap dapat digunakan, tetapi Codex menampilkan peringatan Model metadata ... not found saat startup dan menggunakan metadata default. Setelah dikonfigurasi, berpindah model dengan codex -m atau /model di TUI.
  • Token Plan Personal Edition
  • Token Plan Team Edition
  • Bayar sesuai pemakaian
Buat ~/.codex/model-catalog.local.json dengan konten berikut:
{
  "models": [
    {
      "slug": "auto",
      "display_name": "auto",
      "description": "DashScope model: auto",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": false,
      "input_modalities": [
        "text"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 1,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "qwen4-max-preview",
      "display_name": "qwen4-max-preview",
      "description": "DashScope model: qwen4-max-preview",
      "default_reasoning_level": "xhigh",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 2,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "qwen4-max",
      "display_name": "qwen4-max",
      "description": "DashScope model: qwen4-max",
      "default_reasoning_level": "high",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "high",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 983616,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 2,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "qwen3.8-max",
      "display_name": "qwen3.8-max",
      "description": "DashScope model: qwen3.8-max",
      "default_reasoning_level": "xhigh",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 983616,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 3,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "qwen3.8-flash",
      "display_name": "qwen3.8-flash",
      "description": "DashScope model: qwen3.8-flash",
      "default_reasoning_level": "xhigh",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 983616,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 4,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "qwen3.7-max",
      "display_name": "qwen3.7-max",
      "description": "DashScope model: qwen3.7-max",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": false,
      "input_modalities": [
        "text"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 5,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "qwen3.7-plus",
      "display_name": "qwen3.7-plus",
      "description": "DashScope model: qwen3.7-plus",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 6,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "qwen3.6-flash",
      "display_name": "qwen3.6-flash",
      "description": "DashScope model: qwen3.6-flash",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 7,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "glm-5.3",
      "display_name": "glm-5.3",
      "description": "DashScope model: glm-5.3",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": false,
      "input_modalities": [
        "text"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 8,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "glm-5.2",
      "display_name": "glm-5.2",
      "description": "DashScope model: glm-5.2",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": false,
      "input_modalities": [
        "text"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 9,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "deepseek-v4.1-flash",
      "display_name": "deepseek-v4.1-flash",
      "description": "DashScope model: deepseek-v4.1-flash",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 10,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "deepseek-v4.1-flash-1017",
      "display_name": "deepseek-v4.1-flash-1017",
      "description": "DashScope model: deepseek-v4.1-flash-1017",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 11,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "deepseek-v4-pro",
      "display_name": "deepseek-v4-pro",
      "description": "DashScope model: deepseek-v4-pro",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": false,
      "input_modalities": [
        "text"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 12,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "deepseek-v4-pro-0813",
      "display_name": "deepseek-v4-pro-0813",
      "description": "DashScope model: deepseek-v4-pro-0813",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": false,
      "input_modalities": [
        "text"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 13,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "deepseek-v4-flash-0731",
      "display_name": "deepseek-v4-flash-0731",
      "description": "DashScope model: deepseek-v4-flash-0731",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": false,
      "input_modalities": [
        "text"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 14,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    }
  ]
}
Tambahkan berikut ini ke ~/.codex/config.toml:
model_catalog_json = "~/.codex/model-catalog.local.json"
Setelah dikonfigurasi, tentukan model dengan codex -m (misalnya, codex -m qwen3.8-flash), atau masukkan /model di TUI untuk berpindah antar model yang dikonfigurasi.
qwen4-max memiliki konteks 1M Token. Output maksimum adalah 131.072 Token dalam mode non-thinking dan 262.144 Token untuk thinking dan jawaban akhir secara gabungan. Nilai default adalah reasoning_effort=high dan thinking_budget=131072. Gunakan codex -m qwen4-max untuk memilih model.

Konfigurasi Chat Completions

Codex 0.94.0 dan versi yang lebih baru hanya mendukung Responses API. Jika Anda menggunakan Codex 0.93.0 atau versi yang lebih lama, atau model Anda hanya mendukung Chat Completions, gunakan konfigurasi berikut. Untuk jalur file konfigurasi, lihat Mulai Cepat.
  • Token Plan
  • Bayar sesuai pemakaian
  • Coding Plan
Ganti OPENAI_API_KEY dengan Token Plan API Key Anda:
model_provider = "Token_Plan"
model = "auto"

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

Menggunakan CC Switch

CC Switch adalah GUI desktop sumber terbuka komunitas untuk beralih antara API Key atau paket penagihan.

Menambahkan penyedia

  1. 1
    Di toolbar CC Switch, pilih ikon Codex, klik + untuk membuka Add provider, pilih tab untuk paket penagihan Anda, isi konfigurasi, lalu klik Add.
    • Token Plan
    • Bayar sesuai pemakaian
    • Coding Plan
    • Nama penyedia: Bailian-Token Plan
    • API Key: Dapatkan dari konsol
    • Endpoint: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
  2. 2
    Perluas Advanced options dan masukkan model dari model yang didukung untuk paket Anda, misalnya qwen3.8-max.
  3. 3
    Klik Enable di samping penyedia, lalu buka kembali terminal dan jalankan codex agar konfigurasi berlaku.

Kode Error

Jika Anda mengalami error selama konfigurasi, lihat dokumentasi FAQ untuk paket penagihan Anda:

FAQ

Peringatan ini muncul saat metadata model belum dikonfigurasi. Codex menggunakan metadata default untuk model, dan pemanggilan tidak terpengaruh. Untuk berpindah antar model, lihat Konfigurasikan metadata model.
Pengaturan pay-as-you-go tetap sama: gunakan API key Model Studio umum dan Base URL. Setelah membeli paket penghematan, paket berlaku otomatis dan penggunaan yang memenuhi syarat dipotong secara otomatis. Lihat Paket penghematan.
Penyebab: Beberapa alat manajemen pihak ketiga (seperti CC-Switch) mengirim health check atau probe uji koneksi saat beralih penyedia. Format probe berbeda dari format permintaan yang benar-benar digunakan Codex, sehingga gateway Model Studio dapat mengembalikan 400 Bad request, dan alat tersebut melaporkan "domestic models not supported". Pesan ini hanya menunjukkan bahwa probe gagal; ini tidak berarti Model Studio tidak mendukung model Tiongkok Daratan, dan juga tidak memengaruhi penggunaan Codex yang sebenarnya.Solusi: Konfigurasikan Codex langsung di ~/.codex/config.toml seperti yang dijelaskan dalam Mulai Cepat, tanpa bergantung pada health check alat pihak ketiga. Setelah konfigurasi, ikuti Verifikasi untuk memulai Codex; respons normal berarti model Tiongkok Daratan berfungsi.
Penyebab: Codex 0.94.0 dan versi yang lebih baru tidak lagi mendukung wire_api = "chat". Bergantung pada versi, Anda mungkin melihat salah satu error berikut:
  • wire_api = "chat" is no longer supported
  • unknown configuration field wire_api
Solusi:
  • Error wire_api = "chat" is no longer supported: Ubah wire_api menjadi responses dan verifikasi base_url.
  • Error unknown configuration field wire_api: Hapus wire_api dari bagian penyedia yang sesuai di ~/.codex/config.toml.
  • Untuk terus menggunakan Chat Completions, instal Codex 0.93.0 atau versi yang lebih lama (misalnya 0.80.0).
Penyebab:
  • API Key tersebut milik paket lain (kunci Token Plan, Coding Plan, dan Bayar sesuai pemakaian tidak dapat dipertukarkan).
  • Langganan telah berakhir.
  • API Key disalin secara tidak benar (tidak lengkap, ada spasi tambahan, atau salah ketik).
Solusi:
  • Pastikan Anda menggunakan API Key untuk paket yang dipilih.
  • Periksa halaman manajemen paket untuk melihat apakah langganan telah berakhir.
  • Salin ulang API Key dan pastikan lengkap tanpa spasi.
  • Jika error berlanjut, reset API Key di halaman manajemen paket dan konfigurasikan kunci baru.
Penyebab: base_url atau wire_api di file konfigurasi tidak benar.Solusi: Pastikan base_url dan wire_api sesuai dengan konfigurasi paket Anda. Lihat Mulai Cepat.
Penyebab: Koneksi streaming antara Codex dan server tertutup sebelum respons selesai. Penyebab umum:
  • Utas percakapan terlalu panjang dan pemadatan konteks gagal.
  • Jaringan tidak stabil dan koneksi SSE atau WebSocket terputus.
  • Server kelebihan beban atau pembatasan laju menghentikan koneksi lebih awal.
Solusi:
  • Mulai utas percakapan baru untuk menghindari akumulasi konteks yang berlebihan.
  • Periksa stabilitas jaringan. Nonaktifkan VPN atau proxy lalu coba lagi.
  • Tunggu dan coba lagi. Codex memiliki mekanisme percobaan ulang bawaan yang menyelesaikan sebagian besar kegagalan sementara.
Penyebab: Error 429 memiliki dua penyebab umum:
  • Batas laju permintaan (429 Requests rate limit exceeded): terlalu banyak permintaan dalam waktu singkat.
  • Kuota habis (429 Allocated quota exceeded atau Your token-plan quota has been exhausted): kuota Token Plan bulanan telah habis.
Solusi:
  • Batas laju permintaan: tunggu satu menit dan kurangi laju permintaan.
  • Kuota habis: tunggu bulan langganan berikutnya, beli paket penggunaan (kuota otomatis dipotong dari paket setelah kuota bulanan habis), atau tingkatkan paket. Waktu reset dalam pesan error (misalnya The quota will reset at HH:MM:SS UTC) menggunakan UTC; tambahkan 8 jam untuk mengonversi ke waktu Singapura (CST).