Usando o OneAster no Claude Code

Pré-requisitos

O Claude Code é um assistente de programação de IA em linha de comando da Anthropic que suporta conversa direta com IA, geração de código e depuração no terminal. Ao conectar-se ao OneAster, você pode usar vários modelos, incluindo GPT, Claude e Gemini, dentro do Claude Code. Antes de começar, certifique-se de ter:

Obtido uma chave de API do OneAster Acesse o Console do OneAster para obter sua chave de API (começa com sk-)

Dica: Se você ainda não tem uma conta no OneAster, registre-se primeiro em OneAster e obtenha sua chave de API.

Etapa 1: Instalar o Claude Code

Escolha um dos seguintes métodos para instalar:

macOS / Linux (Recomendado)
Windows
Instalação via NPM

Instale com o script oficial:

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

Ou instale via Homebrew:

brew install --cask claude-code

Se encontrar problemas de permissão, adicione sudo antes do comando.

PowerShell:

irm https://claude.ai/install.ps1 | iex

CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Se você tem Node.js 18 ou mais recente instalado, pode instalar via npm:

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

Funciona em todos os sistemas operacionais.

Verificar a instalação

Após a instalação, execute o seguinte comando para confirmar:

claude --version

Se um número de versão for exibido (por exemplo, 1.x.x), a instalação foi bem-sucedida.

Etapa 2: Configurar a API do OneAster

Três métodos de configuração estão disponíveis. Escolha o que melhor se adapta ao seu fluxo de trabalho.

Método 1: Editar settings.json (recomendado)

A abordagem mais estável — configure uma vez e ela persiste. 1. Localize o diretório de configuração:

Windows: Pressione Win + R, digite %userprofile%\.claude
macOS: Pressione Command + Shift + G, digite ~/.claude
Linux: Navegue até ~/.claude

Se o diretório não existir, execute claude uma vez no terminal e pressione Ctrl + C para sair — o diretório será criado automaticamente.

2. Crie ou edite o arquivo settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.oneaster.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "claude-opus-5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Parâmetro	Descrição
`ANTHROPIC_BASE_URL`	Endereço da API do OneAster, fixado em `https://api.oneaster.ai`
`ANTHROPIC_AUTH_TOKEN`	Sua chave de API do OneAster (começa com `sk-`)
`ANTHROPIC_MODEL`	Modelo padrão a ser usado, escolha na lista de modelos abaixo
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	Defina como `1` para reduzir requisições de rede não essenciais

Salve o arquivo e reinicie o Claude Code para aplicar.

Método 2: Variáveis de ambiente permanentes

Grave a configuração no ambiente do sistema para que todas as janelas de terminal a carreguem automaticamente.

macOS (zsh)
macOS / Linux (bash)
Windows

echo 'export ANTHROPIC_BASE_URL="https://api.oneaster.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-opus-5"' >> ~/.zshrc
source ~/.zshrc

echo 'export ANTHROPIC_BASE_URL="https://api.oneaster.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL="claude-opus-5"' >> ~/.bashrc
source ~/.bashrc

Opção A: Configurações GUI

Clique com o botão direito em “Este Computador” → “Propriedades” → “Configurações avançadas do sistema” → “Variáveis de ambiente”
Adicione novas variáveis de usuário:
- ANTHROPIC_BASE_URL = https://api.oneaster.ai
- ANTHROPIC_API_KEY = sk-xxxxxxxxxxxx
- ANTHROPIC_MODEL = claude-opus-5
Reinicie o terminal

Opção B: Comandos PowerShell

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.oneaster.ai', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-xxxxxxxxxxxx', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-opus-5', 'User')

Método 3: Variáveis de ambiente temporárias

Adequado para testes rápidos — a configuração é perdida quando o terminal é fechado.

macOS / Linux
Windows (PowerShell)
Windows (CMD)

export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
export ANTHROPIC_MODEL="claude-opus-5"
export ANTHROPIC_BASE_URL="https://api.oneaster.ai"
claude

$env:ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
$env:ANTHROPIC_MODEL="claude-opus-5"
$env:ANTHROPIC_BASE_URL="https://api.oneaster.ai"
claude

