--- title: Claude Code | RunAPI description: Instale o Claude Code, conecte-o ao RunAPI, escolha um modelo e verifique a configuração. url: https://runapi.ai/pt-BR/docs/resources/tool-integrations/claude-code.md canonical: https://runapi.ai/pt-BR/docs/resources/tool-integrations/claude-code locale: pt-BR --- > Versão HTML: https://runapi.ai/pt-BR/docs/resources/tool-integrations/claude-code > Índice do site para agentes: https://runapi.ai/llms.txt # Claude Code ## Visão geral Claude Code é uma ferramenta de codificação agêntica para o terminal. Este guia instala o CLI, direciona suas requisições compatíveis com Anthropic para o RunAPI, seleciona um modelo do RunAPI e verifica a conexão. ## Antes de começar * Use uma plataforma compatível com o [guia oficial de configuração do Claude Code][1]. * Crie uma Chave de API RunAPI padrão no [Guia de Autenticação](https://runapi.ai/pt-BR/docs/guides/authentication.md). Não faça commit dela em um repositório. * Copie um identificador de modelo que suporte Anthropic Messages do [Catálogo de Modelos](https://runapi.ai/pt-BR/models). [1]: https://code.claude.com/docs/en/setup ## Instalar Use o instalador nativo oficial no macOS, Linux ou WSL e confirme que o comando está disponível: ```shell curl -fsSL https://claude.ai/install.sh | bash claude --version ``` Para Homebrew, WinGet e requisitos específicos de plataforma, use o [guia de instalação oficial][1]. [1]: https://code.claude.com/docs/en/setup ## Configurar o RunAPI Para um primeiro teste, exporte a URL Base, a Chave de API e o modelo no shell atual: ```shell export ANTHROPIC_BASE_URL=https://runapi.ai export ANTHROPIC_API_KEY=YOUR_RUNAPI_API_KEY export ANTHROPIC_MODEL=YOUR_RUNAPI_MODEL_ID ``` Para aplicar os valores a todas as sessões do Claude Code do seu usuário, coloque-os no objeto `env` em `~/.claude/settings.json`: ```json { "env": { "ANTHROPIC_BASE_URL": "https://runapi.ai", "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY", "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID" } } ``` Mantenha a chave real fora de `.claude/settings.json`, que se destina a configurações de projeto que podem ser enviadas ao repositório. Para escopos de configuração e precedência, use a [referência de configurações do Claude Code][1]. [1]: https://code.claude.com/docs/en/settings ## Escolher um modelo Substitua `YOUR_RUNAPI_MODEL_ID` pelo identificador exato do [Catálogo de Modelos](https://runapi.ai/pt-BR/models). `ANTHROPIC_BASE_URL` altera o destino das solicitações; não escolhe um modelo. Você também pode iniciar uma sessão com `claude --model YOUR_RUNAPI_MODEL_ID` ou executar `/model` durante uma sessão. ## Verificar Execute as verificações de instalação e configuração, depois envie um prompt curto: ```shell claude --version claude doctor claude ``` Dentro do Claude Code, execute `/status` para confirmar as configurações carregadas e o modelo ativo. Uma resposta normal a `Describe this repository in one sentence.` confirma que a conexão com o RunAPI está funcionando. ## Solucionar problemas * **`claude` não é encontrado:** reabra o terminal e siga o [troubleshooting oficial de instalação][1]. * **As configurações não carregam:** valide `~/.claude/settings.json` com `claude doctor` e use `/status` para inspecionar as fontes carregadas. * **A autenticação falha:** confirme que `ANTHROPIC_API_KEY` contém uma chave RunAPI ativa. Crie ou rotacione chaves pelo [Guia de Autenticação](https://runapi.ai/pt-BR/docs/guides/authentication.md). * **O modelo está indisponível:** copie o identificador exato do [Catálogo de Modelos](https://runapi.ai/pt-BR/models) e inicie uma nova sessão. Sessões retomadas podem manter o modelo anterior. * **As requisições usam outro endpoint:** inicie um novo terminal após alterar variáveis de ambiente e verifique se há uma configuração Claude Code de maior precedência. [1]: https://code.claude.com/docs/en/troubleshoot-install ## Próximas etapas Use o [Início rápido da LLM API](https://runapi.ai/pt-BR/docs/guides/llm-api/quickstart.md) para o comportamento do protocolo e a [Referência da API Anthropic Messages](https://runapi.ai/pt-BR/docs/api/anthropic/messages.md) para os campos de requisição. Para adicionar ferramentas do RunAPI ao Claude Code, continue com a [Visão Geral do MCP](https://runapi.ai/pt-BR/docs/resources/mcp.md). --- ## Mais de RunAPI - [Início](https://runapi.ai/pt-BR/.md) - [Catálogo de modelos](https://runapi.ai/pt-BR/models.md) - [Preços](https://runapi.ai/pt-BR/pricing.md) - [Provedores](https://runapi.ai/pt-BR/models) - [Documentação](https://runapi.ai/pt-BR/docs/guides) - [SDKs](https://runapi.ai/pt-BR/sdk.md) - [CLI](https://runapi.ai/pt-BR/cli.md) - [Servidor MCP](https://runapi.ai/pt-BR/mcp.md) - [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md) - [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md) - [Enterprise](https://runapi.ai/pt-BR/contact.md) - [Contato](https://runapi.ai/pt-BR/contact.md) - [Termos](https://runapi.ai/pt-BR/terms.md) - [Privacidade](https://runapi.ai/pt-BR/privacy.md) - [Índice do site para agentes](https://runapi.ai/llms.txt) Contato: contact@runapi.ai ## Dados estruturados ```json [ { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/pt-BRicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "TechArticle", "headline": "Claude Code", "description": "Instale o Claude Code, conecte-o ao RunAPI, escolha um modelo e verifique a configuração.", "url": "https://runapi.ai/pt-BR/docs/resources/tool-integrations/claude-code", "mainEntityOfPage": "https://runapi.ai/pt-BR/docs/resources/tool-integrations/claude-code" } ] ```