Todos os produtos
Search

Este produto

    Alibaba Cloud Model Studio:Codex

    Central de documentação

    Alibaba Cloud Model Studio:Codex

    Última atualização: Nov 05, 2026

    Use modelos do Alibaba Cloud Model Studio no Codex.

    Início rápido

    1. 1

      Abra ou crie o arquivo de configuração

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

      Configure o modelo

      Token Plan

      Substitua OPENAI_API_KEY pela sua API Key do Token Plan:

      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"

      Pagamento conforme o uso

      Substitua OPENAI_API_KEY pela sua API Key do Alibaba Cloud Model Studio e substitua {WorkspaceId} pelo seu ID do Workspace real. O exemplo a seguir usa Singapura.

      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"

      Coding Plan

      Substitua OPENAI_API_KEY pela sua API Key do Coding Plan. O Coding Plan usa a API Chat Completions e requer o Codex 0.93.0 ou uma versão anterior:

      npm install -g @openai/codex@0.93.0

      model_provider = "Coding_Plan"
model = "qwen3.7-plus"

[model_providers.Coding_Plan]
name = "Coding_Plan"
base_url = "https://coding-intl.dashscope.aliyuncs.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"
    3. 3

      Verifique

      Execute o comando a seguir no diretório do seu projeto:

      codex exec "Hello"

    Configuração do Chat Completions

    O Codex 0.94.0 e versões posteriores são compatíveis apenas com a API Responses. Se você usar o Codex 0.93.0 ou uma versão anterior, ou se o seu modelo for compatível apenas com Chat Completions, use a configuração a seguir. Para o caminho do arquivo de configuração, consulte Início rápido.

    Token Plan

    Substitua OPENAI_API_KEY pela sua API Key do Token Plan:

    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"

    Pagamento conforme o uso

    Substitua OPENAI_API_KEY pela sua API Key do Alibaba Cloud Model Studio e substitua {WorkspaceId} pelo seu ID do Workspace real. O exemplo a seguir usa Singapura:

    model_provider = "Model_Studio"
model = "qwen3.8-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 = "chat"

    Coding Plan

    Substitua OPENAI_API_KEY pela sua API Key do Coding Plan.

    model_provider = "Coding_Plan"
model = "qwen3.7-plus"

