Token Plan (Edição para Equipes)
Ideal com uma versão atual do Codex e os modelos qwen3.7-max, qwen3.7-plus, qwen3.6-plus ou qwen3.6-flash por meio do API Responses.
Atribuição de ferramenta + modelo
Codex com Plano de Codificação e Plano de Créditos da Alibaba (Token Plan)
Ferramenta de programação em linha de comando da OpenAI que pode estar na mesma conversa do comprador que ferramentas de codificação compatíveis com Alibaba.
O Codex pode se conectar ao Alibaba Model Studio por meio de um provedor personalizado em `~/.codex/config.toml`. A compatibilidade depende tanto da versão do modelo API quanto da versão do Codex: a Alibaba documenta o suporte atual do Codex por meio do API Responses para modelos selecionados de Qwen Token Plan.
Escolha a rota de acesso adequada
Escolha a rota de acesso adequada
Use o Token Plan com uma versão atual do Codex e um modelo de Qwen compatível com Responses. Atualmente, a Alibaba orienta os usuários do Coding Plan — bem como os que escolhem outros modelos limitados apenas a Chat/Completions — a instalarem uma versão anterior do Codex, como a 0.80.0. Avalie cuidadosamente essa troca antes de assinar o Codex isoladamente.
RecomendadoToken Plan é a rota mais limpa para uso com a versão atual do Codex
Coding Plan
O guia atual da Alibaba indica que o Coding Plan só suporta atualmente Chat/Completions aqui e orienta os usuários do Codex a instalarem uma versão anterior, como a 0.80.0.
Model Studio Pay-as-you-go API
Use para cargas de trabalho de produção/API ou quando um modelo pay-as-you-go compatível e uma região atendem melhor aos requisitos da sua aplicação.
Padrão seguro de configuração
Configure um provedor compatível com Responses para Token Plan
O exemplo foi deliberadamente omitido. Substitua os espaços reservados apenas em seu dispositivo e nunca cole uma chave real de API no Nfero.
Antes de começar
- Instale o Node.js 18 ou posterior e verifique a versão com `codex --version`.
- Escolha um modelo cujo API seja compatível com a versão do Codex que você pretende executar.
- Obtenha a chave dedicada de Token Plan ou Coding Plan; defina-a como uma variável de ambiente em vez de inseri-la diretamente no arquivo TOML.
- Faça backup do arquivo `~/.codex/config.toml` antes de substituir um provedor OpenAI existente ou um provedor personalizado.
Padrão seguro de configuração
- Protocolo
- OpenAI Responses API
- Caminho da configuração
~/.codex/config.toml
- Defina a chave dedicada real na variável `OPENAI_API_KEY` no seu dispositivo; não a insira diretamente no arquivo abaixo.
- Escolha um dos modelos Qwen compatíveis com Responses, conforme documentado pela Alibaba, para a versão atual do Codex.
- Adicione o provedor personalizado e utilize a URL base do Token Plan.
- Abra um novo terminal e execute `codex` para testar a configuração.
model_provider = "Model_Studio_Token_Plan"
model = "qwen3.7-plus"
[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"
# Set locally; never paste the real value into this file or Nfero:
# OPENAI_API_KEY=YOUR_TOKEN_PLAN_API_KEYVerifique a conexão
- Abra um novo terminal para garantir que a variável `OPENAI_API_KEY` esteja disponível para o Codex.
- Execute `codex --version` e confirme se corresponde à rota API que você configurou.
- Inicie o `codex` e comece com uma pergunta pequena e somente de leitura sobre um repositório.
- Se um alternador de provedor relatar falha na verificação de integridade, teste o próprio Codex; a Alibaba observa que alguns formatos de sondagem podem falhar mesmo quando requisições reais funcionam.
Atribuições de modelos
Modelos recomendados para começar
Use esta ferramenta para executar tarefas interativas de programação, raciocínio, revisão e documentação com cada modelo. Confirme a disponibilidade final do modelo e o suporte exato ao plano na Alibaba Cloud antes do uso em produção.
Qwenqwen3.7-plus
Geração de textoRaciocínioCompreensão visual
Melhor ângulo de emparelhamento
Compatível com Responses sob Token Plan, oferecendo um equilíbrio ideal entre codificação e raciocínio na versão atual.
Qwenqwen3.7-max
Geração de textoRaciocínio
Melhor ângulo de emparelhamento
Modelo principal compatível com Responses da Token Plan, ideal para tarefas complexas de raciocínio e repositórios.
Qwenqwen3.6-flash
Geração de textoRaciocínioCompreensão visual
Melhor ângulo de emparelhamento
Alternativa compatível com Responses da Token Plan para trabalhos com contexto longo.
Problemas comuns
Problemas comuns
O que você vê
Erro 400 (Bad Request) ou um alternador de provedor informa que modelos domésticos não são suportados
Causa provável
A requisição de verificação de integridade de um alternador de terceiros difere daquela enviada pelo Codex.
O que fazer
Teste diretamente a partir do Codex antes de rejeitar o provedor; a falha na sondagem pode não indicar um problema real de compatibilidade.
O que você vê
Erro de resposta API ou erro no protocolo de comunicação
Causa provável
O modelo escolhido suporta apenas Chat/Completions, ou a versão do Codex espera respostas no formato Responses.
O que fazer
Use um modelo Qwen compatível com Responses, conforme documentado, com a versão atual do Codex, ou siga as orientações da Alibaba para versões anteriores, destinadas a rotas exclusivas de Chat/Completions.
O que você vê
Erro 401 ou ausência da chave API
Causa provável
A variável `OPENAI_API_KEY` não está disponível no novo shell ou pertence a outra rota de faturamento da Alibaba.
O que fazer
Defina a chave dedicada do plano na variável de ambiente, abra um novo terminal e associe-a à URL base desse plano.
O que você vê
Cobranças inesperadas do pay-as-you-go
Causa provável
O provedor personalizado está utilizando um endpoint/chave genéricos do Model Studio, em vez do par específico do plano.
O que fazer
Verifique `model_provider`, `base_url` e a origem da variável de ambiente antes de executar outra tarefa.
Restrições importantes
- Use a chave específica de API e a URL base da mesma conta de faturamento da Alibaba. As credenciais do Coding Plan, Token Plan e do Model Studio em geral não são intercambiáveis.
- As chaves de plano são destinadas exclusivamente ao usuário atribuído em ferramentas interativas de codificação ou agentes. Não as compartilhe, não as envie para repositórios nem exponha-as em capturas de tela.
- Não utilize uma chave Coding Plan ou Token Plan para scripts automatizados, trabalhos em lote, back-ends de aplicações, serviços públicos ou outras cargas de trabalho API não interativas. Utilize o acesso API do pay-as-you-go Model Studio para essas cargas de trabalho.
- A disponibilidade dos modelos segue uma lista de permissões com correspondência exata de strings e pode ser alterada. Confirme o ID do modelo na documentação atual do plano da Alibaba antes de editar uma configuração funcional.