set ANTHROPIC_API_KEY=sk-xxxxxxxxxxxx
set ANTHROPIC_MODEL=claude-opus-5
set ANTHROPIC_BASE_URL=https://api.oneaster.ai
claude

As variáveis de ambiente temporárias funcionam apenas na janela de terminal atual. Você precisará defini-las novamente após mudar de janela ou fechar o terminal.

Etapa 3: Começar a usar

Verificar a configuração

Inicie o Claude Code e envie uma mensagem simples para confirmar:

claude "Hello"

Se você receber uma resposta da IA, a configuração foi bem-sucedida. Se você vir erros 401, 403 ou outros, consulte a FAQ abaixo.

Modos de uso

O Claude Code oferece dois modos de interação:

Modo interativo: Execute claude para uma conversa contínua, ideal para tarefas complexas
Comando único: Execute claude "sua pergunta" para uma resposta única, ideal para consultas rápidas

Modelos suportados

O OneAster suporta a série completa de modelos Claude. Você pode alternar flexivelmente com base nas suas necessidades:

Nome do modelo	Características	Uso recomendado
`claude-opus-5`	Modelo principal de nova geração	Arquitetura complexa, depuração difícil
`claude-opus-4-6`	Forte capacidade geral	Arquitetura complexa, depuração difícil
`claude-sonnet-4-6`	Desempenho e velocidade equilibrados	Programação diária, geração de código
`claude-opus-4-5-20251101`	Raciocínio avançado	Código complexo, análise profunda
`claude-sonnet-4-5-20250929`	Excelente capacidade de código	Design de algoritmos, otimização de código
`claude-haiku-4-5-20251001`	Resposta ultrarrápida	Perguntas e respostas rápidas, trechos de código

Todos os modelos acima suportam uma versão Thinking (raciocínio estendido) — adicione -thinking ao ID do modelo, por exemplo, claude-opus-4-6-thinking. O modo Thinking é ideal para tarefas complexas que exigem raciocínio profundo.

Recomendações de modelos:

🚀 Alto desempenho: claude-opus-5 — Para os desafios mais complexos de código e arquitetura
⚖️ Desempenho equilibrado: claude-sonnet-4-6 — Para programação diária
⚡ Resposta rápida: claude-haiku-4-5-20251001 — Quando você precisa de feedback instantâneo
🧠 Pensamento profundo: claude-opus-5-thinking — Quando é necessário raciocínio profundo

Para trocar de modelo, use o comando /model no modo interativo, ou modifique o campo ANTHROPIC_MODEL na sua configuração e reinicie.

Comandos comuns

Aqui estão os comandos e atalhos frequentemente usados no Claude Code:

Comando	Descrição
`claude`	Entrar no modo interativo
`claude "pergunta"`	Consulta única
`claude --version`	Verificar a versão
`/model`	Trocar de modelo no modo interativo
`/help`	Visualizar informações de ajuda
`Ctrl + C`	Sair do modo interativo

FAQ

Se “Select login method” ainda aparecer após a inicialização, a configuração não teve efeito. Passos para solução de problemas:

Usando settings.json: Verifique se o caminho do arquivo está correto
- Windows: C:\Users\<username>\.claude\settings.json
- macOS / Linux: ~/.claude/settings.json
Usando variáveis de ambiente: Certifique-se de ter iniciado o Claude Code na mesma janela de terminal onde você definiu as variáveis
Verifique o formato JSON: Certifique-se de que colchetes, vírgulas e aspas estejam todos corretos

Q2: Recebendo erros 401 / 403?

Código de erro	Significado	Solução
`401 Unauthorized`	Chave de API ausente ou inválida	Verifique se a chave está correta e começa com `sk-`
`403 Forbidden`	Permissões insuficientes ou chave expirada	Acesse o Console para verificar o status da chave

Certifique-se também de que ANTHROPIC_BASE_URL está definido como https://api.oneaster.ai, e não o endereço oficial da Anthropic.

Q3: Erro “Unable to connect”?

Isso significa que o Claude Code não conseguiu se conectar ao serviço de API.

Verifique sua conexão de rede
Verifique se ANTHROPIC_BASE_URL está configurado corretamente
Se estiver usando um proxy, certifique-se de que ele permite o acesso a api.oneaster.ai

Q4: Erro “Auth conflict”?

Se você vir uma mensagem como:

