English 中文 العربية 日本語 Português

Claude Code: Configuração de API e Seleção de Modelo

Última atualização: 2026-08-31

O Claude Code usa a API da Anthropic por padrão, mas também suporta conexão com modelos de terceiros como DeepSeek via interfaces compatíveis. A configuração adequada da API é fundamental para controlar custo e qualidade.

💡 Dica: O Claude Code suporta nativamente a API da Anthropic via variável de ambiente ANTHROPIC_API_KEY. Modelos de terceiros requerem interfaces compatíveis com OpenAI.

📋 Pré-requisitos: Capítulo 2 - Instalação e Uso

1. O Que Você Vai Aprender

2. Configuração da API da Anthropic

(1) Obtendo uma API Key

BASH 
# Passos:
# 1. Acesse https://console.anthropic.com/
# 2. Registre/faça login na sua conta
# 3. Vá para a página API Keys
# 4. Clique em "Create Key"
# 5. Copie a Key (formato: sk-ant-api03-xxxxx)

(2) Configurar Variável de Ambiente

BASH 
# Temporário (apenas terminal atual)
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"

# Permanente (adicionar ao config do shell)
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"' >> ~/.zshrc
source ~/.zshrc

# Verificar
echo $ANTHROPIC_API_KEY
# sk-ant-api03-xxxxx

(3) Seleção de Modelo

Modelo Contexto Preço Input Preço Output Caso de Uso
Claude Sonnet 200K $3/MTok $15/MTok Programação diária, melhor custo-benefício
Claude Opus 200K $15/MTok $75/MTok Arquitetura complexa, raciocínio profundo
Claude Haiku 200K $0.25/MTok $1.25/MTok Consultas rápidas, baixo custo
BASH 
# Especificar modelo
claude --model claude-sonnet-4-20250514
claude --model claude-opus-4-20250514

# Ou via variável de ambiente
export CLAUDE_MODEL="claude-sonnet-4-20250514"

3. Integração com Modelo DeepSeek

(1) Configurar API DeepSeek

O DeepSeek fornece interfaces compatíveis com OpenAI utilizáveis pelo Claude Code:

BASH 
# Configurar API DeepSeek
export ANTHROPIC_API_KEY="your-deepseek-api-key"
export ANTHROPIC_BASE_URL="https://api.deepseek.com"

# Ou usar endpoint compatível com OpenAI
export OPENAI_API_KEY="your-deepseek-api-key"
export OPENAI_BASE_URL="https://api.deepseek.com/v1"

(2) Comparação de Modelos DeepSeek

Modelo Contexto Preço (Input/Output) Caso de Uso
DeepSeek V3 128K ¥2/MTok / ¥8/MTok Programação geral, custo extremo
DeepSeek R1 128K ¥4/MTok / ¥16/MTok Raciocínio profundo, matemática/lógica

▶ Exemplo 1: Fluxo Completo de Configuração DeepSeek

BASH 
# Alice usa DeepSeek para reduzir custos

# 1. Obter DeepSeek API Key
# Acesse https://platform.deepseek.com/

# 2. Configurar variáveis de ambiente
export ANTHROPIC_API_KEY="sk-deepseek-xxxxx"
export ANTHROPIC_BASE_URL="https://api.deepseek.com"
export CLAUDE_MODEL="deepseek-chat"

# 3. Executar Claude Code
claude "Help me refactor this function"

4. Estimativa e Controle de Custos

(1) Padrões de Consumo de Tokens

O consumo de Tokens do Claude Code vem principalmente de:

Fonte Participação Descrição
Contexto do projeto 40-60% Leitura de conteúdos de arquivos do projeto
Histórico de conversa 20-30% Registros de interações anteriores
Saída de código 10-20% Código gerado
Prompts do sistema 5-10% CLAUDE.md e outras instruções

(2) Estimativa de Custos

▶ Exemplo 2: Script de Estimativa de Custo Mensal

PYTHON 
def estimate_monthly_cost(
    daily_sessions: int,
    avg_context_tokens: int,
    avg_output_tokens: int,
    model_input_price: float,
    model_output_price: float,
    working_days: int = 22
):
    daily_input = daily_sessions * avg_context_tokens
    daily_output = daily_sessions * avg_output_tokens
    monthly_input = daily_input * working_days
    monthly_output = daily_output * working_days

    cost = (
        monthly_input * model_input_price / 1_000_000
        + monthly_output * model_output_price / 1_000_000
    )
    return round(cost, 2)