[model_providers.Coding_Plan]
name = "Coding_Plan"
base_url = "https://coding-intl.dashscope.aliyuncs.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

    Usar o CC Switch

    O CC Switch é uma GUI desktop de código aberto da comunidade que permite alternar entre API Keys ou planos de cobrança.

    Adicionar um provedor

    1. 1

      Na barra de ferramentas do CC Switch, selecione o ícone do Codex, clique em + para abrir Add provider, selecione a aba do seu plano de cobrança, preencha a configuração e clique em Add.

      Token Plan

      • Nome do provedor: Bailian-Token Plan
      • API Key: Obter no console
      • Endpoint: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

      Pagamento conforme o uso

      • Nome do provedor: Bailian-Pay-as-you-go
      • API Key: Obter no console
      • Endpoint: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

      Coding Plan

      • Nome do provedor: Bailian-Coding Plan
      • API Key: Obter no console
      • Endpoint: https://coding-intl.dashscope.aliyuncs.com/v1
    2. 2

      Expanda Advanced options e insira um modelo dos modelos compatíveis para o seu plano, como qwen3.8-max.

    3. 3

      Clique em Enable ao lado do provedor, reabra o terminal e execute codex para que a configuração passe a valer.

    Códigos de erro

    Se você encontrar erros durante a configuração, consulte a documentação de perguntas frequentes do seu plano de cobrança:

    Perguntas frequentes

    Como usar um plano de economia com pagamento conforme o uso?

    A configuração de pagamento conforme o uso permanece a mesma: use a chave de API geral do Model Studio e a Base URL. Após comprar um plano de economia, ele entra em vigor automaticamente e o uso elegível é deduzido automaticamente. Consulte Planos de economia.

    O que devo fazer se uma ferramenta de terceiros relatar "domestic models not supported" ou "check rejected / Bad request (400)"?

    Causa: Algumas ferramentas de gerenciamento de terceiros (como o CC-Switch) enviam uma verificação de integridade ou um teste de conexão ao alternar de provedor. O formato do teste é diferente do formato de requisição que o Codex realmente usa, portanto o gateway do Model Studio pode retornar 400 Bad request, e a ferramenta relata "domestic models not supported". Essa mensagem indica apenas que o teste falhou; não significa que o Model Studio não tenha suporte a modelos da China (continental), nem afeta o uso real do Codex.

    Solução: Configure o Codex diretamente em ~/.codex/config.toml conforme descrito em Início rápido, sem depender da verificação de integridade da ferramenta de terceiros. Após a configuração, siga Verifique para iniciar o Codex; uma resposta normal indica que os modelos da China (continental) estão funcionando.

    O que devo fazer se receber um erro de configuração de wire_api?

    Causa: O Codex 0.94.0 e versões posteriores não são mais compatíveis com wire_api = "chat". Dependendo da versão, você pode ver um dos seguintes erros:

    • wire_api = "chat" is no longer supported
    • unknown configuration field wire_api

    Solução:

    • Erro wire_api = "chat" is no longer supported: altere wire_api para responses e verifique base_url.
    • Erro unknown configuration field wire_api: remova wire_api da seção do provedor correspondente em ~/.codex/config.toml.
    • Para continuar usando o Chat Completions, instale o Codex 0.93.0 ou uma versão anterior (como 0.80.0).

    O que devo fazer se receber o erro unexpected status 401 Unauthorized?

    Causa:

    • A API Key pertence a outro plano (as chaves do Token Plan, do Coding Plan e do Pagamento conforme o uso não são intercambiáveis).
    • A assinatura expirou.
    • A API Key foi copiada incorretamente (incompleta, com espaços extras ou com erro de digitação).

    Solução:

    • Confirme que você está usando a API Key do plano selecionado.
    • Verifique a página de gerenciamento do plano para saber se a assinatura expirou.
    • Copie novamente a API Key e certifique-se de que ela esteja completa e sem espaços.
    • Se o erro persistir, redefina a API Key na página de gerenciamento do plano e configure a nova chave.

    O que devo fazer se receber o erro unexpected status 404 Not Found?

    Causa: base_url ou wire_api no arquivo de configuração está incorreto.

    Solução: Certifique-se de que base_url e wire_api correspondam à configuração do seu plano. Consulte Início rápido.

    O que devo fazer se receber o erro "stream disconnected before completion: stream closed before response.completed"?

    Causa: A conexão de streaming entre o Codex e o servidor foi encerrada antes da conclusão da resposta. Causas comuns:

    • A conversa está muito longa e a compactação de contexto falha.
    • A rede está instável e a conexão SSE ou WebSocket cai.
    • O servidor está sobrecarregado ou o limite de taxa encerra a conexão antecipadamente.

    Solução:

    • Inicie uma nova conversa para evitar acúmulo excessivo de contexto.
    • Verifique a estabilidade da rede. Desative a VPN ou o proxy e tente novamente.
    • Aguarde e tente novamente. O Codex tem um mecanismo de nova tentativa integrado que resolve a maioria das falhas temporárias.

    O que devo fazer se receber um erro 429 de limite de taxa ou de cota?

    Causa: Um erro 429 tem duas causas comuns:

    • Limite de taxa de requisições (429 Requests rate limit exceeded): muitas requisições em um curto período.
    • Cota esgotada (429 Allocated quota exceeded ou Your token-plan quota has been exhausted): a cota mensal do Token Plan foi usada por completo.

    Solução:

    • Limite de taxa de requisições: aguarde um minuto e reduza a taxa de requisições.
    • Cota esgotada: aguarde o próximo mês de assinatura, compre um pacote de uso (a cota é deduzida automaticamente do pacote depois que a cota mensal é usada por completo) ou faça upgrade do plano. O horário de redefinição na mensagem de erro (como The quota will reset at HH:MM:SS UTC) está em UTC; adicione 8 horas para converter para o horário de Singapura (CST).