Auth conflict: Both a token (claude.ai) and an API key (ANTHROPIC_API_KEY) are set.

Isso significa que você está logado no claude.ai e tem uma chave de API definida ao mesmo tempo, causando um conflito. Solução: Execute /logout no modo interativo do Claude Code para sair do claude.ai, mantendo apenas a configuração da chave de API.

Q5: Erro max_tokens ao usar modelos não-Claude?

Se você vir um erro como:

max_tokens is too large: 32000. This model supports at most 16384 completion tokens.

Isso ocorre porque o Claude Code envia requisições com parâmetros do modelo Claude por padrão (32000 tokens), enquanto alguns modelos não-Claude (por exemplo, gpt-4o) têm limites de tokens mais baixos. Solução: Mude para um modelo Claude (por exemplo, claude-sonnet-4-6), que é nativamente compatível com o Claude Code e não causará esse problema.

Q6: Resposta lenta?

Mude para um modelo mais rápido (por exemplo, claude-haiku-4-5-20251001 ou claude-sonnet-4-6)
Encurte seus prompts para reduzir o comprimento do contexto
Verifique as condições da sua rede

Q7: Como trocar de modelo?

Duas maneiras:

No modo interativo: Digite o comando /model
Edite a configuração: Altere o campo ANTHROPIC_MODEL em settings.json ou nas variáveis de ambiente e reinicie o Claude Code

Q8: O Claude Code lê arquivos locais automaticamente?

Não. O Claude Code requer que você faça referência aos arquivos explicitamente e pedirá confirmação antes de realizar operações sensíveis. É recomendável usá-lo em diretórios de projeto dedicados.

Q9: Como analisar arquivos locais com o Claude Code?

No modo interativo, você pode fazer referência a arquivos:

Digitando o caminho do arquivo diretamente
Arrastando arquivos para a janela do terminal
Copiando e colando o conteúdo do arquivo

Q10: Como verificar o uso e os custos?

Acesse o Console do OneAster para visualizar:

Estatísticas de chamadas de API
Detalhes de consumo de tokens
Estatísticas e tendências de custos

Suporte

Se você encontrar algum problema:

Comece a usar o OneAster

Cadastre-se no OneAster agora, obtenha sua chave de API e experimente o assistente de programação multimodelo no Claude Code!

​Pré-requisitos

​Etapa 1: Instalar o Claude Code

​Verificar a instalação

​Etapa 2: Configurar a API do OneAster

​Método 1: Editar settings.json (recomendado)

​Método 2: Variáveis de ambiente permanentes

​Método 3: Variáveis de ambiente temporárias

​Etapa 3: Começar a usar

​Verificar a configuração

​Modos de uso

​Modelos suportados

​Comandos comuns

​FAQ

​Q1: Ainda vejo a página de seleção de login após a configuração?

​Q2: Recebendo erros 401 / 403?

​Q3: Erro “Unable to connect”?

​Q4: Erro “Auth conflict”?

​Q5: Erro max_tokens ao usar modelos não-Claude?

​Q6: Resposta lenta?

​Q7: Como trocar de modelo?

​Q8: O Claude Code lê arquivos locais automaticamente?

​Q9: Como analisar arquivos locais com o Claude Code?

​Q10: Como verificar o uso e os custos?

​Suporte

Comece a usar o OneAster

Pré-requisitos

Etapa 1: Instalar o Claude Code

Verificar a instalação

Etapa 2: Configurar a API do OneAster

Método 1: Editar settings.json (recomendado)

Método 2: Variáveis de ambiente permanentes

Método 3: Variáveis de ambiente temporárias

Etapa 3: Começar a usar

Verificar a configuração

Modos de uso

Modelos suportados

Comandos comuns

FAQ

Q1: Ainda vejo a página de seleção de login após a configuração?

Q2: Recebendo erros 401 / 403?

Q3: Erro “Unable to connect”?

Q4: Erro “Auth conflict”?

Q5: Erro max_tokens ao usar modelos não-Claude?

Q6: Resposta lenta?

Q7: Como trocar de modelo?

Q8: O Claude Code lê arquivos locais automaticamente?

Q9: Como analisar arquivos locais com o Claude Code?

Q10: Como verificar o uso e os custos?

Suporte