# Plano Sonnet
sonnet_cost = estimate_monthly_cost(
    daily_sessions=10,
    avg_context_tokens=50000,
    avg_output_tokens=5000,
    model_input_price=3,
    model_output_price=15
)
print(f"Sonnet monthly: ${sonnet_cost}")

# Plano DeepSeek
deepseek_cost = estimate_monthly_cost(
    daily_sessions=10,
    avg_context_tokens=50000,
    avg_output_tokens=5000,
    model_input_price=0.27,
    model_output_price=1.1
)
print(f"DeepSeek monthly: ${deepseek_cost}")

Saída:

TEXT 📖 Somente leitura 
Sonnet monthly: $46.2
DeepSeek monthly: $3.74

5. Gerenciamento de Múltiplas API Keys

▶ Exemplo 3: Alternar Configuração de API por Projeto

BASH 
# Configurar por projeto em arquivos .env
# project-a/.env
ANTHROPIC_API_KEY=sk-ant-project-a-key
CLAUDE_MODEL=claude-sonnet-4-20250514

# project-b/.env
ANTHROPIC_API_KEY=sk-deepseek-key
ANTHROPIC_BASE_URL=https://api.deepseek.com
CLAUDE_MODEL=deepseek-chat

# Usar direnv para alternância automática
# .envrc
source .env
export ANTHROPIC_API_KEY
export ANTHROPIC_BASE_URL
export CLAUDE_MODEL

(2) Monitoramento de Cota de API

BASH 
# Verificar uso da API Anthropic
curl https://api.anthropic.com/v1/usage \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01"

# Estatísticas integradas do Claude Code
claude /cost
# Current session token usage: 125,430
# Estimated cost: $2.34

6. Exemplo Completo: Configuração de Otimização de Custos

BASH 
# Plano de otimização de custos da Alice

# Projetos centrais: Usar Sonnet (qualidade primeiro)
export PROJECT_CORE_API_KEY="sk-ant-api03-xxxxx"
export PROJECT_CORE_MODEL="claude-sonnet-4-20250514"

# Projetos auxiliares: Usar DeepSeek (custo primeiro)
export PROJECT_AUX_API_KEY="sk-deepseek-xxxxx"
export PROJECT_AUX_BASE_URL="https://api.deepseek.com"
export PROJECT_AUX_MODEL="deepseek-chat"

# Configurar em aliases do shell
alias claude-core='ANTHROPIC_API_KEY=$PROJECT_CORE_API_KEY CLAUDE_MODEL=$PROJECT_CORE_MODEL claude'
alias claude-aux='ANTHROPIC_API_KEY=$PROJECT_AUX_API_KEY ANTHROPIC_BASE_URL=$PROJECT_AUX_BASE_URL CLAUDE_MODEL=$PROJECT_AUX_MODEL claude'

# Uso
cd core-project && claude-core "Refactor authentication module"
cd side-project && claude-aux "Add logging feature"

❓ Perguntas Frequentes

P: Como a qualidade do DeepSeek se compara ao Claude? R: O DeepSeek V3 atinge cerca de 80-90% do nível do Claude Sonnet em tarefas de programação, mas ainda fica aquém em raciocínio complexo e compreensão de contexto longo. Suficiente para programação diária; tarefas críticas devem usar Claude.

P: E se minha API Key vazar? R: Revogue imediatamente a Key no console e gere uma nova. Verifique o histórico do git por Keys acidentalmente commitadas.

P: Quanto tempo duram os créditos gratuitos? R: A Anthropic dá $5 em créditos para novas contas, suportando cerca de 50-100 sessões de programação de complexidade média no preço do Sonnet.

P: Posso configurar múltiplas APIs simultaneamente? R: Sim. Alterne entre projetos via variáveis de ambiente, ou use direnv para alternância automática.

P: O comprimento de contexto do DeepSeek é suficiente? R: O DeepSeek V3 suporta contexto de 128K, suficiente para a maioria dos projetos. Projetos muito grandes (100+ arquivos) podem precisar dos 200K do Claude.

P: Como sei o uso atual de Tokens? R: Digite /cost no Claude Code para ver o uso de tokens da sessão atual e custo estimado.

📖 Resumo

📝 Exercícios

  1. Básico (⭐): Configure a API Key da Anthropic, execute o Claude Code e confirme conexão bem-sucedida.
  2. Intermediário (⭐⭐): Estime o custo mensal de API do Claude Code da sua equipe (usando o script do exemplo).
  3. Avançado (⭐⭐⭐): Configure a integração com DeepSeek, compare a qualidade e custo da mesma tarefa entre Claude Sonnet e DeepSeek V3.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%