Documentação

Começando

Assine um plano em Preços.
No painel, gere uma chave. Ela começa com astro_ e aparece uma única vez: copie e guarde num lugar seguro.
Configure o seu CLI com os comandos abaixo, trocando astro_sua_chave pela chave gerada.

Você precisa do Node.js 18 ou mais novo para instalar o Claude Code. Os comandos são para macOS e Linux; no Windows, use o WSL.

Claude Code

bash

$ npm install -g @anthropic-ai/claude-code
$ export ANTHROPIC_BASE_URL="https://api.astrocli.com.br"
$ export ANTHROPIC_AUTH_TOKEN="astro_sua_chave"
$ claude

O ANTHROPIC_BASE_URL faz o Claude Code falar com o Astro em vez de falar direto com a Anthropic, e o ANTHROPIC_AUTH_TOKEN é a sua chave Astro.

Para não precisar repetir a cada terminal

Coloque as duas linhas export no fim do ~/.zshrc ou do ~/.bashrc. Outra opção é colocar no ~/.claude/settings.json:

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.astrocli.com.br",
    "ANTHROPIC_AUTH_TOKEN": "astro_sua_chave"
  }
}

Se você tiver a variável ANTHROPIC_API_KEY definida de outro uso, remova ou deixe vazia. Ela tem prioridade e faria o Claude Code ignorar a chave Astro.

Modelos

O Astro aceita os modelos Claude, da Anthropic. Você usa os mesmos nomes de sempre, como claude-sonnet-5-5, e o modelo que você pede é o modelo que responde: nunca trocamos por outro sem avisar.

Família	Use com	Exemplos de nome
Claude (Fable, Opus, Sonnet, Haiku)	Claude Code	`claude-fable-5-1`, `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-haiku-5-5`

Os dois planos dão acesso a todos os modelos da tabela. Modelos de outras empresas são recusados.

Limites

Os planos são de uso ilimitado durante o período pago, sem franquia de tokens e sem teto por hora. Existe só uma proteção leve contra abuso, bem acima do uso normal, por conta (somando todas as suas chaves):

Até 120 chamadas por minuto.
Até 12 chamadas simultâneas. Uma sessão do Claude Code costuma fazer de 1 a 3 chamadas ao mesmo tempo.

Quando você passa disso, a chamada espera numa fila curta em vez de falhar. Só se a espera passar de 60 segundos ela volta com erro 429, e o CLI tenta de novo sozinho.

Erros comuns

Código	O que significa	O que fazer
401	Chave ausente, errada ou revogada.	Confira a variável de ambiente ou gere uma chave nova no painel.
403	Assinatura inativa, pagamento pendente ou modelo fora do plano.	A mensagem do erro diz qual dos casos. Veja o painel.
400	Modelo não aceito ou requisição mal formada.	Use um modelo Claude no Claude Code.
429	Muitas chamadas ao mesmo tempo ou por minuto, acima da proteção contra abuso.	O CLI tenta de novo sozinho. Se for frequente, feche sessões paralelas ou espere alguns minutos.
502, 503, 529	O provedor do modelo ou o Astro está instável.	Tente de novo em alguns segundos.

Segurança das chaves

Guardamos só um hash da chave. Se você perder a chave, gere outra; não temos como mostrar a antiga.
Use uma chave por máquina. Assim, se um computador for perdido, você revoga só aquela.
Nunca coloque a chave em repositórios, prints ou mensagens. Se vazar, revogue no painel na hora.
As chaves são pessoais. Compartilhar a conta com outras pessoas viola os termos de uso.

Privacidade

O Astro não guarda o conteúdo dos seus prompts nem das respostas. Para cada chamada registramos só o modelo, a quantidade de tokens, o custo e o horário, que é o que aparece no seu painel. O conteúdo passa pelos nossos fornecedores de acesso aos modelos e pelo provedor do modelo para gerar a resposta, sujeito às políticas deles. Detalhes na política de privacidade.