Integrar o APIMart com o Cline no VSCode

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Introdução

​

Pré-requisitos

1. Visual Studio Code instalado
   Baixe e instale o VSCode no site oficial
2. Extensão Cline instalada
   Pesquise por “Cline” no marketplace de extensões do VSCode e instale-a
3. Chave de API do APIMart obtida
   Acesse o Console do APIMart para obter sua chave de API (começa com sk-)

​

Etapa 1: Instalar a extensão Cline

​

1.1 Abrir o marketplace de extensões

1. Clique no ícone de Extensões na barra de atividades à esquerda (ou pressione Ctrl+Shift+X / Cmd+Shift+X)
2. Digite Cline na caixa de pesquisa
3. Encontre a extensão Cline (do Cline)
4. Clique no botão Install

​

1.2 Verificar a instalação

1. O ícone Cline (cabeça de robô) aparecerá na barra de atividades à esquerda
2. Clique no ícone para abrir a barra lateral do Cline
3. Na primeira abertura, você verá a mensagem de boas-vindas “Hi, I’m Cline”
4. Duas opções são exibidas:
   • Get Started for Free - Use o teste gratuito oficial
   • Use your own API key - Use sua própria chave de API

​

Etapa 2: Configurar a API do APIMart

​

2.1 Escolher usar sua própria chave de API

1. Clique no botão Use your own API key
2. Isso abrirá a interface de configuração da API

​

2.2 Configurar o provedor de API

1. Expanda a seção API Configuration
2. Selecione OpenAI Compatible no menu suspenso API Provider
3. Isso exibirá opções de configuração compatíveis com OpenAI

​

2.3 Preencher a configuração da API

​

2.4 Salvar a configuração

1. Clique no botão Done no canto superior direito
2. A configuração é salva automaticamente
3. O Cline se conectará imediatamente ao APIMart usando a nova configuração
4. Retorne à interface principal do Cline, mostrando “What can I do for you?”

​

Etapa 3: Escolher o modelo certo

​

Modelos recomendados

• gpt-5 ⭐ Modelo mais recente, maior qualidade de geração de código
  • Adequado para: Algoritmos complexos, design de arquitetura, refatoração de código
  • Recursos: Forte compreensão, alta qualidade de código
• gpt-4o Modelo de alto desempenho
  • Adequado para: Desenvolvimento diário, revisão de código, correção de bugs
  • Recursos: Rápido, qualidade estável
• gpt-4o-mini 💰 Custo-benefício
  • Adequado para: Geração de código simples, redação de comentários, documentação
  • Recursos: Ótimo custo-benefício, resposta rápida

• claude-sonnet-4-5-20250929
  • Adequado para: Raciocínio lógico complexo, otimização de algoritmos
  • Recursos: Excelente raciocínio, ótimo para problemas complexos
• claude-haiku-4-5-20251001
  • Adequado para: Autocompletar código rápido, perguntas e respostas simples
  • Recursos: Extremamente rápido, baixo custo

​

Trocando modelos

1. Encontre o botão de modelo abaixo da caixa de entrada (mostra o modelo atual, por exemplo, openai-compatible:clau...)
2. Clique neste botão para trocar de modelos
3. Ou modifique o campo Model ID nas configurações
4. As alterações entram em vigor imediatamente, sem necessidade de reiniciar o VSCode

​

Etapa 4: Começar a usar o Cline

​

4.1 Conversa básica

1. A interface principal do Cline mostrará “What can I do for you?”
2. Digite sua solicitação na caixa de entrada na parte inferior (mostra “Type your task here…”)
3. Por exemplo: “Create a function to calculate the Fibonacci sequence”
4. Pressione Enter para enviar
5. A IA analisará sua solicitação, gerará código e poderá aplicá-lo diretamente ao seu projeto
6. O progresso de cada etapa é exibido na barra lateral

​

4.2 Geração de código

Please create a JavaScript function to validate email address format

Help me implement a user login form with email and password inputs using React Hooks

Write unit tests for the calculateTotal function using Jest

​

4.3 Explicação e melhoria de código

1. Selecione o código que deseja processar no editor
2. Clique com o botão direito para ver as opções do Cline:
   • Explain with Cline - Explica a funcionalidade e lógica do código
   • Improve with Cline - Otimiza e melhora o código
3. Selecione a ação correspondente
4. O Cline exibirá os resultados da análise e sugestões de melhoria na barra lateral

