--- title: "Integração do Claude Code" description: "Conecte o Claude Code ao 1折AI: use ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN (variáveis de ambiente ou settings.json), com instruções para Windows, mapeamento de modelos, extensão do VS Code e erros comuns." headingIds: {"Caminho mais curto":"section-1","Passos completos":"section-2","Por que usar ANTHROPIC_AUTH_TOKEN":"section-3","Mapeamento de modelos":"section-4","Extensão do VS Code":"section-5","Configurações opcionais":"section-6","Perguntas frequentes":"section-7"} --- O Claude Code precisa apenas de duas variáveis: `ANTHROPIC_BASE_URL` aponta para nós e `ANTHROPIC_AUTH_TOKEN` recebe sua chave de API (API key). Não é necessário fazer login em uma conta da Anthropic. ## Caminho mais curto Se você já instalou o Claude Code e tem uma chave de API em mãos, escreva as duas linhas abaixo em `~/.claude/settings.json` e depois execute `claude`: ```json title="~/.claude/settings.json" { "env": { "ANTHROPIC_BASE_URL": "https://1zheai.com", "ANTHROPIC_AUTH_TOKEN": "sk-你的Key" } } ``` Se o arquivo já existir, mescle esses dois itens ao `env` existente, sem sobrescrever as demais configurações. ## Passos completos Se já estiver instalado, pode pular. Os comandos abaixo vêm da [documentação oficial de instalação do Claude Code](https://code.claude.com/docs/en/setup): ```bash title="macOS / Linux" curl -fsSL https://claude.ai/install.sh | bash ``` ```powershell title="Windows PowerShell" irm https://claude.ai/install.ps1 | iex ``` ```bash title="Homebrew" brew install --cask claude-code ``` ```bash title="npm（需要 Node.js 22+）" npm install -g @anthropic-ai/claude-code ``` Ao instalar com npm, não adicione `sudo`. Crie uma nova chave de API no [console](https://1zheai.com/console?lng=pt); recomendamos usar uma dedicada ao Claude Code desta máquina. Veja [obter e gerenciar chaves de API](/pt/docs/api-keys/). Localização do settings.json: no macOS / Linux é `~/.claude/settings.json`; no Windows é `%USERPROFILE%\.claude\settings.json`. ```json title="settings.json（推荐）" { "env": { "ANTHROPIC_BASE_URL": "https://1zheai.com", "ANTHROPIC_AUTH_TOKEN": "sk-你的Key" } } ``` ```bash title="macOS / Linux 环境变量" # 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端 export ANTHROPIC_BASE_URL="https://1zheai.com" export ANTHROPIC_AUTH_TOKEN="sk-你的Key" ``` ```powershell title="Windows PowerShell" # 持久写入当前用户，重开终端后生效 [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://1zheai.com", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User") # 只在当前窗口生效 $env:ANTHROPIC_BASE_URL = "https://1zheai.com" $env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key" ``` ```bat title="Windows CMD" setx ANTHROPIC_BASE_URL "https://1zheai.com" setx ANTHROPIC_AUTH_TOKEN "sk-你的Key" ``` Preencha `ANTHROPIC_BASE_URL` com o endereço raiz, sem adicionar `/v1`; o Claude Code monta `/v1/messages` automaticamente. Execute `claude` no diretório do projeto e, dentro dele, digite `/status`. Observe duas linhas: - a linha da base URL mostra `https://1zheai.com` - a linha das credenciais mostra que a origem é `ANTHROPIC_AUTH_TOKEN` Em seguida, faça uma pergunta e verifique no [log de chamadas](/pt/docs/usage-logs/) se há um novo registro. Se houver, a conexão está funcionando. Se preferir não entrar na interface interativa, também é possível testar uma vez em modo não interativo (testado em 2026-10-15, retornou `ok`): ```bash claude -p "say ok" --model claude-sonnet-4-6 ``` ## Por que usar ANTHROPIC_AUTH_TOKEN O Claude Code tem duas variáveis que podem receber a chave de API; a diferença é a seguinte ([explicação oficial](https://code.claude.com/docs/en/authentication)): | Variável | Forma de envio | Comportamento | |---|---|---| | `ANTHROPIC_AUTH_TOKEN` | `Authorization: Bearer <值>` | entra em vigor imediatamente após a definição, sem confirmação | | `ANTHROPIC_API_KEY` | `x-api-key: <值>` | no modo interativo, na primeira vez exibe um aviso perguntando se você deseja usar essa chave de API | Suportamos ambas; recomendamos `ANTHROPIC_AUTH_TOKEN`. **Defina apenas uma das duas**: se ainda houver um `ANTHROPIC_API_KEY` antigo da configuração oficial no sistema, remova-o para evitar mistura e erros 401. Outras duas regras fáceis de errar: - Quando o `env` em `settings.json` e um export no terminal definem a mesma variável, **o settings.json tem prioridade**. Se alterou a variável do terminal e não teve efeito, verifique primeiro o settings.json. - Não escreva a chave de API no `.claude/settings.json` do projeto; esse arquivo costuma ser enviado ao repositório. Para diferenciar por projeto, use um `.claude/settings.local.json` que não seja enviado. ## Mapeamento de modelos No Claude Code, `opus`, `sonnet`, `haiku` e `fable` são aliases; é possível especificar por variáveis de ambiente os modelos concretos a que eles correspondem. A faixa Haiku também é usada pelo Claude Code para executar algumas pequenas tarefas em segundo plano. | Variável | Função | Valor de exemplo | |---|---|---| | `ANTHROPIC_MODEL` | modelo usado na inicialização | `claude-sonnet-5-5` | | `ANTHROPIC_DEFAULT_OPUS_MODEL` | modelo apontado pelo alias `opus` | `claude-opus-5-5` | | `ANTHROPIC_DEFAULT_SONNET_MODEL` | modelo apontado pelo alias `sonnet` | `claude-sonnet-5-5` | | `ANTHROPIC_DEFAULT_HAIKU_MODEL` | modelo usado pelo alias `haiku` e pelas tarefas em segundo plano | `claude-haiku-5-5` | | `ANTHROPIC_DEFAULT_FABLE_MODEL` | modelo apontado pelo alias `fable` | `claude-fable-5-1` | ```json title="~/.claude/settings.json（带模型映射）" { "env": { "ANTHROPIC_BASE_URL": "https://1zheai.com", "ANTHROPIC_AUTH_TOKEN": "sk-你的Key", "ANTHROPIC_MODEL": "claude-sonnet-5-5", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5" } } ``` O ID do modelo deve estar entre os [modelos suportados](/pt/docs/models/). Durante a execução também é possível alternar temporariamente com `/model claude-opus-5-5`. ## Extensão do VS Code A extensão do VS Code do Claude Code verifica as credenciais antes de iniciar; a recomendação oficial é escrever as variáveis nas próprias configurações de usuário do VS Code (Paleta de comandos → Preferences: Open User Settings (JSON)): ```json title="VS Code settings.json" { "claudeCode.environmentVariables": [ { "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" }, { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" } ] } ``` Se escritas apenas em `~/.claude/settings.json`, a verificação de login da própria extensão pode não conseguí-las ler. ## Configurações opcionais | Variável | Função | |---|---| | `API_TIMEOUT_MS` | tempo limite da requisição; padrão 600000 (10 minutos); em tarefas longas, que tendem a estourar o limite, pode ser aumentado | | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` | desativa atualizações automáticas, telemetria, relatório de erros e outros tráfegos desnecessários. Atenção: definir como `0` ou `false` também conta como ativado; para desativar, é preciso remover esta variável | | `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` | usado ao encontrar erros 400 como "Extra inputs are not permitted" | | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` | faz com que a lista `/model` busque os modelos disponíveis em `/v1/models` | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` foi testado e está funcionando (Claude Code 2.1.296, 2026-10-15): após a inicialização, `[gatewayDiscovery] cached 14 models` aparece no log de debug, e os 14 modelos coincidem com os [modelos suportados](/pt/docs/models/). Não defina `DISABLE_PROMPT_CACHING`; isso desativa o cache e a fatura fica visivelmente mais alta, veja [Prompt Caching](/pt/docs/prompt-caching/). ## Perguntas frequentes O Claude Code não leu a chave de API. Verifique a grafia do nome da variável; se usa variáveis de ambiente, confirme que iniciou em um terminal recém-aberto; se usa settings.json, confirme que o JSON está correto (uma vírgula extra invalida tudo). A chave de API foi copiada de forma incompleta, ou `ANTHROPIC_API_KEY` e `ANTHROPIC_AUTH_TOKEN` existem ao mesmo tempo e um deles é um valor antigo. Mantenha apenas um. Mais detalhes em [códigos de erro e solução de problemas](/pt/docs/troubleshooting/). `ANTHROPIC_BASE_URL` contém `/v1` em excesso. Altere para `https://1zheai.com`. Isso é o Claude Code executando pequenas tarefas em segundo plano na faixa Haiku. Para trocar por outro modelo, defina `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Remova (ou comente) as duas variáveis acima para voltar ao login oficial. Se costuma alternar, use [CC Switch](/pt/docs/quickstart-cc-switch/) e troque com um clique. Não gera associação. Ao integrar ao 1折AI, o Claude Code usa nossa chave de API e não faz login na sua conta da Anthropic.