Claude CodeAtualizado em 29 de setembro de 20264 min de leitura

Claude Code em reais: como usar com o Claude Opus 5 pagando no Pix

O Claude Code é o agente de programação da Anthropic que roda no terminal: ele lê o seu projeto, edita arquivos, roda comandos e explica o que está fazendo. Ele aceita uma URL própria para a API, e é isso que permite usar o Claude Code pagando em reais.

Neste guia você configura o Claude Code com a API da open33 em dois comandos, escolhe o Claude Opus 5 e aprende a resolver os erros mais comuns.

O que você precisa

• O Claude Code instalado. As instruções de instalação estão na documentação oficial do Claude Code. No Windows, siga o guia Claude Code no Windows.
• Uma chave da open33, que aparece no painel depois que você escolhe um plano.
• A URL base da open33: https://api.open33.tech.

O Claude Code usa duas variáveis de ambiente para isso:

macOS e Linux

No terminal, antes de abrir o Claude Code:

export ANTHROPIC_BASE_URL="https://api.open33.tech"
export ANTHROPIC_API_KEY="SUA_CHAVE"
claude

Para não precisar repetir isso a cada terminal novo, adicione as duas linhas export ao final do arquivo de configuração do seu shell: ~/.zshrc no macOS (zsh) ou ~/.bashrc no Linux (bash). Depois abra um terminal novo.

Windows (PowerShell)

Só para a janela atual:

$env:ANTHROPIC_BASE_URL = "https://api.open33.tech"
$env:ANTHROPIC_API_KEY = "SUA_CHAVE"
claude

Para deixar salvo no seu usuário, use setx e abra uma janela nova do terminal em seguida:

setx ANTHROPIC_BASE_URL "https://api.open33.tech"
setx ANTHROPIC_API_KEY "SUA_CHAVE"

Alternativa: arquivo de configuração do Claude Code

O Claude Code também aceita variáveis de ambiente no arquivo settings.json. No arquivo do seu usuário (~/.claude/settings.json), acrescente:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.open33.tech",
    "ANTHROPIC_API_KEY": "SUA_CHAVE"
  }
}

Evite colocar a chave no settings.json de um projeto que vai para o Git. Chave em repositório é chave vazada.

Escolha o Claude Opus 5

Você pode escolher o modelo ao abrir o Claude Code:

claude --model claude-opus-5

Ou, com o Claude Code aberto, use o comando /model e selecione o modelo. O identificador do Claude Opus 5 na API é claude-opus-5.

Teste a configuração

Um teste rápido, sem abrir a sessão interativa:

claude -p "Responda só com: funcionando"

Se a resposta aparecer, está tudo certo. Dentro do Claude Code, o comando /status mostra a configuração em uso. Se o Claude Code perguntar se deve usar a chave de API encontrada no ambiente, confirme.

Com tudo funcionando, veja os comandos do Claude Code mais usados e como deixar instruções fixas para o seu projeto no CLAUDE.md.

Erros comuns e como resolver

401 (não autorizado): a chave está errada, vazia ou foi revogada. Confira se a variável ANTHROPIC_API_KEY tem a chave do painel da open33, sem espaços ou aspas sobrando.

404 (endpoint não encontrado): quase sempre é a URL base com /v1 no final. O Claude Code e os SDKs já acrescentam /v1/messages sozinhos. Use exatamente https://api.open33.tech.

429 (limite atingido): você passou do limite de requisições ou de tokens do seu plano. Espere a janela seguinte ou mude para um plano com limite maior. Sessões longas de agente consomem bastante contexto, então vale acompanhar o consumo no painel.

O Claude Code pede login na conta da Anthropic: as variáveis não chegaram ao processo. Abra um terminal novo depois de editar o ~/.zshrc, o ~/.bashrc ou rodar setx, e confira com echo $ANTHROPIC_BASE_URL (ou echo $env:ANTHROPIC_BASE_URL no PowerShell). As outras causas, como uma chave recusada na primeira vez ou a extensão do VS Code, estão no guia Claude Code pedindo login.

A lista completa está no guia de erros da API do Claude.

Dicas para gastar menos do seu limite

• Peça tarefas bem definidas. Um pedido vago leva a mais leitura de arquivos e mais tokens.
• Use o /compact quando a conversa ficar longa e o histórico antigo não for mais necessário.
• Abra uma sessão nova para tarefas sem relação com a anterior.