Refactor this code to improve readability and performance

​

4.4 Depuração de bugs

1. Envie mensagens de erro ou código problemático para o Cline
2. Por exemplo: “This code throws an error: TypeError: Cannot read property ‘name’ of undefined”
3. A IA analisará o problema e fornecerá soluções
4. Você pode aplicar a correção diretamente

​

4.5 Explicação de código

1. Selecione um trecho de código difícil de entender
2. Digite no Cline: “Explain what this code does”
3. A IA fornecerá uma explicação detalhada e como funciona

​

4.6 Geração de documentação

Add JSDoc comments to this function

Generate a README.md file for this project

​

Recursos avançados

​

Operações multi-arquivo

1. Criar múltiplos arquivos:
   Create a complete Express.js API with routes, controllers, and model files
   
2. Modificações em lote:
   Replace all var with const or let in the project
   
3. Refatoração de projeto:
   Migrate this project from JavaScript to TypeScript
   

​

Execução de comandos do terminal

1. Instalar dependências:
   Install axios and dotenv packages
   
2. Executar scripts:
   Run npm test
   
3. Operações Git:
   Create a Git commit with the message "feat: add user authentication"
   

1. O Cline exibirá “Cline wants to execute this command:” na barra lateral
2. Mostra o comando específico (por exemplo, gcc fibonacci.c -o fibonacci.exe)
3. Dois botões aparecem na parte inferior:
   • Run Command - Executar o comando
   • Reject - Recusar a execução
4. Após clicar em “Run Command”, o comando é executado no terminal integrado
5. Os resultados são exibidos tanto no terminal quanto na barra lateral do Cline

​

Gerenciamento de contexto

• Contexto do arquivo atual: Inclui automaticamente o arquivo que está sendo editado
• Contexto do código selecionado: Inclui automaticamente trechos de código que você selecionou
• Contexto da estrutura do projeto: Entende a estrutura do seu projeto
• Contexto de mensagens de erro: Captura automaticamente mensagens de erro do terminal

​

Prompts personalizados

1. Encontre Custom Instructions nas configurações do Cline
2. Adicione suas preferências, por exemplo:
   - Use TypeScript instead of JavaScript
   - Follow Airbnb code style
   - Use arrow function syntax
   - Prefer functional programming style
   
3. A IA seguirá essas instruções em todas as interações

​

FAQ

​

Q1: O Cline diz que a chave de API é inválida?

1. Verifique o formato da API Key:
   • Confirme que a API Key começa com sk-
   • Certifique-se de que foi copiada completamente, sem espaços extras
2. Verifique a Base URL:
   • Deve ser https://api.apimart.ai/v1
   • Observe o sufixo /v1
3. Verifique a validade da chave:
   • Verifique o status da chave no Console do APIMart
   • Confirme saldo suficiente na conta
4. Reconfigure:
   • Exclua a configuração existente
   • Insira novamente API Key e Base URL

​

Q2: O Cline responde lentamente?

1. Mude para um modelo mais rápido:
   • Use gpt-4o-mini ou claude-haiku-4-5-20251001
   • Esses modelos respondem mais rápido
2. Reduza o comprimento do contexto:
   • Evite enviar código muito longo de uma vez
   • Divida tarefas grandes em menores
3. Verifique a conexão de rede:
   • Garanta uma rede estável
   • Considere usar um servidor proxy
4. Otimize o conteúdo da requisição:
   • Faça perguntas mais específicas
   • Evite perguntas vagas ou muito amplas

​

Q3: O Cline gera código de baixa qualidade?

1. Use modelos de maior qualidade:
   • Mude para gpt-5 ou claude-sonnet-4-5-20250929
   • Esses modelos produzem código de maior qualidade
2. Forneça requisitos mais detalhados:
   • Declare claramente a implementação esperada
   • Forneça código de exemplo ou referências
   • Especifique stack tecnológico e versões de framework
3. Use instruções personalizadas:
   • Adicione padrões de código nas configurações
   • Especifique estilo de codificação e melhores práticas
4. Otimização iterativa:
   • Tenha várias rodadas de conversa com a IA
   • Melhore gradualmente a qualidade do código

​

Q4: Como gerenciar os custos de uso da API?

1. Escolha modelos apropriados:
   • Use gpt-4o-mini para desenvolvimento diário
   • Use gpt-5 para tarefas complexas
2. Otimize a abordagem das perguntas:
   • Seja o mais específico possível
   • Evite repetir as mesmas perguntas
