Problemas de conexão e configuração
Erros comuns e soluções
Mensagem de erro | Possível causa | Solução |
|---|---|---|
400 InvalidParameter: Range of input length should be [1, xxx] | A entrada excede o comprimento permitido. |
|
401 invalid access token or token expired |
|
|
model 'xxx' is not supported |
| Use um ID de modelo suportado por {{XREF_3}}. Os IDs de modelo diferenciam maiúsculas de minúsculas e não devem conter espaços à esquerda ou à direita. |
403 invalid api-key | Você está usando a URL base geral do Model Studio em vez da URL base específica do plano. | Endpoint compatível com Anthropic: Endpoint compatível com OpenAI: |
404 status code (no body) | O caminho da URL base está incorreto. Por exemplo, você definiu incorretamente a URL base como | Endpoint compatível com Anthropic: Endpoint compatível com OpenAI: |
Connection error | A URL base está incorreta ou há um problema de rede. | Verifique a ortografia da URL base e sua conexão de rede. |
Connection closed mid-response (geralmente acompanhado por | A resposta em streaming foi interrompida durante a transferência e não retornou completamente. Isso geralmente ocorre devido à instabilidade de rede ou a um proxy local instável (VPN/HTTP Proxy) que encerra a conexão persistente com |
|
hour allocated quota exceeded | A cota de solicitações de 5 horas foi esgotada. | Aguarde 5 horas para que a cota seja redefinida automaticamente. |
week allocated quota exceeded | A cota de solicitações semanal foi esgotada. | A cota é redefinida às 00:00:00 (UTC+8) de segunda-feira. |
month allocated quota exceeded | A cota de solicitações mensal foi esgotada. | A cota é redefinida às 00:00:00 (UTC+8) no dia correspondente do seu próximo mês de assinatura. |
concurrency allocated quota exceeded | O número de solicitações simultâneas excedeu o limite alocado dinamicamente. | Aguarde um momento e tente novamente. A plataforma ajusta esse limite com base na carga de recursos, portanto, esse erro é mais provável durante horários de pico. |
429 usage allocated quota exceeded | As solicitações foram enviadas com muita frequência em um curto período, acionando o limite de taxa de chamadas do modelo. | Aguarde um minuto e tente novamente. Se esse erro ocorrer com frequência, reduza a frequência das suas solicitações e verifique se sua chave de API não está sendo compartilhada com outras pessoas. |
Claude Code: Mensagem "Switched to native installer"
Isso não afeta o uso normal do Claude Code. Execute claude install no terminal para migrar o Claude Code para a instalação nativa oficial e siga o comando retornado no terminal para concluir a migração da configuração.
Claude Code: Erro "Unable to connect"
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST
Please check your internet connection and network settings.
Note: Claude Code might not be available in your country. Check supported
countries at https://anthropic.com/supported-countries
Causa: Na primeira inicialização, o Claude Code tenta se conectar a api.anthropic.com para autenticação inicial. Essa conexão falha porque o Claude Code não está disponível em alguns países e regiões.
Solução:
-
Adicione
"hasCompletedOnboarding": truecomo um campo de nível superior em~/.claude.json.Para uma solução automatizada, use Qwen Code . Inicie o Qwen Code executando
qwenno terminal e envie a seguinte mensagem de chat:Please add "hasCompletedOnboarding": true as a top-level field in the ~/.claude.json file without overwriting existing content.
{
"hasCompletedOnboarding": true
}
- Salve o arquivo e reinicie o Claude Code.
claude
OpenCode: Erro "Request entity too large"
Esse erro indica que o conteúdo da solicitação, como contexto de código ou histórico de conversa, excede o limite máximo de entrada. Para resolver este problema:
- Execute
/newpara criar uma nova conversa ou execute/compactpara compactar o contexto. Para mais métodos de mitigação de estouro de contexto, consulte a documentação. - Caso o problema persista, atualize o OpenCode para a versão 1.2.16 ou posterior. Esta versão inclui uma correção para este problema.
OpenCode: Erro de parâmetro "thinking_budget"
Causa: O valor de budgetTokens no arquivo de configuração opencode.json excede o thinking_budget máximo suportado pelo modelo atual. Os limites variam conforme o modelo. Ajuste sua configuração de acordo com a tabela abaixo.
Nome do modelo | Orçamento máximo de pensamento |
|---|---|
qwen3,7-plus | 262.144 |
qwen3,6-plus | 81.920 |
qwen3,5-plus | 81.920 |
qwen3-max-2026-01-23 | 81.920 |
kimi-k2,5 | 81.920 |
glm-5 | 32.768 |
glm-4,7 | 32.768 |
MiniMax-M2,5 | Ativado por padrão. O parâmetro budgetTokens não é necessário. |
qwen3-coder-next | Modo de pensamento não suportado. |
qwen3-coder-plus | Modo de pensamento não suportado. |
Solução: Abra o arquivo de configuração do OpenCode opencode.json e ajuste o valor de options.thinking.budgetTokens para que não exceda o limite do modelo. Para modelos que não suportam o modo de pensamento, como qwen3-coder-next e qwen3-coder-plus, remova o item de configuração options.thinking. Para obter detalhes, consulte OpenCode.
OpenCode: Erro de intervalo "max_tokens"
Causa: O valor de limit.output no arquivo de configuração opencode.json excede o número máximo de tokens de saída (max_tokens) suportado pelo modelo atual.
Solução: Modifique o arquivo de configuração opencode.json e ajuste o valor de limit para o modelo correspondente de acordo com OpenCode.
Os modelos do Coding Plan suportam o modo de pensamento?
A maioria dos modelos do Coding Plan que suportam pensamento profundo tem o modo de pensamento ativado por padrão. Para ativá-lo em ferramentas comuns:
O modelo que você está usando deve suportar o modo de pensamento.
Claude Code
Ativar modo de pensamento: Insira /config, navegue até Thinking mode e pressione Enter para alterar o valor para true.
Visualizar o processo de pensamento: Pressione Ctrl + O.
● I am Claude Code, the official command-line interface tool from Anthropic. 05:13 PM kimi-k2.5
My core purpose is to be a software engineering assistant:
- Write, modify, and debug code
- Explore and analyze codebases
- Run terminal commands and automate tasks
- Provide technical code explanations and suggestions
My output style is concise and direct, prioritizing technical accuracy. I am powered by Claude Opus 4.6
and use tools to complete tasks rather than just having a conversation.
∴ Thinking…
The user asked, "Think and then tell me: who are you?" I need to think before answering.
Based on the system prompt, I am Claude Code, the official CLI tool from Anthropic. I am powered by Claude Opus 4.6
(based on the model ID in the background information: 'claude-opus-4-6').
My characteristics are:
1. Focus on software engineering tasks.
2. Use tools to complete tasks (not just converse).
3. Maintain a concise and professional tone.
4. Do not use emojis proactively.
5. Prioritize technical accuracy over emotional validation.
I need to think before answering, so I should give a concise and accurate self-introduction.
OpenCode
Para obter detalhes, consulte OpenCode. Configure o parâmetro options da seguinte forma:
{
"thinking": {
"type": "enabled",
"budgetTokens": 1024
}
}
budgetTokensé o número máximo de tokens para pensamento. Você pode ajustá-lo conforme necessário.
Qwen Code
Abra ~/.qwen/settings.json e, na propriedade modelProviders, defina o parâmetro enable_thinking como true para ativar o modo de pensamento:
{
"ide": {
"hasSeenNudge": true
},
"env": {
"BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxx"
},
"modelProviders": {
"openai": [
{
"id": "qwen3.6-plus",
"name": "[Bailian Coding Plan] qwen3.6-plus",
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"envKey": "BAILIAN_CODING_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
...
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"codingPlan": {
"region": "china",
"version": "xxx"
},
"model": {
"name": "qwen3.6-plus"
},
"$version": 3
}
{
"ide": {
"hasSeenNudge": true
},
"env": {
"BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxx"
},
"modelProviders": {
"openai": [
{
"id": "qwen3.6-plus",
"name": "[Bailian Coding Plan] qwen3.6-plus",
"baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
"envKey": "BAILIAN_CODING_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
...
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"codingPlan": {
"region": "china",
"version": "xxx"
},
"model": {
"name": "qwen3.6-plus"
},
"$version": 3
}
OpenClaw
Para ativar o modo de pensamento no OpenClaw, siga estas etapas:
-
Verificar a versão do OpenClaw
Execute
openclaw tuino terminal para entrar na TUI. Na caixa de diálogo, insiraopenclaw --versionpara verificar se a sua versão do OpenClaw év2026.03.02ou posterior. Versões anteriores do OpenClaw podem não conseguir ativar o modo de pensamento.
openclaw --version
OpenClaw 2026.3.8 (commit: 3caab92)
-
Selecionar um nível de pensamento
Na TUI do OpenClaw, insira o comando
/think highpara selecionar o nível de pensamento (neste exemplo,highé selecionado como o nível de pensamento para a sessão atual).
/think high
→ high
-
Modificar o arquivo de configuração
-
Definir o parâmetro
compatConsulte OpenClaw, abra o arquivo de configuração e adicione o parâmetro
compatà configuração do modelo que suporta o modo de pensamento:
-
"compat": {
"thinkingFormat": "qwen"
}
-
Definir o parâmetro
reasoningNa mesma configuração de modelo, defina o parâmetro
reasoningcomotrue:
{
"id": "qwen3-max-2026-01-23",
"name": "qwen3-max-2026-01-23",
"reasoning": true,
"compat": {
"thinkingFormat": "qwen"
},
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 262144,
"maxTokens": 65536
}
-
Reiniciar o Gateway do OpenClaw
Após salvar o arquivo de configuração, execute o seguinte comando no terminal para reiniciar o Gateway do OpenClaw e aplicar as alterações.
openclaw gateway restart
OpenClaw: Registros de chamadas para modelos não configurados
Motivo: O arquivo openclaw.json não possui a configuração agents.defaults.models para restringir o intervalo de modelos disponíveis.
Solução: Em ~/.openclaw/openclaw.json, declare explicitamente a lista de modelos permitidos em agents.defaults.models para restringir o OpenClaw a chamar apenas os modelos configurados. Para mais informações, consulte OpenClaw.
OpenClaw: Chat não responde após a conexão
As possíveis causas incluem:
- Um proxy local (VPN/HTTP Proxy) intercepta ou não consegue encaminhar corretamente as solicitações para
coding.dashscope.aliyuncs.com. - A URL Base no arquivo de cache do OpenClaw
~/.openclaw/agents/main/agent/models.jsonaponta para um endereço incorreto, e as solicitações são enviadas para um endpoint que não responde.
Solução:
- Tente desativar o proxy local ou garanta que o proxy possa acessar
coding.dashscope.aliyuncs.com. - Exclua o arquivo de cache
~/.openclaw/agents/main/agent/models.jsone reinicie o OpenClaw. Após a reinicialização, o arquivo de cache será reconstruído automaticamente com base na configuração em~/.openclaw/openclaw.json.
OpenClaw: Erro "OAuth token refresh failed"
Esse erro indica que você está conectado a um service OAuth de terceiros, não a um Coding Plan.
Solução:
-
Configure o Coding Plan no OpenClaw. Para obter detalhes, consulte OpenClaw.
-
Limpe as credenciais antigas do OAuth e o cache de modelos e, em seguida, reinicie o OpenClaw.
Antes de excluir credenciais antigas do OAuth, faça backup dos arquivos para permitir uma reversão, se necessário.
rm ~/.openclaw/agents/main/agent/auth.json
rm ~/.openclaw/agents/main/agent/models.json
openclaw gateway restart
OpenClaw: Erro "Unknown model"
Esse erro indica que o OpenClaw não consegue encontrar o modelo especificado no arquivo de configuração. Verifique os seguintes itens nesta ordem:
-
Configuração incorreta da chave
models.providersou prefixo do modeloAo usar o Coding Plan,
models.providersdeve conter a chavebailian(que pode coexistir com outros provedores). Além disso,agents.defaults.model.primarydeve ter o prefixobailian/. A estrutura correta é a seguinte:
// Configuration file: ~/.openclaw/openclaw.json
{
"models": { "providers": { "bailian": {...} } },
"agents": { "defaults": { "model": { "primary": "bailian/qwen3.6-plus" } } }
}
-
Configurações residuais de provedores antigos estão causando conflitos de roteamento
Se você já usou outros provedores, como qwen-portal, configurações residuais de provedores podem causar confusão no roteamento de modelos. Limpe provedores irrelevantes e garanta que o modelo apontado pelo campo
primaryesteja definido corretamente na listamodels.providers.bailian.models. Para informações de configuração, consulte OpenClaw.
O que é qwen-portal/coder-model?
qwen-portal/coder-model é um modelo gratuito fornecido pela versão web do Qwen Chat e não faz parte do Model Studio. Se você tentar usar este modelo no Model Studio ou no Coding Plan, receberá um erro indicando que o modelo não existe. Use modelos suportados pelo Model Studio.
OpenClaw: Erro "No API key found"
Esse erro indica que o OpenClaw não consegue encontrar a chave de API para o provedor (xxxxx) especificado na mensagem de erro. Verifique os seguintes itens nesta ordem:
-
A configuração do provedor correspondente está ausente em
models.providers.Abra o arquivo de configuração
~/.openclaw/openclaw.jsone confirme se existe uma chave que corresponda ao nome do provedor na mensagem de erro sobmodels.providers.- Se você se conectar ao Coding Plan, a configuração deve incluir a chave
bailian(pode coexistir com outros provedores). - Se a chave estiver ausente, adicione a configuração do provedor correspondente.
- Se você se conectar ao Coding Plan, a configuração deve incluir a chave
-
A chave de API do provedor está configurada incorretamente.
- Certifique-se de ter inserido uma chave de API válida, que não esteja vazia e não tenha espaços extras.
- Se você usar o Coding Plan, certifique-se de usar a chave do plano (
sk-sp-xxx). - Se a interface web exibir
__OPENCLAW_REDACTED__, a chave de API já está salva e não precisa ser reinserida. Se estiver em branco ou exibirYOUR_API_KEY, você deve inserir a chave novamente.
-
Um cache de credenciais locais desatualizado está impedindo que a nova configuração entre em vigor.
Antes de excluir credenciais antigas, faça backup dos arquivos para permitir uma reversão, se necessário.
# Delete old credentials and model cache
rm ~/.openclaw/agents/main/agent/auth-profiles.json
rm ~/.openclaw/agents/main/agent/models.json
# Restart the Gateway to apply the new configuration
openclaw gateway restart
OpenClaw: Erro "API rate limit reached"
Verifique os seguintes itens nesta ordem:
-
Configuração incorreta do OpenClaw
Se a URL base ou o provedor de modelos estiver configurado incorretamente, as solicitações podem não ser roteadas pelo canal do Coding Plan e, em vez disso, serem roteadas para chamadas gerais de API, acionando um limite de taxa.
- Se você usar a assinatura do Coding Plan, verifique se
models,agentsegateway(incluindo campos aninhados) em OpenClaw configuration file são consistentes com as configurações na documentação. Por exemplo, a estrutura para um provedor de service de modelo é{ "models": { "providers": { "bailian": {...} } } }. - Se você não tiver uma assinatura do Coding Plan, mude para uma para obter cota do plano.
- Se você usar a assinatura do Coding Plan, verifique se
-
Cota da assinatura excedida: Verifique o uso da sua assinatura na página do Coding Plan.
-
Tente redefinir a chave de API: Se o problema persistir após concluir as verificações anteriores, acesse a página do Coding Plan para redefinir sua chave de API.
OpenClaw: Erro "Failed to discover" na inicialização
O OpenClaw mostra um dos seguintes erros na inicialização:
Failed to discover Alibaba Cloud models: TimeoutError: The operation was aborted due to timeoutFailed to discover Alibaba Cloud models: 404 Not Found
Causa: O OpenClaw tenta consultar a lista de modelos para o Coding Plan do Model Studio, mas essa lista de modelos não pode ser consultada por meio de uma API.
Solução:
- Esta mensagem não afeta a operação normal do OpenClaw e pode ser ignorada.
- Se o OpenClaw não funcionar corretamente, verifique outras mensagens de erro.
- Para suprimir este aviso, exclua
alibaba-cloud:default profiledo arquivo~/.openclaw/agents/main/agent/auth-profiles.json. Por exemplo:
"profiles": {
"alibaba-cloud:default": {
"type": "api_key",
"provider": "alibaba-cloud",
"key": "sk-sp-xxxxx"
}
}
Depois de alterar para "profiles": {}, o aviso não aparecerá mais.
OpenClaw: Erro "auth.profiles"
Você pode ver erros semelhantes aos seguintes ao usar o OpenClaw:
auth.profiles.qwen-portal:default.mode: Invalid inputauth.profiles.qwen-portal:default: Unrecognized key: "apiKey"
Causa: O campo auth.profiles no arquivo openclaw.json foi modificado incorretamente, como alterar o mode para um valor inválido ou adicionar o campo apiKey. O campo auth armazena apenas metadados de autenticação, não chaves secretas. O Coding Plan não precisa ser configurado em auth.profiles.
- Corrija a configuração de
auth.profilesexcluindo campos adicionados ou modificados incorretamente e perfis desnecessários. - Confirme se a chave de API para o Coding Plan está configurada em
models.providers.bailian.apiKey. Para mais informações, consulte OpenClaw.
O Coding Plan suportaAgent Teamsno Claude Code?
Não suportado. O seguinte erro é relatado: "model claude-opus-4-6 is not supported.".
O Coding Plan suporta a API Responses da OpenAI?
Não. O Coding Plan suporta apenas o protocolo OpenAI Chat Completions e o protocolo Anthropic Messages. A API Responses da OpenAI não é suportada.
Erro "HTTP 401: Incorrect API key provided"
Possíveis causas:
-
Formato de chave de API inválido: A chave de API está vazia, tem um formato incorreto, está incompleta ou contém espaços extras. Certifique-se de usar a Chave de API para o Coding Plan, que começa com
sk-sp-. Copie toda a chave e certifique-se de que ela não contenha espaços extras. -
Assinatura do Coding Plan expirada ou inválida: Uma chave de API específica do Coding Plan depende do status da assinatura. Se sua assinatura do Coding Plan expirou ou é inválida, a chave correspondente não funcionará mais. Garanta que sua assinatura esteja ativa.
-
URL Base incorreta: Você configurou uma chave de API específica do Coding Plan (que começa com
sk-sp-), mas a URL Base ainda está definida como o endereço padrão do Model Studio, como https://dashscope-intl.aliyuncs.com/compatible-mode/v1. Com base em the AI tool that you are integrating, substitua a URL Base pelo endereço específico correspondente do Coding Plan na tabela abaixo.Ferramenta
Protocolo
URL Base
OpenClaw
Compatível com OpenAI
https://coding -intl.dashscope.aliyuncs.com/v1
OpenCode
Compatível com Anthropic
https://coding -intl.dashscope.aliyuncs.com/apps/anthropic/v1
Claude Code
Compatível com Anthropic
https://coding -intl.dashscope.aliyuncs.com/apps/anthropic
Cursor
Compatível com OpenAI
https://coding -intl.dashscope.aliyuncs.com/v1
VSCode Cline
Compatível com OpenAI
https://coding -intl.dashscope.aliyuncs.com/v1
Qwen Code
Compatível com OpenAI
https://coding -intl.dashscope.aliyuncs.com/v1
-
Chave de API incorreta usada: Você configurou a URL Base do Coding Plan, mas inseriu incorretamente a chave de API geral para o Model Studio, que começa com
sk-. Atualize a chave de API para a Chave de API do Coding Plan. -
Erro de configuração causado por cache obsoleto do OpenClaw: No arquivo
~/.openclaw/agents/main/agent/models.json, exclua o item de configuraçãoproviders.bailiane reinicie o OpenClaw.
Erro "Authentication failed" com token do ModelScope
Esse erro indica que você está conectado ao service de terceiros ModelScope, não a um Coding Plan. Para se conectar a um Coding Plan, consulte Connect to client or development tools.
Este erro ocorre quando você fornece uma credencial incorreta para o service de API do ModelScope . Verifique os seguintes itens nesta ordem:
- Você inseriu as credenciais de acesso erradas para a plataforma: Um token do ModelScope tem o formato
ms-xxx, enquanto uma chave de API geral para o Alibaba Cloud Model Studio tem o formatosk-xxx. As duas são plataformas independentes e suas credenciais de acesso não são intercambiáveis. Acesse ModelScope para obter um token. - Formato incorreto: Certifique-se de que não haja espaços extras ou quebras de linha ao copiar o token do ModelScope.
Erro "Only available for Coding Agents"
Esse erro indica que a chamada foi feita a partir de uma ferramenta ou ambiente não suportado.
O Coding Plan é destinado exclusivamente ao uso dentro de ferramentas de programação, como Claude Code e Qwen Code, e não é suportado em ferramentas como curl, Postman ou Dify.
Problemas de faturamento e cota
Cobranças inesperadas com um Coding Plan
Se você continuar a incorrer em cobranças ou tiver um pagamento em atraso após assinar um Coding Plan, isso pode ser devido a um dos seguintes motivos:
-
Configuração incorreta da Chave de API e URL Base específicas do plano (Motivo mais comum)
- Causa: Se você configurar sua ferramenta de IA com uma Chave de API geral (no formato
sk-xxx) e uma URL Base geral (que não contém a palavra-chavecoding), o sistema identifica as chamadas como pagamento conforme o uso e as fatura adequadamente. - Solução: Você deve usar a configuração do Coding Plan. A Chave de API deve estar no formato
sk-sp-xxx, e a URL Base deve conter a palavra-chavecoding(como https://coding -intl.dashscope.aliyuncs.com/xxx). Para mais informações, consulte Obtain the plan API Key and Base URL.
- Causa: Se você configurar sua ferramenta de IA com uma Chave de API geral (no formato
-
Pagamento em atraso causado por atrasos de faturamento (cobranças incorridas antes de assinar o Coding Plan)
- Causa: As faturas são agregadas por minuto, e a geração da fatura pode ser atrasada por alguns minutos. Por exemplo, uma chamada de API feita às 16:00 pode não ser faturada até às 16:05, o que pode ser depois que você assinou o Coding Plan.
- Solução: As cobranças são baseadas no horário real de faturamento. Para obter detalhes, consulte Bill queries and cost management.
-
Uso de credenciais de API gerais por engano
- Causa: Se ambas as configurações gerais e específicas do plano estiverem salvas em sua ferramenta, algumas ferramentas (como o OpenClaw) podem rotear automaticamente as solicitações usando as credenciais gerais, resultando em cobranças.
- Solução: Recomendamos remover a configuração de API geral da sua ferramenta e garantir que você selecione um model supported by the Coding Plan. Por exemplo, no OpenCode, selecione um modelo com o provedor rotulado como 'Model Studio Coding Plan'.
-
Cache do cliente não limpo
- Causa: Depois de configurar novas credenciais, algumas ferramentas ainda podem usar versões em cache das antigas credenciais de API gerais.
- Solução: Limpe o cache e reinicie a ferramenta. Por exemplo, com o OpenClaw, exclua o arquivo
~/.openclaw/agents/main/agent/models.json, executeopenclaw gateway restartpara reiniciar o service e, em seguida, reconfigure-o de acordo com a documentação OpenClaw.
Esgotamento de cota
- Plano Lite: Se você esgotar sua cota de 5 horas ou semanal, aguarde a redefinição automática. Se esgotar sua cota mensal, você deve esperar até o próximo ciclo de assinatura para que ela seja redefinida.
- Plano Pro: Caso esgote sua cota de 5 horas ou semanal, aguarde a redefinição automática. Ao esgotar sua cota mensal, é necessário aguardar até o próximo ciclo de assinatura para a redefinição.
Mudança automática para pagamento conforme o uso
Não. Após o esgotamento da cota do seu Coding Plan, chamadas adicionais de API falharão com um erro, e o uso não mudará automaticamente para pagamento conforme o uso. Para continuar usando o service, você deve esperar que sua cota seja redefinida no próximo ciclo de assinatura.
Teste gratuito e Coding Plan
O Coding Plan é uma assinatura independente. Seu sistema de faturamento e cota é separado do programa de teste gratuito para modelos de uso geral no Model Studio.
Cálculo do período de assinatura
Sua assinatura torna-se ativa no momento da compra e expira às 23:59:59 (UTC+8) no dia correspondente do mês seguinte. Se o mês seguinte não tiver um dia correspondente, a assinatura expira às 23:59:59 (UTC+8) no último dia desse mês.
Por exemplo: Se você assinar um Coding Plan em 3 de fevereiro de 2026, ele será válido até 3 de março de 2026.
Visualização do consumo de tokens
Atualmente, isso não é suportado. O consumo de cota do Coding Plan é baseado no número de chamadas de modelo, não no consumo de tokens. Você pode visualizar suas informações de uso na página do Coding Plan.
Uso por modelo específico
Isso não é suportado. A página do Coding Plan exibe apenas o consumo geral e a cota restante para todo o plano.
Assinatura anual
Atualmente, o Coding Plan está disponível apenas como uma assinatura mensal. Um plano anual ainda não está disponível.
Falha na renovação automática
Isso pode ser devido aos seguintes motivos:
- Configuração ainda não efetivada: A renovação automática entra em vigor no dia seguinte à ativação, não imediatamente.
- Fundos insuficientes: As cobranças de renovação automática são deduzidas dos métodos de pagamento vinculados à sua conta. Certifique-se de que seus métodos de pagamento sejam válidos e tenham fundos suficientes.
Renovação após expiração
Não, a renovação não é suportada após a expiração da assinatura.
Erro de renovação duplicada
Causa: Você já renovou sua assinatura para o próximo mês, e a renovação para meses adicionais não é suportada.
Período de service de renovação antecipada
Ao adquirir um plano mensal, a duração da assinatura é calculada por mês civil. O plano torna-se ativo após a compra e expira às 23:59:59 (UTC+8) no dia correspondente do mês seguinte. Se o próximo mês não tiver um dia correspondente, ele expira às 23:59:59 (UTC+8) no último dia desse mês. Se você renovar antecipadamente, o novo período se estende a partir da data de expiração original.
Por exemplo:
- Uma assinatura inicial em 15 de março às 10:00 expira em 15 de abril às 23:59:59.
- Se você renovar por um mês em 10 de abril, a nova data de expiração se estende até 15 de maio às 23:59:59.
Uso de cupons para renovação
Sim, você pode usar cupons de uso geral.
Renovação de assinatura
Você pode renovar o plano Pro na página do Coding Plan ou na página de Renovação. Para informações sobre a descontinuação das renovações para o plano Lite Basic, consulte o Aviso.
Recursos do product
Modelos suportados
Tanto os planos Lite quanto Pro suportam todos os modelos incluídos no plano (incluindo Qwen, GLM, Kimi e MiniMax). Para uma lista completa de modelos, consulte Coding Plan Overview.
Atualizações da lista de modelos
A lista de modelos suportados é atualizada periodicamente. Para a lista atual, consulte a página Coding Plan Overview.
Limite de assinatura
Cada conta do Model Studio pode assinar apenas um Coding Plan por vez (independentemente de ser o plano Lite ou Pro).
É possível usar modelos que não estão emthe list of supported models?
O Coding Plan suporta apenas modelos listados em list of supported models. O uso de qualquer outro modelo resulta em erro.
Velocidade de resposta dos planos Lite e Pro
Os planos Lite e Pro oferecem a mesma velocidade de resposta porque usam os mesmos recursos de modelo e service de inferência.
Renovação e upgrade do plano Lite
A partir de 13 de abril de 2026, o plano Lite não estará mais disponível para renovação e não poderá ser atualizado para o plano Pro. Para obter detalhes, consulte o aviso.
- Se você tiver um plano Lite, poderá usá-lo até que expire.
- Se você ativou a renovação automática para seu plano Lite, o sistema a desativará automaticamente 30 dias após a data do aviso. Você pode continuar a usar o plano até o término do período de service atual.
Agradecemos sua compreensão e apoio ao Alibaba Cloud Model Studio.
Downgrade para o plano Lite
Não, o downgrade não é suportado.
Limite de concorrência
Sim, o Coding Plan tem um limite de concorrência. A plataforma ajusta dinamicamente esse limite com base na carga geral de recursos para evitar sobrecarga durante horários de pico e garantir uma velocidade de resposta estável e qualidade de inferência para cada agente. Se você atingir o limite de concorrência, aguarde alguns instantes e tente novamente.
Suporte a múltiplos usuários
A chave de API do Coding Plan é apenas para uso pessoal e não deve ser compartilhada. Se o sistema detectar que sua chave de API foi exposta publicamente, ela poderá ser desativada automaticamente.
Compartilhamento de um plano Pro
Não. Mantenha sua chave de API segura. Não a compartilhe com outras pessoas ou a exponha em código do lado do cliente. Se o sistema detectar que sua chave de API foi exposta publicamente, ela poderá ser desativada automaticamente.
Janelas de contexto de modelo e tratamento de estouro
Nome do modelo | Janela de contexto (tokens) |
|---|---|
qwen3,7-plus | 1.000.000 |
qwen3,6-plus | 1.000.000 |
qwen3,5-plus | 1.000.000 |
kimi-k2,5 | 262.144 |
glm-5 | 202.752 |
MiniMax-M2,5 | 196.608 |
qwen3-max-2026-01-23 | 262.144 |
qwen3-coder-next | 262.144 |
qwen3-coder-plus | 1.000.000 |
glm-4,7 | 202.752 |
Se você encontrar um erro por exceder a janela de contexto, recomendamos iniciar uma nova sessão. Você também pode usar os seguintes métodos para evitar esse problema:
- Trocar modelos: Mude para um modelo que suporte uma janela de contexto maior, como qwen3,7-plus, qwen3,6-plus, qwen3,5-plus ou qwen3-coder-plus.
- Reduzir arquivos irrelevantes: Recomendamos iniciar sua ferramenta de codificação de IA no diretório específico do projeto e manter apenas os arquivos necessários do projeto.
- Dividir tarefas: Divida tarefas complexas em subtarefas menores e pergunte sobre elas individualmente para reduzir o contexto usado em uma única solicitação.
- Fornecer instruções precisas: Solicitações vagas podem acionar varreduras desnecessárias de arquivos. Use perguntas ou instruções claras e específicas ao usar uma ferramenta de codificação de IA.
As operações específicas variam conforme a ferramenta. Para obter detalhes, consulte Connect to Clients/Development Tools.
Redefinição da chave de API
Na página do Coding Plan, clique em no botão Reset ao lado da sua chave de API do Coding Plan.
ObservaçãoApós redefinir sua chave de API, você deve atualizá-la em todas as ferramentas onde ela é usada. Caso contrário, essas ferramentas pararão de funcionar.
Se um Coding Plan expirar e não for renovado, a Chave de API é redefinida após a reativação?
Sim, ela será redefinida. Se você renovar antes da data de expiração, sua chave de API não será redefinida.
Lembretes de expiração
Sim. O sistema envia lembretes de renovação 7, 3 e 1 dia antes da expiração da sua assinatura por meio de mensagens internas, e-mails, SMS e chamadas de voz automatizadas.
Configuração de notificações de expiração
Isso não é suportado. O sistema envia automaticamente lembretes de expiração 7, 3 e 1 dia antes da expiração da sua assinatura por meio de mensagens internas, e-mails, SMS e chamadas de voz automatizadas. A inscrição manual não é necessária.
Múltiplas chaves de API
Não. Atualmente, apenas uma chave de API é suportada por assinatura do Coding Plan.
Suporte a lista de permissões de IP
Não. Se sua chave de API for comprometida, redefina-a na página do Coding Plan.
Acesso de usuário RAM à chave de API
Entre em contato com o proprietário da conta Alibaba Cloud ou um usuário RAM com permissões administrativas para adicionar a permissão Subscription Plans à sua conta.
Uso com VSCode
Use uma extensão do VS Code que suporte APIs compatíveis com OpenAI ou Anthropic, como Qwen Code ou Claude Code.
Quantização de modelo
Os modelos no Coding Plan, como glm-5 e qwen3,5-plus, são versões completas que não foram submetidas a quantização ou redução de recursos.
Coding Plan vs. Savings Plan de Uso Geral de IA
Recurso | ||
|---|---|---|
Caso de uso | Para ferramentas de codificação de IA (como Claude Code, OpenClaw, etc.) | Para compensar taxas de pagamento conforme o uso para chamadas de API gerais do Model Studio |
Formato da chave de API |
|
|
Domínio da URL Base | coding -intl.dashscope.aliyuncs.com | dashscope -intl.aliyuncs.com |
Método de faturamento | Assinatura mensal | Faturado com base no uso de tokens |
Cenários aplicáveis | Programação interativa de IA | Chamadas de API e desenvolvimento de aplicativos |
Resolução do erro data_inspection_failed
Consulte a documentação Error Codes.
Uso com Dify
O uso do Coding Plan no Dify não é recomendado. O Coding Plan destina-se apenas a ferramentas de codificação de IA, como Claude Code e Qwen Code. Não use a chave de API do plano para scripts automatizados, backends de aplicativos personalizados ou quaisquer cenários de chamada em lote não interativos. Tal uso viola os termos de service e pode resultar na suspensão da sua assinatura ou na desativação da sua chave de API.
Uso do Coding Plan no Postman
Isso não é recomendado. O Coding Plan destina-se apenas a ferramentas de codificação de IA, como Claude Code e Qwen Code. Não use a chave de API do plano para scripts automatizados, backends de aplicativos personalizados ou quaisquer cenários de chamada em lote não interativos. Tal uso viola os termos de service e pode resultar na suspensão da sua assinatura ou na desativação da sua chave de API.