Recursos para Desenvolvedores

Claude Code

Instale o Claude Code, conecte-o ao RunAPI, escolha um modelo e verifique a configuração.

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.
Crie uma Chave de API RunAPI padrão no Guia de Autenticação. Não faça commit dela em um repositório.
Copie um identificador de modelo que suporte Anthropic Messages do Catálogo de Modelos.

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.

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.

Escolher um modelo

Substitua YOUR_RUNAPI_MODEL_ID pelo identificador exato do Catálogo de Modelos. 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.
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.
O modelo está indisponível: copie o identificador exato do Catálogo de Modelos 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.

Próximas etapas

Use o Início rápido da LLM API para o comportamento do protocolo e a Referência da API Anthropic Messages para os campos de requisição. Para adicionar ferramentas do RunAPI ao Claude Code, continue com a Visão Geral do MCP.