> ## 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. # Usando o APIMart no Claude Code > Um guia detalhado sobre como configurar e usar os serviços de API do APIMart no CLI do Claude Code, permitindo que você acesse vários modelos de IA para programação assistida com uma configuração simples. Claude Code Main Interface ## Pré-requisitos O Claude Code é um assistente de programação de IA em linha de comando da Anthropic que suporta conversa direta com IA, geração de código e depuração no terminal. Ao conectar-se ao APIMart, você pode usar vários modelos, incluindo GPT, Claude e Gemini, dentro do Claude Code. Antes de começar, certifique-se de ter: 1. **Obtido uma chave de API do APIMart** Acesse o [Console do APIMart](https://apimart.ai/keys) para obter sua chave de API (começa com `sk-`) **Dica:** Se você ainda não tem uma conta no APIMart, registre-se primeiro em [APIMart](https://apimart.ai) e obtenha sua chave de API. ## Etapa 1: Instalar o Claude Code Escolha um dos seguintes métodos para instalar: Instale com o script oficial: ```bash theme={null} curl -fsSL https://claude.ai/install.sh | bash ``` Ou instale via Homebrew: ```bash theme={null} brew install --cask claude-code ``` Se encontrar problemas de permissão, adicione `sudo` antes do comando. **PowerShell:** ```powershell theme={null} irm https://claude.ai/install.ps1 | iex ``` **CMD:** ```cmd theme={null} curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd ``` Se você tem Node.js 18 ou mais recente instalado, pode instalar via npm: ```bash theme={null} npm install -g @anthropic-ai/claude-code ``` Funciona em todos os sistemas operacionais. ### Verificar a instalação Após a instalação, execute o seguinte comando para confirmar: ```bash theme={null} claude --version ``` Se um número de versão for exibido (por exemplo, `1.x.x`), a instalação foi bem-sucedida. ## Etapa 2: Configurar a API do APIMart Três métodos de configuração estão disponíveis. Escolha o que melhor se adapta ao seu fluxo de trabalho. ### Método 1: Editar settings.json (recomendado) A abordagem mais estável — configure uma vez e ela persiste. **1. Localize o diretório de configuração:** * Windows: Pressione `Win + R`, digite `%userprofile%\.claude` * macOS: Pressione `Command + Shift + G`, digite `~/.claude` * Linux: Navegue até `~/.claude` Se o diretório não existir, execute `claude` uma vez no terminal e pressione `Ctrl + C` para sair — o diretório será criado automaticamente. **2. Crie ou edite o arquivo `settings.json`:** ```json theme={null} { "env": { "ANTHROPIC_BASE_URL": "https://api.apimart.ai", "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx", "ANTHROPIC_MODEL": "claude-sonnet-4-6-apimart", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" } } ``` | Parâmetro | Descrição | | ------------------------------------------ | --------------------------------------------------------------- | | `ANTHROPIC_BASE_URL` | Endereço da API do APIMart, fixado em `https://api.apimart.ai` | | `ANTHROPIC_AUTH_TOKEN` | Sua chave de API do APIMart (começa com `sk-`) | | `ANTHROPIC_MODEL` | Modelo padrão a ser usado, escolha na lista de modelos abaixo | | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Defina como `1` para reduzir requisições de rede não essenciais | Salve o arquivo e reinicie o Claude Code para aplicar. ### Método 2: Variáveis de ambiente permanentes Grave a configuração no ambiente do sistema para que todas as janelas de terminal a carreguem automaticamente. ```bash theme={null} echo 'export ANTHROPIC_BASE_URL="https://api.apimart.ai"' >> ~/.zshrc echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.zshrc echo 'export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"' >> ~/.zshrc source ~/.zshrc ``` ```bash theme={null} echo 'export ANTHROPIC_BASE_URL="https://api.apimart.ai"' >> ~/.bashrc echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.bashrc echo 'export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"' >> ~/.bashrc source ~/.bashrc ``` **Opção A: Configurações GUI** 1. Clique com o botão direito em "Este Computador" → "Propriedades" → "Configurações avançadas do sistema" → "Variáveis de ambiente" 2. Adicione novas variáveis de usuário: * `ANTHROPIC_BASE_URL` = `https://api.apimart.ai` * `ANTHROPIC_API_KEY` = `sk-xxxxxxxxxxxx` * `ANTHROPIC_MODEL` = `claude-sonnet-4-6-apimart` 3. Reinicie o terminal **Opção B: Comandos PowerShell** ```powershell theme={null} [System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.apimart.ai', 'User') [System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-xxxxxxxxxxxx', 'User') [System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-sonnet-4-6-apimart', 'User') ``` ### Método 3: Variáveis de ambiente temporárias Adequado para testes rápidos — a configuração é perdida quando o terminal é fechado. ```bash theme={null} export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx" export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart" export ANTHROPIC_BASE_URL="https://api.apimart.ai" claude ``` ```powershell theme={null} $env:ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx" $env:ANTHROPIC_MODEL="claude-sonnet-4-6-apimart" $env:ANTHROPIC_BASE_URL="https://api.apimart.ai" claude ``` ```cmd theme={null} set ANTHROPIC_API_KEY=sk-xxxxxxxxxxxx set ANTHROPIC_MODEL=claude-sonnet-4-6-apimart set ANTHROPIC_BASE_URL=https://api.apimart.ai claude ``` As variáveis de ambiente temporárias funcionam apenas na janela de terminal atual. Você precisará defini-las novamente após mudar de janela ou fechar o terminal. ## Etapa 3: Começar a usar ### Verificar a configuração Inicie o Claude Code e envie uma mensagem simples para confirmar: ```bash theme={null} claude "Hello" ``` Se você receber uma resposta da IA, a configuração foi bem-sucedida. Se você vir erros `401`, `403` ou outros, consulte a FAQ abaixo. ### Modos de uso O Claude Code oferece dois modos de interação: * **Modo interativo**: Execute `claude` para uma conversa contínua, ideal para tarefas complexas * **Comando único**: Execute `claude "sua pergunta"` para uma resposta única, ideal para consultas rápidas ### Modelos suportados O APIMart suporta a série completa de modelos Claude. Você pode alternar flexivelmente com base nas suas necessidades: | Nome do modelo | Características | Uso recomendado | | ---------------------------- | ------------------------------------ | ------------------------------------------------ | | `claude-opus-4-6` | Capacidade geral mais forte | Arquitetura complexa, depuração difícil | | `claude-sonnet-4-6` | Desempenho e velocidade equilibrados | Programação diária, geração de código | | `claude-opus-4-5-20251101` | Raciocínio avançado | Código complexo, análise profunda | | `claude-sonnet-4-5-20250929` | Excelente capacidade de código | Design de algoritmos, otimização de código | | `claude-haiku-4-5-20251001` | Resposta ultrarrápida | Perguntas e respostas rápidas, trechos de código | Todos os modelos acima suportam uma versão Thinking (raciocínio estendido) — adicione `-thinking` ao ID do modelo, por exemplo, `claude-opus-4-6-thinking`. O modo Thinking é ideal para tarefas complexas que exigem raciocínio profundo. #### Modelos com desconto do APIMart O APIMart oferece modelos com desconto exclusivos por **apenas 20% do preço oficial**, com as mesmas capacidades. Basta adicionar `-apimart` ao ID do modelo: | Nome do modelo com desconto | Características | | ------------------------------------ | ------------------------------------ | | `claude-opus-4-6-apimart` | Capacidade geral mais forte | | `claude-sonnet-4-6-apimart` | Desempenho e velocidade equilibrados | | `claude-opus-4-5-20251101-apimart` | Raciocínio avançado | | `claude-sonnet-4-5-20250929-apimart` | Excelente capacidade de código | | `claude-haiku-4-5-20251001-apimart` | Resposta ultrarrápida | Versões Thinking também estão disponíveis, por exemplo, `claude-opus-4-6-thinking-apimart`, `claude-sonnet-4-6-thinking-apimart`, etc. **Recomendações de modelos:** * 💰 **Melhor custo-benefício:** `claude-sonnet-4-6-apimart` — Melhor escolha para programação diária, apenas 20% do preço oficial * 🚀 **Alto desempenho:** `claude-opus-4-6-apimart` — Para os desafios mais complexos de código e arquitetura * ⚡ **Resposta rápida:** `claude-haiku-4-5-20251001-apimart` — Quando você precisa de feedback instantâneo * 🧠 **Pensamento profundo:** `claude-opus-4-6-thinking-apimart` — Quando é necessário raciocínio profundo Para trocar de modelo, use o comando `/model` no modo interativo, ou modifique o campo `ANTHROPIC_MODEL` na sua configuração e reinicie. ### Comandos comuns Aqui estão os comandos e atalhos frequentemente usados no Claude Code: | Comando | Descrição | | ------------------- | ----------------------------------- | | `claude` | Entrar no modo interativo | | `claude "pergunta"` | Consulta única | | `claude --version` | Verificar a versão | | `/model` | Trocar de modelo no modo interativo | | `/help` | Visualizar informações de ajuda | | `Ctrl + C` | Sair do modo interativo | ## FAQ ### Q1: Ainda vejo a página de seleção de login após a configuração? Se "Select login method" ainda aparecer após a inicialização, a configuração não teve efeito. **Passos para solução de problemas:** 1. **Usando settings.json**: Verifique se o caminho do arquivo está correto * Windows: `C:\Users\\.claude\settings.json` * macOS / Linux: `~/.claude/settings.json` 2. **Usando variáveis de ambiente**: Certifique-se de ter iniciado o Claude Code na **mesma janela de terminal** onde você definiu as variáveis 3. **Verifique o formato JSON**: Certifique-se de que colchetes, vírgulas e aspas estejam todos corretos ### Q2: Recebendo erros 401 / 403? | Código de erro | Significado | Solução | | ------------------ | ------------------------------------------ | ---------------------------------------------------------------------------- | | `401 Unauthorized` | Chave de API ausente ou inválida | Verifique se a chave está correta e começa com `sk-` | | `403 Forbidden` | Permissões insuficientes ou chave expirada | Acesse o [Console](https://apimart.ai/keys) para verificar o status da chave | Certifique-se também de que `ANTHROPIC_BASE_URL` está definido como `https://api.apimart.ai`, e não o endereço oficial da Anthropic. ### Q3: Erro "Unable to connect"? Isso significa que o Claude Code não conseguiu se conectar ao serviço de API. 1. Verifique sua conexão de rede 2. Verifique se `ANTHROPIC_BASE_URL` está configurado corretamente 3. Se estiver usando um proxy, certifique-se de que ele permite o acesso a `api.apimart.ai` ### Q4: Erro "Auth conflict"? Se você vir uma mensagem como: ``` Auth conflict: Both a token (claude.ai) and an API key (ANTHROPIC_API_KEY) are set. ``` Isso significa que você está logado no claude.ai e tem uma chave de API definida ao mesmo tempo, causando um conflito. **Solução:** Execute `/logout` no modo interativo do Claude Code para sair do claude.ai, mantendo apenas a configuração da chave de API. ### Q5: Erro max\_tokens ao usar modelos não-Claude? Se você vir um erro como: ``` max_tokens is too large: 32000. This model supports at most 16384 completion tokens. ``` Isso ocorre porque o Claude Code envia requisições com parâmetros do modelo Claude por padrão (32000 tokens), enquanto alguns modelos não-Claude (por exemplo, `gpt-4o`) têm limites de tokens mais baixos. **Solução:** Mude para um modelo Claude (por exemplo, `claude-sonnet-4-6-apimart`), que é nativamente compatível com o Claude Code e não causará esse problema. ### Q6: Resposta lenta? 1. Mude para um modelo mais rápido (por exemplo, `claude-haiku-4-5-20251001-apimart` ou `claude-sonnet-4-6-apimart`) 2. Encurte seus prompts para reduzir o comprimento do contexto 3. Verifique as condições da sua rede ### Q7: Como trocar de modelo? Duas maneiras: 1. **No modo interativo**: Digite o comando `/model` 2. **Edite a configuração**: Altere o campo `ANTHROPIC_MODEL` em `settings.json` ou nas variáveis de ambiente e reinicie o Claude Code ### Q8: O Claude Code lê arquivos locais automaticamente? Não. O Claude Code requer que você faça referência aos arquivos explicitamente e pedirá confirmação antes de realizar operações sensíveis. É recomendável usá-lo em diretórios de projeto dedicados. ### Q9: Como analisar arquivos locais com o Claude Code? No modo interativo, você pode fazer referência a arquivos: * Digitando o caminho do arquivo diretamente * Arrastando arquivos para a janela do terminal * Copiando e colando o conteúdo do arquivo ### Q10: Como verificar o uso e os custos? Acesse o [Console do APIMart](https://apimart.ai/overview) para visualizar: * Estatísticas de chamadas de API * Detalhes de consumo de tokens * Estatísticas e tendências de custos ## Suporte Se você encontrar algum problema: * 📚 [Documentação do APIMart](https://docs.apimart.ai) * 💬 [Comunidade do Discord](https://discord.gg/V8zqssyZ5c) * 🐦 [Twitter @APIMart\_](https://x.com/APIMart_) * 📧 Suporte técnico: [zhihong@apimart.ai](mailto:zhihong@apimart.ai) *** Cadastre-se no APIMart agora, obtenha sua chave de API e experimente o assistente de programação multimodelo no Claude Code!