Claude Code

Visão geral

Tipo: Ferramenta de códigoCaminho principal: Anthropic-nativeNível de suporte: Caminho nativo forte

Claude Code é a ferramenta CLI oficial da Anthropic para programação assistida por IA. Você pode configurá-la para usar a TokenLab como provedora de API.

Instalação

A Anthropic agora recomenda o instalador nativo. A instalação via npm ainda existe por compatibilidade, mas está obsoleta upstream.

curl -fsSL https://claude.ai/install.sh | bash

Se você precisar especificamente do pacote npm, use:

npm install -g @anthropic-ai/claude-code

Não use sudo npm install -g para o Claude Code.

Configuração

Variáveis de ambiente

Defina as seguintes variáveis de ambiente:

export ANTHROPIC_API_KEY="sk-your-tokenlab-key"
export ANTHROPIC_BASE_URL="https://api.tokenlab.sh"

Adicione-as ao perfil do seu shell (~/.bashrc, ~/.zshrc, etc.) para persistência.

Para a TokenLab, mantenha ANTHROPIC_BASE_URL como https://api.tokenlab.sh sem o sufixo /v1. Isso corresponde ao formato de endpoint no estilo Anthropic e ao padrão de gateway unificado documentado pelo Claude Code.

Arquivo de configuração

Como alternativa, crie ou edite ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-tokenlab-key",
    "ANTHROPIC_BASE_URL": "https://api.tokenlab.sh"
  }
}

Uso

Após a configuração, use o Claude Code normalmente:

# Start an interactive session
claude

# Run a single command
claude "Explain this code" < main.py

# Chat mode
claude chat

Verifique a instalação, se necessário:

claude --version
claude doctor

Modelos disponíveis

A TokenLab oferece suporte a todos os modelos Claude:

Modelo	Descrição
`claude-opus-4-6`	Mais capaz, raciocínio complexo
`claude-sonnet-4-6`	Desempenho equilibrado, excelente para programação
`claude-haiku-4-5`	Mais rápido, com boa relação custo-benefício

Seleção de modelo

Especifique um modelo com a flag --model:

claude --model claude-sonnet-4-6 "Review this PR"

Ou defina um padrão na sua configuração:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-tokenlab-key",
    "ANTHROPIC_BASE_URL": "https://api.tokenlab.sh"
  },
  "model": "claude-sonnet-4-6"
}

Pensamento estendido

Para tarefas de raciocínio complexo, use modelos com extended thinking:

claude --model claude-opus-4-6 "Design a microservices architecture for..."

Solução de problemas

Erros de conexão

Verifique se a URL base é exatamente https://api.tokenlab.sh (sem o sufixo /v1 para requisições no estilo Anthropic).

API key inválida

Certifique-se de que sua API key da TokenLab comece com sk- e tenha saldo suficiente.

Gateway requer Authorization bearer token

O modo gateway do Claude Code também oferece suporte a ANTHROPIC_AUTH_TOKEN. Continue usando ANTHROPIC_API_KEY para a configuração padrão da TokenLab, a menos que você tenha alterado intencionalmente o comportamento de autenticação do seu gateway.

Modelo não encontrado

Verifique se o nome do modelo está correto. Use o formato claude-sonnet-4-6.

Matriz de compatibilidade

Ferramentas de código

SDKs nativos

Frameworks e plataformas

Apps de chat

Visão geral

Instalação

Configuração

Variáveis de ambiente

Arquivo de configuração

Uso

Modelos disponíveis

Seleção de modelo

Pensamento estendido

Solução de problemas

​Visão geral

​Instalação

​Configuração

​Variáveis de ambiente

​Arquivo de configuração

​Uso

​Modelos disponíveis

​Seleção de modelo

​Pensamento estendido

​Solução de problemas

Visão geral

Instalação

Configuração

Variáveis de ambiente

Arquivo de configuração

Uso

Modelos disponíveis

Seleção de modelo

Pensamento estendido

Solução de problemas