Integração do Claude Code

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.

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:

1
{
2
  "env": {
3
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
4
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
5
  }
6
}

Se o arquivo já existir, mescle esses dois itens ao env existente, sem sobrescrever as demais configurações.

Passos completos

Instalar Claude Code
Se já estiver instalado, pode pular. Os comandos abaixo vêm da documentação oficial de instalação do Claude Code:
macOS / Linux
Windows PowerShell
Homebrew
npm（需要 Node.js 22+）
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Homebrew
brew install --cask claude-code
npm（需要 Node.js 22+）
npm install -g @anthropic-ai/claude-code
Ao instalar com npm, não adicione sudo.
Obter chave da API
Crie uma nova chave de API no console; recomendamos usar uma dedicada ao Claude Code desta máquina. Veja obter e gerenciar chaves de API.

Configuração (escolha uma)

Localização do settings.json: no macOS / Linux é ~/.claude/settings.json; no Windows é %USERPROFILE%\.claude\settings.json.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

# 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"

# 持久写入当前用户，重开终端后生效
[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"

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.

Iniciar e confirmar
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 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
```
1
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):

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`

1
{
2
  "env": {
3
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
4
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
5
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
6
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
7
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
8
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
9
  }
10
}

O ID do modelo deve estar entre os modelos suportados. 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)):

1
{
2
  "claudeCode.environmentVariables": [
3
    { "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" },
4
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" }
5
  ]
6
}

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.

Não defina DISABLE_PROMPT_CACHING; isso desativa o cache e a fatura fica visivelmente mais alta, veja Prompt Caching.

Perguntas frequentes

Ao iniciar já aparece a tela de login / aviso Please run /login

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).

401 / Invalid API key

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.

404

ANTHROPIC_BASE_URL contém /v1 em excesso. Altere para https://1zheai.com.

Escolhi Opus, mas há chamadas de Haiku nos logs

Isso é o Claude Code executando pequenas tarefas em segundo plano na faixa Haiku. Para trocar por outro modelo, defina ANTHROPIC_DEFAULT_HAIKU_MODEL.

Como alternar entre a conta oficial e 1折AI?

Remova (ou comente) as duas variáveis acima para voltar ao login oficial. Se costuma alternar, use CC Switch e troque com um clique.

Usar 1折AI afeta minha conta Anthropic?

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.