Claude Code

Claude Code lê configurações relacionadas à Anthropic. Ao conectar ao 4096bytes, não cole um endereço compatível com OpenAI em campos não relacionados e não adicione /v1/messages manualmente. Use as configurações para Claude Code exibidas no painel.

Prefira gerenciar o Provider do Claude Code com CC Switch. Assim você alterna entre 4096bytes, Claude oficial e outros Providers sem editar variáveis de ambiente repetidamente.

Pré-requisitos

Você concluiu Criar conta.
Você concluiu Obter API Key.
Claude Code está instalado e claude consegue iniciar.
Você copiou a configuração de Claude Code do painel.

Se você usa uma assinatura oficial Claude e uma API Key do 4096bytes, mantenha as configurações em perfis de terminal ou perfis do CC Switch separados para evitar conflitos de variáveis.

Instalar

Se Claude Code não estiver instalado, siga a documentação oficial de instalação do Claude Code. macOS, Linux ou WSL:

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

Windows com WinGet:

winget install Anthropic.ClaudeCode

Se você usa npm para CLIs globais:

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

Depois da instalação, reabra o terminal e verifique:

claude --version

Copiar configuração do painel

Abrir API Keys

Abra o painel e vá para API Keys.

Encontrar a chave

Crie uma chave dedicada para Claude Code, como claude-code-work ou claude-code-mac.

Abrir Use key

Clique em Use key na linha da chave. Se o painel oferecer opções de cliente, escolha Claude Code.

Escolher o sistema

Selecione macOS / Linux, Windows PowerShell ou Windows CMD e copie o comando exibido no painel.

O comando do painel inclui a API Key atual. Os exemplos abaixo usam YOUR_4096BYTES_API_KEY como placeholder.

Variáveis temporárias

Use este método para um teste rápido. As variáveis deixam de existir quando você fecha o terminal.

macOS ou Linux

export ANTHROPIC_BASE_URL="https://api.4096bytes.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_4096BYTES_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

Se sua versão do Claude Code exigir ANTHROPIC_API_KEY, use:

export ANTHROPIC_BASE_URL="https://api.4096bytes.com"
export ANTHROPIC_API_KEY="YOUR_4096BYTES_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

Não defina ANTHROPIC_AUTH_TOKEN e ANTHROPIC_API_KEY ao mesmo tempo. Prefira o nome de variável exibido no painel.

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://api.4096bytes.com"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_4096BYTES_API_KEY"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"
claude

Se o painel usar ANTHROPIC_API_KEY, substitua a segunda linha por:

$env:ANTHROPIC_API_KEY = "YOUR_4096BYTES_API_KEY"

Windows CMD

set ANTHROPIC_BASE_URL=https://api.4096bytes.com
set ANTHROPIC_AUTH_TOKEN=YOUR_4096BYTES_API_KEY
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

Se o painel usar ANTHROPIC_API_KEY, substitua a segunda linha por:

set ANTHROPIC_API_KEY=YOUR_4096BYTES_API_KEY

Persistir nas configurações do Claude Code

Para uso contínuo, grave as variáveis de ambiente no arquivo de configurações do Claude Code.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.4096bytes.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_4096BYTES_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

Um caminho comum é ~/.claude/settings.json. Salve o arquivo e reinicie o Claude Code.

Não coloque API Keys em .env do projeto, README, capturas de tela ou documentos compartilhados. Claude Code lê o ambiente do terminal atual, então evite expor chaves em logs e capturas.

Persistir na configuração do shell

Você também pode gravar as variáveis em ~/.zshrc ou ~/.bashrc.

export ANTHROPIC_BASE_URL="https://api.4096bytes.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_4096BYTES_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Depois recarregue o shell:

source ~/.zshrc

Para Bash:

source ~/.bashrc

Execute:

claude

Especificar modelo

Se Claude Code exigir um modelo explícito, use o nome exibido no painel para Claude Code ou acesso compatível com Claude.

claude --model PASTE_MODEL_NAME_FROM_DASHBOARD

O nome do modelo deve corresponder exatamente ao painel.

Observações

Use o Base URL raiz exibido no painel, por exemplo https://api.4096bytes.com. Não adicione /v1/messages.
Depois de trocar Provider, reabra o terminal ou confirme que as variáveis de ambiente foram atualizadas.
Se usar CC Switch, confirme que o perfil ativo é 4096bytes.
Se executar Claude Code no terminal do VS Code, reabra o VS Code depois de alterar variáveis.

Diagnóstico

Problema	O que fazer
Falha de autenticação	Confirme que a API Key está completa e que apenas uma entre `ANTHROPIC_AUTH_TOKEN` ou `ANTHROPIC_API_KEY` está ativa.
Endereço errado	Use o endereço raiz exibido no painel. Não adicione caminho completo de requisição.
Ainda usa o serviço oficial	Reabra o terminal e verifique se variáveis antigas do Claude ainda existem.
Modelo indisponível	Use um nome de modelo compatível com Claude Code ou Claude exibido no painel.
Não funciona no VS Code	Feche e reabra o VS Code para que o terminal leia o ambiente atualizado.

Início rápido

Clientes

SDKs

Pré-requisitos

Instalar

Copiar configuração do painel

Variáveis temporárias

macOS ou Linux

Windows PowerShell

Windows CMD

Persistir nas configurações do Claude Code

Persistir na configuração do shell

Especificar modelo

Observações

Diagnóstico

​Pré-requisitos

​Instalar

​Copiar configuração do painel

​Variáveis temporárias

​macOS ou Linux

​Windows PowerShell

​Windows CMD

​Persistir nas configurações do Claude Code

​Persistir na configuração do shell

​Especificar modelo

​Observações

​Diagnóstico

Pré-requisitos

Instalar

Copiar configuração do painel

Variáveis temporárias

macOS ou Linux

Windows PowerShell

Windows CMD

Persistir nas configurações do Claude Code

Persistir na configuração do shell

Especificar modelo

Observações

Diagnóstico