Configurações de privacidade

Aviso de privacidade e LGPD

A Nfero usa armazenamento essencial para preferências de idioma e controles de acesso às demonstrações. Com seu consentimento, o Google Analytics e eventos leves de uso ajudam a melhorar as demonstrações de modelos e os caminhos de assinatura externos. Prompts de demonstrações ao vivo podem ser enviados a endpoints de modelos configurados e hospedados pela Alibaba.

Atribuição de ferramenta + modelo

Cline com Plano de Codificação e Plano de Créditos da Alibaba (Token Plan)

Extensão do VS Code para geração de código, depuração, edições de arquivos, ações de terminal e fluxos de trabalho de desenvolvedor agêntes.

O Cline oferece uma configuração direta compatível com OpenAI dentro do VS Code. É uma solução prática para desenvolvedores que desejam usar modelos hospedados pela Alibaba sem precisar migrar seu trabalho de repositório para fora do editor atual.

Escolha a rota de acesso adequada

Escolha a rota de acesso adequada

Cline é uma das integrações baseadas em interface gráfica mais simples. Os principais riscos são misturar credenciais de planos diferentes e esquecer a opção específica de formato de mensagem por modelo no Cline, necessária para modelos de raciocínio.

RecomendadoCoding Plan para um único usuário do VS Code; Token Plan para acesso em equipe baseado em Credits

Token Plan (Edição para Equipes)

Ideal para desenvolvedores atribuídos ou equipes que usam o Cline regularmente e desejam acesso baseado em Credits ao pool atual de modelos Token Plan.

Coding Plan

Ideal para um indivíduo que usa o Cline interativamente com uma cota mensal fixa de chamadas ao modelo.

Model Studio Pay-as-you-go API

Indicado para automação orientada por extensão que não corresponde a uma sessão interativa de codificação de um usuário atribuído, bem como para chamadas de aplicativo ou backend.

Padrão seguro de configuração

Use o provedor Compatível com OpenAI do Cline

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

  1. Instale o VS Code e a extensão atual do Cline.
  2. Obtenha a chave dedicada API para a assinatura da Alibaba que você selecionou.
  3. Escolha uma ID de modelo exata da lista de permissões (allowlist) atual desse plano.
  4. Armazene a chave exclusivamente no campo de credenciais do Cline; não a insira nas configurações do workspace nem no controle de versão.

Padrão seguro de configuração

Protocolo
OpenAI-compatible
  1. Abra o Cline, escolha 'Usar minha própria chave API' e selecione 'Compatível com OpenAI'.
  2. Insira o endpoint Token Plan indicado abaixo ou o endpoint Coding Plan `https://coding-intl.dashscope.aliyuncs.com/v1`.
  3. Insira a chave dedicada correspondente e uma ID de modelo suportada exata.
  4. Para um modelo de raciocínio ou um erro 400 relacionado, abra CONFIGURAÇÃO DE MODELO e ative a opção de formato de mensagens R1, conforme descrito pela Alibaba.
text
API Provider: OpenAI Compatible
Base URL: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
API key: YOUR_TOKEN_PLAN_API_KEY
Model ID: qwen3.7-plus

Verifique a conexão

  • Abra um pequeno workspace de teste e peça ao Cline para explicar um arquivo sem editá-lo.
  • Confirme se o provedor ainda mostra 'OpenAI Compatible' após reiniciar o VS Code.
  • Verifique a ID do modelo selecionado caractere por caractere.
  • Revise o uso do plano após a primeira tarefa para confirmar que a assinatura pretendida foi utilizada.

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.

Geração de textoRaciocínioCompreensão visual
Melhor ângulo de emparelhamento

Padrão atual robusto para codificação, raciocínio e assistência em repositórios.

Geração de textoRaciocínio
Melhor ângulo de emparelhamento

Alternativa com contexto estendido para workspaces maiores e tarefas envolvendo múltiplos arquivos.

Geração de textoRaciocínioCompreensão visual
Melhor ângulo de emparelhamento

Opção eficiente Token Plan para explicações rápidas e edições menores.

Problemas comuns

Problemas comuns

O que você vê

401 Chave API incorreta fornecida

Causa provável

A chave não corresponde à URL base ou uma chave pay-as-you-go foi inserida em um endpoint de plano.

O que fazer

Escolha uma rota de acesso e substitua ambos os valores simultaneamente. Para pay-as-you-go, certifique-se também de que a região da chave corresponda à do endpoint.

O que você vê

400 InternalError.Algo.InvalidParameter

Causa provável

O modelo de raciocínio selecionado exige o formato alternativo de mensagens no Cline.

O que fazer

Abra CONFIGURAÇÃO DE MODELO e ative o formato de mensagens R1, conforme descrito no guia oficial do Cline da Alibaba.

O que você vê

Modelo não encontrado ou não suportado

Causa provável

A ID do modelo está escrita incorretamente ou não consta na lista de permissões (allowlist) de strings exatas do plano selecionado.

O que fazer

Copie a ID do modelo diretamente da página oficial atual do plano — evite inferir versões ou apelidos.

O que você vê

Tarefa longa consome mais chamadas do que o esperado

Causa provável

Edições agênticas podem envolver leituras repetidas de arquivos, chamadas de ferramentas e múltiplas interações com o modelo.

O que fazer

Comece com uma pasta restrita, defina uma tarefa precisa, revise o consumo do plano e divida alterações extensas em sessões menores.

Restrições importantes

  • Use a chave dedicada API e a URL base provenientes do mesmo plano de faturamento da Alibaba. As credenciais do Coding Plan, do Token Plan e do Model Studio geral não são intercambiáveis.
  • As chaves de plano são destinadas ao usuário atribuído em uma ferramenta interativa de codificação ou agente. Não as compartilhe, não as envie para um repositório nem as exponha em capturas de tela.
  • Não utilize uma chave Coding Plan ou Token Plan em scripts automatizados, trabalhos em lote, back-ends de aplicações, serviços públicos ou outros tipos de cargas de trabalho API não interativas. Para essas cargas de trabalho, use o acesso API do Model Studio pay-as-you-go.
  • A disponibilidade de modelos é controlada por uma lista de permissões com correspondência exata de cadeia de caracteres e pode ser alterada. Confirme a identificação do modelo na documentação atual do plano Alibaba antes de editar uma configuração funcional.