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] |
O comprimento da entrada excede o intervalo permitido. |
|
|
401 invalid access token or token expired |
|
|
|
model 'xxx' is not supported |
|
O nome do modelo deve ser um ID de modelo suportado pelo Coding Plan. O nome diferencia maiúsculas de minúsculas e não deve conter espaços no início nem no final. |
|
403 invalid api-key |
A URL base de uso geral do Model Studio foi usada por engano. |
Endpoint compatível com Anthropic: Endpoint compatível com OpenAI: |
|
404 status code (no body) |
O caminho da URL base está incorreto. Por exemplo, no Claude Code, a URL base pode estar definida incorretamente como |
Endpoint compatível com Anthropic: Endpoint compatível com OpenAI: |
|
Connection error |
A URL base contém erro de digitação ou há um problema de rede. |
Verifique a ortografia do nome de domínio da URL base e sua conectividade de rede. |
|
Connection closed mid-response (geralmente acompanhado por |
A conexão foi interrompida durante a resposta em streaming, o que impede o retorno da resposta completa. Esse erro costuma ocorrer devido a flutuações de rede ou a um proxy local instável (VPN/HTTP Proxy) que quebra a conexão persistente com |
|
|
hour allocated quota exceeded |
A cota de solicitações para o período de 5 horas foi consumida. |
Aguarde 5 horas para que a cota seja restaurada automaticamente. |
|
week allocated quota exceeded |
A cota semanal de solicitações foi consumida. |
Aguarde até segunda-feira às 00:00:00 (UTC+8) para que a cota seja redefinida. |
|
month allocated quota exceeded |
A cota mensal de solicitações foi consumida. |
Aguarde até o dia correspondente do mês da assinatura às 00:00:00 (UTC+8) para que a cota seja redefinida. |
|
concurrency allocated quota exceeded |
O número atual de solicitações simultâneas excede o limite dinamicamente alocado pela plataforma. |
Aguarde um momento e tente novamente. A plataforma ajusta dinamicamente o limite de simultaneidade com base na carga geral de recursos. Esse limite pode ser acionado durante os horários de pico. |
O que fazer quando o Claude Code exibe a mensagem Claude Code has switched from npm 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 versão de instalação nativa oficial. Em seguida, siga os comandos retornados no terminal para concluir a migração da configuração.
O que fazer quando o Claude Code reporta o erro Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST?
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: quando o Claude Code é iniciado pela primeira vez, ele tenta se conectar a api.anthropic.com para inicialização e autenticação. No entanto, o Claude Code não está disponível em alguns países e regiões, o que causa a falha na conexão.
Solução:
-
Adicione
"hasCompletedOnboarding": truecomo um campo de nível superior em~/.claude.json.Recomendamos que você use o Qwen Code para adicionar isso automaticamente. Após iniciar o Qwen Code executando
qwenno terminal, envie a seguinte mensagem na caixa de diálogo:Please add "hasCompletedOnboarding": true as a top-level field to the ~/.claude.json file without overwriting existing content.{ "hasCompletedOnboarding": true } -
Salve o arquivo e reinicie o Claude Code.
claude
O que fazer quando o OpenCode reporta o erro Request Entity Too Large?
Esse erro indica que o conteúdo da solicitação, como o contexto de código ou o histórico da conversa, é muito grande e excede o limite máximo de entrada. Para resolver esse problema, siga as etapas abaixo:
-
Execute
/newpara iniciar uma nova conversa ou execute/compactpara compactar o contexto. -
Se os métodos acima não funcionarem, atualize o OpenCode para a versão 1.2.16 ou posterior, que inclui uma correção para esse problema.
O que fazer quando o OpenCode reporta o erro The thinking_budget parameter must be a positive integer and not greater than 38912?
Causa: o valor de budgetTokens no arquivo de configuração opencode.json excede o valor máximo de thinking_budget suportado pelo modelo atual. Esses limites variam de acordo com o modelo. Ajuste sua configuração conforme a tabela a seguir.
|
Nome do modelo |
Comprimento máximo da cadeia 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 |
Habilitado por padrão. Não é necessário configurar budgetTokens. |
|
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 o modelo correspondente, de modo que não exceda seu limite. 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 mais informações, consulte OpenCode.
O que fazer quando o OpenCode reporta o erro InternalError.Algo.InvalidParameter: Range of max_tokens should be [1, xxxx]?
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. Para mais informações, consulte OpenCode.
Os modelos do Coding Plan suportam o modo de pensamento?
A maioria dos modelos do Coding Plan que suportam pensamento profundo possui o modo de pensamento habilitado por padrão. Para habilitá-lo nas ferramentas mais comuns, siga estas etapas:
O modelo utilizado deve suportar o modo de pensamento.
Claude Code
Habilitar o modo de pensamento: digite /config, navegue até Thinking mode e pressione Enter para alterar para true.
Visualizar o processo de pensamento: use o atalho de teclado Ctrl + O para visualizar o processo de pensamento.
● 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 complete tasks by calling tools, rather than just having a conversation.
∴ Thinking…
The user asked, "Think and then tell me: who are you?". I need to think before answering.
According to 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 (rather than just conversing)
3. Maintain a concise, professional tone
4. Do not use emojis proactively
5. Technical accuracy is prioritized over emotional validation
I need to think before answering, so I should provide a concise but accurate self-introduction.
OpenCode
Para mais informações, consulte OpenCode e defina o parâmetro options como:
{
"thinking": {
"type": "enabled",
"budgetTokens": 1024
}
}
`budgetTokens` é o número máximo de tokens de pensamento. Você pode ajustá-lo conforme necessário.
Qwen Code
Abra ~/.qwen/settings.json e defina o parâmetro enable_thinking como true na propriedade modelProviders para habilitar 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 habilitar o modo de pensamento no OpenClaw, siga estas etapas:
-
Verifique a versão do OpenClaw
Execute
openclaw tuino terminal para acessar a interface TUI. Na caixa de diálogo, digiteopenclaw --versionpara verificar a versão. Certifique-se de que a versão do seu OpenClaw sejav2026.03.02ou posterior. Versões mais antigas podem não suportar o modo de pensamento.openclaw --version OpenClaw 2026.3.8 (commit: 3caab92) -
Selecione o nível de pensamento
Na interface TUI do OpenClaw, digite o comando
/think highpara selecionar um nível de pensamento. Este exemplo define o nível de pensamento da sessão atual comohigh./think high → high -
Modifique o arquivo de configuração
-
Defina o parâmetro
compatAbra o arquivo de configuração conforme descrito em OpenClaw. Na configuração de um modelo que suporte o modo de pensamento, adicione o parâmetro
compat:"compat": { "thinkingFormat": "qwen" } -
Defina o parâmetro
reasoningNa mesma configuração do 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 }
-
-
Reinicie o OpenClaw Gateway
Após salvar o arquivo de configuração, execute o seguinte comando no terminal para reiniciar o OpenClaw Gateway e aplicar as alterações.
openclaw gateway restart
Por que registros de chamadas para modelos não configurados aparecem no OpenClaw?
Causa: O parâmetro agents.defaults.models não está configurado no openclaw.json 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 modelos configurados. Para mais informações, consulte OpenClaw.
O que fazer se o OpenClaw mostrar que está conectado, mas o chat não responder ou continuar carregando?
Este problema pode ser causado pelo seguinte:
-
Um proxy local (VPN/HTTP Proxy) está bloqueando ou falhando ao 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. Isso faz com que as solicitações sejam enviadas para um endpoint que não responde.
Solução:
-
Tente desativar seu proxy local ou certifique-se de que o proxy consiga 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 é recriado automaticamente com base na configuração em~/.openclaw/openclaw.json.
O que fazer quando o OpenClaw reportar o erro Agent failed before reply: OAuth token refresh failed?
Este erro indica que você está conectado a um serviço OAuth de terceiros, não ao Coding Plan.
Solução:
-
Configure o Coding Plan no OpenClaw. Para mais informações, consulte OpenClaw.
-
Limpe as credenciais OAuth antigas e o cache de modelos e, em seguida, reinicie o OpenClaw.
Antes de excluir as credenciais OAuth antigas, faça backup dos arquivos relevantes para que você possa reverter se necessário.
rm ~/.openclaw/agents/main/agent/auth.json rm ~/.openclaw/agents/main/agent/models.json openclaw gateway restart
O que fazer quando o OpenClaw reportar o erro Agent failed before reply: Unknown model?
Este erro indica que o OpenClaw não consegue encontrar o modelo especificado no arquivo de configuração. Verifique os seguintes itens na ordem:
-
Configuração incorreta da chave
models.providersou do prefixo do modeloQuando você usa um Coding Plan, a chave em
models.providersdeve incluir a chavebailian. Esta chave 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" } } } } -
Conflito de rota causado por configurações antigas de provedores restantes
Se você usou anteriormente outros provedores como qwen-portal, as configurações de provedores restantes podem causar conflitos de roteamento de modelos. Remova provedores irrelevantes e certifique-se de que o modelo para o qual o campo
primaryaponta está corretamente definido na listamodels.providers.bailian.models. Para informações de configuração, consulte OpenClaw.
O que é o qwen-portal/coder-model?
qwen-portal/coder-model é um modelo gratuito fornecido pela versão web do Qwen Chat e não pertence à plataforma Model Studio. Se você tentar usar este modelo no Model Studio ou no Coding Plan, encontrará um erro indicando que o modelo não existe. Você deve usar um modelo suportado pela plataforma Model Studio.
O que fazer quando o OpenClaw reportar o erro No API key found for provider "xxxxx"?
Este erro indica que o OpenClaw não consegue encontrar a chave de API para o provedor (xxxx) especificado na mensagem de erro. Verifique os seguintes itens na ordem:
-
A configuração do provedor correspondente está ausente em
models.providersAbra o arquivo de configuração
~/.openclaw/openclaw.jsone confirme que existe uma chave que corresponda ao nome do provedor do erro emmodels.providers.-
Se você usa o Coding Plan, a configuração deve incluir a chave
bailian, que pode coexistir com outros provedores. -
Se não existir, adicione a configuração do provedor correspondente.
-
-
Configuração incorreta da chave de API para o provedor
-
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ê usa o Coding Plan, certifique-se de estar usando a chave dedicada (
sk-sp-xxx). -
Se a Web UI exibir
__OPENCLAW_REDACTED__, a chave de API já está salva e não precisa ser inserida novamente. Se estiver vazia ou exibirYOUR_API_KEY, você deve inseri-la novamente.
-
-
O cache de credenciais local não está atualizado, o que impede que a configuração tenha efeito
Antes de excluir credenciais antigas, faça backup dos arquivos relevantes para que você possa reverter se ocorrer um erro.
# 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
O que fazer quando o OpenClaw reportar o erro API rate limit reached?
Verifique os seguintes itens na ordem:
-
Configuração incorreta do OpenClaw
Se a URL base ou o provedor do modelo estiverem configurados incorretamente, as solicitações podem ser roteadas para a API de uso geral em vez do canal dedicado do Coding Plan, o que aciona a limitação de taxa.
-
Se você usa um Coding Plan, verifique os campos
models,agentsegateway(incluindo campos aninhados) no arquivo de configuração do OpenClaw para garantir que correspondam à documentação. Por exemplo, a estrutura para o provedor de serviço de modelo deve ser{ "models": { "providers": { "bailian": {...} } } }. -
Se você não estiver usando atualmente um Coding Plan, mude para um para obter uma cota dedicada.
-
-
A cota do plano foi excedida. Verifique o uso do seu plano na página do Coding Plan.
-
Tente redefinir a chave de API: Se o problema persistir após executar as verificações anteriores, acesse a página do Coding Plan para redefinir sua chave de API.
O que fazer quando o OpenClaw reportar o erro Failed to discover Alibaba Cloud models na inicialização?
O OpenClaw reporta um dos seguintes erros na inicialização:
-
Failed to discover Alibaba Cloud models: TimeoutError: The operation was aborted due to timeout -
Failed to discover Alibaba Cloud models: 404 Not Found
Causa: O OpenClaw está tentando consultar a lista de modelos para o Coding Plan do Model Studio, mas a lista de modelos não suporta consultas por meio de uma API.
Solução:
-
Esta mensagem não afeta o uso normal do OpenClaw e pode ser ignorada.
-
Se o OpenClaw não estiver funcionando corretamente, verifique outras mensagens de erro.
-
Para ocultar este aviso, exclua o
alibaba-cloud:default profiledo arquivo~/.openclaw/agents/main/agent/auth-profiles.json. Por exemplo, se o conteúdo atual for"profiles": { "alibaba-cloud:default": { "type": "api_key", "provider": "alibaba-cloud", "key": "sk-sp-xxxxx" } }altere para
"profiles": {}, e o aviso não aparecerá mais.
O que fazer quando o OpenClaw reportar um erro auth.profiles.xxx?
Você encontra um erro semelhante ao seguinte ao usar o OpenClaw:
-
auth.profiles.qwen-portal:default.mode: Invalid input -
auth.profiles.qwen-portal:default: Unrecognized key: "apiKey"
Causa: Você modificou incorretamente o campo auth.profiles no arquivo openclaw.json, por exemplo, alterando mode para um valor inválido ou adicionando um campo apiKey. O campo auth armazena apenas metadados de autenticação, não chaves. Você não precisa configurar o Coding Plan em auth.profiles.
Solução
-
Corrija a configuração
auth.profilesremovendo quaisquer campos adicionados ou modificados incorretamente e perfis desnecessários. -
Confirme que a chave de API do Coding Plan está configurada em
models.providers.bailian.apiKey. Para mais informações, consulte OpenClaw.
Por que recebo o erro HTTP 401: Incorrect API key provided?
Possíveis causas:
-
Formato incorreto da chave de API: A chave de API está vazia, tem um formato incorreto, foi copiada de forma incompleta ou inclui espaços extras. Certifique-se de que a chave de API é a chave de API dedicada do Coding Plan (começa com
sk-sp-), foi copiada completamente e não tem espaços. -
A assinatura do Coding Plan expirou ou é inválida: A chave de API dedicada do Coding Plan depende do status da assinatura do plano. Se o Coding Plan expirou ou é inválido, a chave dedicada não pode mais ser usada. Certifique-se de que sua assinatura do Coding Plan ainda está ativa.
-
URL base incorreta foi usada: Você configurou a chave de API dedicada do Coding Plan (começa com
sk-sp-), mas a URL base ainda é o endereço de uso geral do Alibaba Cloud Model Studio, como https://dashscope-intl.aliyuncs.com/compatible-mode/v1. Com base na ferramenta de IA à qual você está se conectando, substitua a URL base pelo endereço dedicado do Coding Plan da 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 foi usada: Você configurou a URL base dedicada do Coding Plan, mas inseriu por engano a chave de API de uso geral do Alibaba Cloud Model Studio (começa com
sk-). Atualize a chave de API para a chave de API dedicada do Coding Plan. -
Configuração incorreta devido ao cache de configuração histórica do OpenClaw: Exclua o item de configuração
providers.bailiando arquivo~/.openclaw/agents/main/agent/models.jsone reinicie o OpenClaw.
Por que recebo o erro Authentication failed, please make sure that a valid ModelScope token is supplied?
Este erro indica que você está conectado ao serviço de terceiros ModelScope, não ao Coding Plan. Para se conectar ao Coding Plan, consulte Conectar a clientes e ferramentas de desenvolvimento.
A mensagem de erro indica que a verificação de identidade falhou. Isso geralmente acontece quando você chama o serviço de API do ModelScope com uma credencial de acesso incorreta. Verifique os seguintes itens na ordem:
-
Você usou a credencial de acesso da plataforma errada. O formato para um token do ModelScope é
ms-xxx, enquanto o formato para uma chave de API de uso geral do Alibaba Cloud Model Studio ésk-xxx. São plataformas separadas e suas credenciais de acesso não são intercambiáveis. Obtenha seu token em ModelScope. -
Formato incorreto: Certifique-se de que nenhum espaço extra ou quebra de linha esteja incluído ao copiar o token do ModelScope.
Por que recebo o erro Coding Plan is currently only available for Coding Agents?
Este erro indica que a chamada foi iniciada a partir de uma ferramenta ou ambiente que não é suportado pelo Coding Plan.
O Coding Plan pode ser usado apenas em ferramentas de programação como Claude Code e Qwen Code. Não é suportado para uso em ferramentas como curl, Postman ou Dify.
Problemas de cobrança e cota
Por que ainda estou sendo cobrado por chamadas de API de modelo (ou tenho pagamentos em atraso) após assinar o Coding Plan?
Se você ainda está sendo cobrado ou tem pagamentos em atraso após assinar o Coding Plan, os motivos podem ser os seguintes:
-
Configuração incorreta da chave de API dedicada e da URL base (motivo mais comum)
-
Causa: se você configurar sua ferramenta de IA com uma chave de API de uso geral (formato:
sk-xxx) e uma URL base de uso geral (que não contém a palavra-chave `coding`), o sistema identifica as chamadas como pay-as-you-go e gera uma fatura. -
Solução: certifique-se de usar a configuração dedicada do Coding Plan. A chave de API deve estar no formato
sk-sp-xxxe a URL base deve conter a palavra-chavecoding, comohttps://coding-intl.dashscope.aliyuncs.com/xxx. Para mais informações, consulte Obter a chave de API dedicada e a URL base do seu plano.
-
-
Atrasos na liquidação de cobrança causando pagamentos em atraso (cobranças incorridas antes de assinar o Coding Plan)
-
Causa: as faturas são agregadas por minuto, e existe um atraso de nível de minuto na cobrança. Por exemplo, uma chamada de API feita às 16:00 pode não ser cobrada até às 16:05, após você ter assinado o Coding Plan.
-
Solução: o horário real de cobrança tem precedência. Para mais informações, consulte Consulta de faturas e gerenciamento de custos.
-
-
Tanto o Coding Plan quanto as credenciais de API de uso geral estão configurados, mas a API de uso geral foi usada por engano
-
Causa: se tanto as configurações de uso geral quanto as dedicadas estiverem salvas na ferramenta, algumas ferramentas, como o OpenClaw, podem rotear automaticamente as solicitações para as credenciais de uso geral, o que resulta em cobranças.
-
Solução: remova a configuração de API de uso geral da ferramenta e certifique-se de selecionar um modelo suportado pelo 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: após configurar novas credenciais, algumas ferramentas podem ainda estar lendo as credenciais de API de uso geral antigas e em cache.
-
Solução: limpe o cache e reinicie. Por exemplo, com o OpenClaw, exclua o arquivo
~/.openclaw/agents/main/agent/models.json, executeopenclaw gateway restartpara reiniciar o serviço e, em seguida, reconfigure-o conforme descrito em OpenClaw.
-
O que devo fazer se minha cota acabar?
-
Plano Lite: se sua cota de 5 horas ou semanal acabar, aguarde a restauração automática. Se sua cota mensal acabar, você precisará aguardar até o próximo mês de assinatura para que seja restaurada.
-
Plano Pro: se sua cota de 5 horas ou semanal acabar, aguarde a restauração automática. Se sua cota mensal acabar, você precisará aguardar até o próximo mês de assinatura para que seja restaurada.
O Coding Plan muda para a cobrança pay-as-you-go após a cota ser consumida?
Após a cota do seu Coding Plan ser consumida, as chamadas subsequentes falham com um erro. O sistema não muda automaticamente para o método de cobrança pay-as-you-go. Para continuar usando o serviço, aguarde a renovação da sua cota no próximo ciclo de assinatura.
Posso usar a avaliação gratuita do Model Studio com o Coding Plan?
O Coding Plan é um produto de assinatura independente. Seu sistema de cobrança e cotas não faz parte do programa de avaliação gratuita de modelos de uso geral do Model Studio.
Por que meu Coding Plan comprado em fevereiro tem validade de apenas 28 dias em vez de 31?
O plano entra em vigor no momento da compra e é válido até as 23:59:59 (UTC+8) do dia correspondente do mês seguinte. Se o mês seguinte não tiver um dia correspondente, o plano é válido até as 23:59:59 (UTC+8) do último dia daquele mês.
Por exemplo, se você comprar um Coding Plan em 3 de fevereiro de 2026, ele será válido até 3 de março de 2026, o que corresponde a um período de 28 dias.
Como posso visualizar as informações de consumo de tokens?
Este recurso não está disponível no momento. 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.
Posso consultar o uso de um modelo específico, como o qwen3.6-plus, dentro do meu Coding Plan?
Não. A página do Coding Plan mostra apenas o consumo geral e o saldo restante da cota total do plano.
O Coding Plan oferece assinatura anual?
Atualmente, o Coding Plan suporta apenas assinaturas mensais. Planos anuais não estão disponíveis.
Por que a renovação automática falhou?
Os motivos comuns são os seguintes:
-
A configuração não entrou em vigor: a renovação automática entra em vigor no dia seguinte à sua ativação, não imediatamente.
-
Saldo insuficiente na conta: os pagamentos de renovação automática são deduzidos do método de pagamento disponível vinculado à sua conta. Certifique-se de que o método de pagamento é válido e tem saldo suficiente.
Posso renovar meu plano após o vencimento?
A renovação não é suportada após o vencimento do plano.
O que fazer quando recebo o erro "A pending renewal already exists. Duplicate renewals are not allowed" ao renovar?
Causa: sua conta já foi renovada para o próximo mês. A renovação manual para meses adicionais não é suportada.
Se eu renovar meu Coding Plan antecipadamente, como o novo período de serviço é calculado?
Quando você compra um novo plano de um mês, a duração do pedido é calculada pelo mês civil. O plano entra em vigor no momento da compra e é válido até as 23:59:59 (UTC+8) do dia correspondente do mês seguinte. Se o mês seguinte não tiver um dia correspondente, o plano é válido até as 23:59:59 (UTC+8) do último dia daquele mês. Quando você renova antecipadamente, o novo período é automaticamente estendido a partir da data de vencimento original.
Por exemplo:
-
Você compra o plano pela primeira vez às 10:00 do dia 15 de março. Ele é válido até as 23:59:59 do dia 15 de abril.
-
Você renova por mais um mês no dia 10 de abril. A nova data de vencimento é 23:59:59 do dia 15 de maio.
Posso usar um cupom de desconto para renovar?
Você pode usar um cupom de desconto de uso geral.
Onde posso encontrar a entrada para renovação?
Você pode renovar o plano Pro na página do Coding Plan ou na página de Renovação de Recursos. Para o aviso sobre a descontinuação das renovações do plano Lite, consulte o anúncio.
Problemas de recursos do produto
Quais modelos o Coding Plan suporta?
Tanto o plano Lite quanto o Pro suportam todos os modelos incluídos no plano, como Qwen, GLM, Kimi e MiniMax. Para a lista completa de modelos, consulte Visão geral do Coding Plan.
A lista de modelos suportados pelo Coding Plan será atualizada?
A lista de modelos suportados pelo Coding Plan é atualizada periodicamente. Para os modelos atualmente suportados, consulte a página de Visão geral do Coding Plan. Volte a consultar para obter atualizações.
Quantos Coding Plans podem estar ativos para cada conta do Model Studio ao mesmo tempo?
Cada conta do Model Studio pode ter apenas uma assinatura ativa do Coding Plan por vez, independentemente de ser um plano Lite ou Pro.
Posso usar modelos diferentes dos que estão na lista de modelos suportados?
Atualmente, o Coding Plan suporta apenas os modelos na lista de modelos suportados. O uso de outros modelos resulta em erro.
A velocidade de resposta do modelo é a mesma para os planos Lite e Pro?
A velocidade de resposta do modelo é a mesma para os planos Lite e Pro. Ambos os planos usam os mesmos recursos de modelo e serviços de inferência.
O plano Lite pode ser renovado e atualizado?
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 mais informações, consulte o anúncio.
-
Se você já comprou o Coding Plan Lite, pode continuar usando até o vencimento do serviço.
-
Se você ativou a renovação automática para o Coding Plan Lite, ela se torna automaticamente inválida 30 dias após o anúncio. Você pode continuar usando o serviço até o vencimento.
Agradecemos sua compreensão e apoio ao Alibaba Cloud Model Studio.
O plano Pro pode ser rebaixado para o plano Lite?
O rebaixamento não é suportado.
O Coding Plan tem limite de simultaneidade?
O Coding Plan tem um limite de simultaneidade. A plataforma ajusta dinamicamente o limite de simultaneidade com base na carga geral de recursos para evitar sobrecarga de recursos durante os horários de pico e garantir que cada agente receba uma velocidade de resposta estável e qualidade de inferência. Se você acionar o limite de simultaneidade, aguarde um momento e tente novamente.
O Coding Plan suporta vários usuários?
A chave de API do Coding Plan é apenas para uso pessoal e não suporta compartilhamento com vários usuários. Não a compartilhe com outras pessoas. Se o sistema detectar que sua chave de API foi exposta publicamente, ela poderá ser desativada automaticamente.
O plano Pro suporta o uso por vários desenvolvedores em uma empresa?
Não. Mantenha as informações da sua chave seguras. Não as compartilhe com outras pessoas ou as 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.
Quais são os comprimentos de contexto dos modelos? Como lidar com o excesso de comprimento de contexto?
|
Nome do modelo |
Comprimento 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 |
Quando você encontrar um erro relacionado ao excesso do limite de contexto, inicie uma nova sessão. Você também pode evitar o excesso do comprimento de contexto das seguintes formas:
-
Trocar de modelo: mude para um modelo que suporte um contexto mais longo, como qwen3.7-plus, qwen3.6-plus, qwen3.5-plus ou qwen3-coder-plus.
-
Remover arquivos irrelevantes: inicie sua ferramenta de programação de IA no diretório específico do projeto e mantenha apenas os arquivos necessários do projeto.
-
Dividir tarefas: divida tarefas complexas em subtarefas menores e pergunte sobre elas uma de cada vez para reduzir o uso de contexto de uma única solicitação.
-
Usar instruções precisas: solicitações vagas podem acionar varreduras desnecessárias de arquivos. Ao usar ferramentas de programação de IA, faça perguntas mais específicas e claras ou forneça instruções precisas.
As operações específicas variam conforme a ferramenta. Para mais informações, consulte Conectar a clientes e ferramentas de desenvolvimento.
Como redefino a chave de API do Coding Plan?
Na página do Coding Plan, clique no botão Redefinir ao lado da chave de API do Coding Plan.
Após redefinir a chave, você deve atualizar a nova chave de API em todas as ferramentas que utiliza. Caso contrário, as ferramentas ficarão inutilizáveis.
Se meu Coding Plan vencer e eu não renová-lo, a chave de API será redefinida quando eu assinar novamente?
Ela será redefinida no vencimento, a menos que você renove antes da data de vencimento.
Receberei um lembrete antes do meu Coding Plan vencer?
Sim. O sistema envia lembretes de renovação por meio de mensagens internas, e-mails, mensagens de texto e chamadas automáticas 7, 3 e 1 dia antes da data de vencimento.
Posso assinar notificações de vencimento do Coding Plan?
Não. Você não precisa configurar isso separadamente. O sistema envia automaticamente lembretes de vencimento por meio de mensagens internas, e-mails, mensagens de texto e chamadas automáticas 7, 3 e 1 dia antes da data de vencimento. Você não precisa se inscrever manualmente.
Posso gerar várias chaves de API para o Coding Plan?
Atualmente, apenas uma chave de API é suportada.
O Coding Plan suporta a configuração de uma lista de permissões de endereços IP?
Não. Se sua chave de API vazar, redefina-a na página do Coding Plan.
Como um usuário RAM pode visualizar e obter a chave de API do Coding Plan?
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 Planos de Assinatura à sua conta.
Como uso o Coding Plan com o VSCode?
Você pode usar um plugin que suporte a conexão a APIs compatíveis com o protocolo OpenAI ou Anthropic, como o Qwen Code ou o Claude Code.
Os modelos do Coding Plan são quantizados?
Os modelos incluídos no Coding Plan, como glm-5 e qwen3.5-plus, são versões completas. Eles não passaram por quantização ou redução de recursos.
Qual é a diferença entre o Coding Plan e os planos de economia?
|
Item de comparação |
||
|
Finalidade |
Uso em ferramentas de programação de IA como Claude Code e OpenClaw |
Compensar taxas de pay-as-you-go para chamadas de API de uso geral do Alibaba Cloud Model Studio |
|
Formato da chave de API |
|
|
|
Domínio da URL base |
|
|
|
Método de cobrança |
Plano de assinatura mensal |
Cobrado com base no uso de tokens |
|
Cenários |
Programação interativa de IA |
Chamadas de API, desenvolvimento de aplicações |
Como lidar com um erro data_inspection_failed?
Para mais informações, consulte o documento de Códigos de erro.
Por que recebo um erro ao configurar o Dify com o Coding Plan?
Não recomendamos o uso do Coding Plan com o Dify. A cota do Coding Plan é destinada apenas ao uso em ferramentas de programação como Claude Code e Qwen Code. É proibido usá-la na forma de chamadas de API para scripts automatizados, backends de aplicações personalizadas ou quaisquer cenários de chamadas em lote não interativas. O uso da chave de API do plano para chamadas fora do escopo permitido é considerado uma violação ou abuso e pode levar à suspensão da sua assinatura ou ao bloqueio da sua chave de API.
O Coding Plan pode ser chamado a partir do Postman?
Isso não é recomendado. A cota do Coding Plan é destinada apenas ao uso em ferramentas de programação como Claude Code e Qwen Code. É proibido usá-la na forma de chamadas de API para scripts automatizados, backends de aplicações personalizadas ou quaisquer cenários de chamadas em lote não interativas. O uso da chave de API do plano para chamadas fora do escopo permitido é considerado uma violação ou abuso e pode levar à suspensão da sua assinatura ou ao bloqueio da sua chave de API.