3. Use seleção de código:
   • Selecione apenas a parte do código que precisa de processamento
   • Evite enviar contexto de arquivo inteiro
4. Monitore o uso:
   • Verifique regularmente o Console do APIMart
   • Entenda a frequência de chamadas de API e os custos

​

Q5: O Cline não consegue acessar certos arquivos?

1. Verifique as permissões de arquivo:
   • Certifique-se de que os arquivos têm permissões de leitura/gravação
   • Especialmente em sistemas Linux/macOS
2. Verifique o .gitignore:
   • O Cline ignora arquivos no .gitignore por padrão
   • Você pode ajustar esse comportamento nas configurações
3. Configurações da área de trabalho:
   • Certifique-se de que os arquivos estão dentro da área de trabalho do VSCode
   • Verifique as configurações de confiança da área de trabalho
4. Recarregue o VSCode:
   • Use Ctrl+Shift+P / Cmd+Shift+P
   • Execute o comando “Reload Window”

​

Dicas de uso

​

1. Aproveite o contexto ao máximo

I have an Express.js project using MongoDB database.
Please help me create a user authentication system including registration, login, and JWT token verification.
Project structure is:
- src/models/
- src/controllers/
- src/routes/
- src/middleware/

​

2. Desenvolvimento incremental

Step 1: Create the basic user model
Step 2: Add password encryption
Step 3: Implement registration and login endpoints
Step 4: Add JWT token verification

​

3. Assistente de revisão de código

Please review this code, checking for:
1. Potential security issues
2. Performance optimization opportunities
3. Code style issues
4. Possible bugs

​

4. Aprenda novas tecnologias

I want to learn React Hooks.
Please create a sample project demonstrating useState, useEffect, useContext usage,
and add detailed comments explaining how each Hook works.

​

5. Prototipagem rápida

Create a simple todo app with requirements:
- Use React and LocalStorage
- Can add, delete, mark as complete
- Simple CSS styling
- Complete in a single HTML file

​

6. Programação em par

I'm implementing a sorting algorithm,
I wrote the first half, please help me complete the rest:

function quickSort(arr) {
    if (arr.length <= 1) return arr;
    const pivot = arr[0];
    // Please continue implementation...
}

​

Destaques de recursos

• 💻 Geração inteligente de código - Gere código de alta qualidade a partir de descrições em linguagem natural
• 🔧 Refatoração de código - Otimize automaticamente a estrutura e o desempenho do código
• 🐛 Assistência na depuração de bugs - Localize e corrija rapidamente problemas de código
• 📝 Geração de documentação - Gere comentários, README, documentação de API
• 🧪 Escrita de casos de teste - Gere automaticamente testes unitários e de integração
• 🔄 Migração de código - Conversão de linguagem, migração de framework
• 💡 Explicação de código - Entenda lógica de código complexa
• 🎯 Sugestões de melhores práticas - Forneça padrões de código e conselhos de otimização
• 🚀 Prototipagem rápida - Valide ideias e conceitos rapidamente
• 🤖 Execução de comandos do terminal - Execute automaticamente comandos de desenvolvimento

​

Atalhos de teclado

​

Melhores práticas

​

1. Descrição clara da tarefa

Write a login feature

Create a user login feature with requirements:
- Use React and TypeScript
- Form validation (email format, password length)
- Use axios to call API
- Store JWT token to localStorage on successful login
- Error handling and user feedback

​

2. Forneça informações de contexto

• Stack tecnológico e frameworks usados
• Estrutura de arquivos relevante
• Convenções de código existentes
• Dependências de bibliotecas de terceiros

​

3. Melhoria iterativa

1. Gere a funcionalidade básica primeiro
2. Teste e valide
3. Forneça feedback de melhoria
4. Refine gradualmente

​

4. Revisão de código

• Verifique a corretude lógica
• Verifique a segurança
• Teste casos extremos
• Garanta conformidade com os padrões do projeto

​

5. Mantenha a continuidade da conversa

Rodada 1: Create user model
Rodada 2: Based on the model just created, create CRUD endpoints
Rodada 3: Add permission validation to these endpoints

​

Suporte e ajuda

• 📚 Documentação do APIMart
• 📚 Documentação oficial do Cline
• 💬 Comunidade do Discord
• 🐦 Twitter @APIMart_
• 📧 Suporte técnico: zhihong@apimart.ai

​

Tutoriais em vídeo