Alibaba Cloud Model Studio:Codex

Token Plan (Team Edition)

Para model, selecione um modelo compatível. Defina a variável de ambiente OPENAI_API_KEY como a API Key dedicada do Token Plan (Team Edition).

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"

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"

Coding Plan

Para model, selecione um modelo compatível. Defina a variável de ambiente OPENAI_API_KEY como a API Key dedicada do Coding Plan.

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"

Pagamento conforme o uso

Defina OPENAI_API_KEY como sua API Key do Model Studio e escolha entre os modelos compatíveis.

Configure base_url para sua região. A API Key deve corresponder à região selecionada:

• China North 2 (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1

• Singapore: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1. Substitua WorkspaceId pelo seu ID do Workspace real

O pagamento conforme o uso oferece suporte tanto à Responses API quanto à Chat/Completions API. Escolha conforme o seu modelo:

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"

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"

codex

O que fazer se uma ferramenta de terceiros reportar "modelos nacionais não suportados" ou "verificação rejeitada / Bad request (400)"?

Causa: Algumas ferramentas de gerenciamento de terceiros (como o CC-Switch) enviam uma requisição de sondagem do tipo "health check / teste de conexão" ao trocar de provedor. O formato dessa sondagem difere do formato de requisição utilizado pelo Codex, o que pode levar o gateway do Model Studio a rejeitá-la com 400 Bad request. A ferramenta então reporta "modelos nacionais não suportados". Essa mensagem indica apenas falha na sondagem de health check; não significa que o Model Studio não ofereça suporte a modelos nacionais, nem afeta o uso real do Codex.

Nota: O Model Studio oferece suporte ao uso de modelos nacionais como qwen3,7-max, qwen3,7-plus, qwen3,6-plus, qwen3,6-flash e glm-5 por meio do Codex. Para detalhes de configuração, consulte Configure credenciais de acesso acima.

Solução: Configure o Codex diretamente em ~/.codex/config.toml conforme descrito em Configure credenciais de acesso, sem depender do resultado do health check da ferramenta de terceiros. Após configurar, inicie o Codex conforme descrito em Verifique a configuração; se a interface de chat iniciar normalmente, os modelos nacionais estarão funcionando.

O que fazer em caso de erro de configuração de wire_api?

Causa: Versões mais recentes do Codex não oferecem mais suporte a 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 se base_url está correto. Consulte Configure credenciais de acesso para exemplos de configuração.

• Erro unknown configuration field wire_api: Remova a linha wire_api da seção do provedor correspondente em ~/.codex/config.toml.

O que fazer ao receber o erro unexpected status 401 Unauthorized?

Causa:

• Incompatibilidade de API Key (as chaves do Token Plan, Coding Plan e pagamento conforme o uso não são intercambiáveis)

• Assinatura expirada

• API Key copiada incorretamente (incompleta, contém espaços ou possui erro de digitação)

Solução:

• Confirme se você está usando a API Key correta para o seu plano.

• Verifique a página de gerenciamento do seu plano quanto à expiração da assinatura.

• Copie novamente a API Key sem espaços extras.

• Se o erro persistir, redefina a API Key na página de gerenciamento do seu plano e reconfigure com a nova chave.

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

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

Solução: Garanta que base_url e wire_api correspondam à configuração do seu plano em Configure credenciais de acesso acima.

O que fazer ao 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 interrompida antes da conclusão da resposta. Isso ocorre geralmente nos seguintes cenários:

• Thread de conversa muito longo, causando falha na requisição de compactação de contexto

• Rede instável, causando queda da conexão SSE ou WebSocket durante o streaming

• Sobrecarga do servidor ou limitação de taxa, encerrando a conexão prematuramente

Solução:

• Inicie um novo thread de conversa para evitar acúmulo excessivo de contexto em um único thread.

• Verifique sua conexão de rede. Tente desativar VPN ou proxy e tente novamente.

• Aguarde e tente novamente. O Codex possui um mecanismo de nova tentativa integrado que resolve automaticamente a maioria das falhas transitórias.