Anthropic OAuth Token
Use sua subscription Claude Max no QuickClaw sem gastar créditos de API.
O que é o OAuth Token?
O OAuth Token da Anthropic (sk-ant-oat01-...) permite que o QuickClaw autentique usando sua conta Anthropic pessoal, em vez de uma API key paga por token. Com ele, o consumo do seu agente é debitado do rate limit da sua subscription Claude Max, não dos créditos de API.
É diferente da API key (sk-ant-api03-...): a API key cobra por token usado; o OAuth Token aproveita o plano mensal que você já paga no Claude.ai.
Apenas para plano Flex (BYOK)
O OAuth Token só está disponível para bots no plano Flex. Bots nos planos Starter e Pro usam os créditos do QuickClaw e não precisam de chaves próprias.
Quando usar?
Use o OAuth Token se você:
- Já assina o Claude Max (plano Pro ou Max no Claude.ai)
- Quer aproveitar o rate limit da subscription em vez de pagar por token
- Tem um agente de uso moderado que não precisa de prompt caching
Prefira a API Key tradicional se você:
- Não tem subscription Claude Max ativa
- Precisa de prompt caching (economia para conversas longas)
- Tem um agente de alto volume que pode atingir o rate limit pessoal
Aviso importante (política Anthropic)
Restrição atual da Anthropic
Desde agosto de 2025, a Anthropic restringiu o uso de OAuth por clientes de terceiros (fora do Claude Code CLI oficial). Requests podem retornar 401 com a mensagem"OAuth authentication is currently not supported."
A implementação do QuickClaw está tecnicamente correta e pronta para voltar a funcionar assim que a Anthropic remover a restrição (ou quando houver solução alternativa). Enquanto isso, recomendamos configurar também uma API Key tradicional como proteção.
Modelos compatíveis
O OAuth Token funciona com todos os modelos Anthropic disponíveis no catálogo do QuickClaw. Modelos mais recentes (família 4.6) requerem um ajuste automático aplicado pelo pi-ai.
| Modelo | Compatível | Observação |
|---|---|---|
claude-opus-4-6 | ✅ Sim | System prompt injetado automaticamente |
claude-sonnet-4-6 | ✅ Sim | System prompt injetado automaticamente |
claude-sonnet-4-5 | ✅ Sim | Funciona diretamente |
claude-haiku-4-5 | ✅ Sim | Funciona diretamente |
Limitações importantes
Leia antes de configurar
- Rate limit pessoal: O agente compartilha o rate limit da sua conta Claude Max. Se você usar muito o Claude.ai ao mesmo tempo que o agente, pode atingir o limite.
- Sem prompt caching: O OAuth Token não suporta cache de prompt. Conversas longas consomem mais tokens a cada mensagem em comparação com a API key.
- Expiração curta (access token ~1h): O access_token é renovado automaticamente pelo QuickClaw via refresh_token enquanto sua sessão for válida.
- Termos de Uso da Anthropic: O uso do OAuth Token fora dos clientes oficiais da Anthropic pode estar sujeito aos termos da sua subscription. Use com responsabilidade.
Método A — Login nativo (recomendado)
A forma mais simples. Não requer instalar nada — você autoriza direto no browser em 3 cliques. Esse método usa o mesmo fluxo PKCE do Claude Code CLI oficial, mas entirely pelo dashboard do QuickClaw.
Abra as configurações do agente
No dashboard do QuickClaw:
- Abra o agente desejado
- Vá na aba Configurações → seção Chaves Principais
- Clique em Adicionar OAuth
- Selecione o provider Anthropic (card roxo)
Clique em "Conectar com Anthropic"
O QuickClaw vai abrir uma nova aba com a página de autorização da Anthropic (claude.ai/oauth/authorize).
Faça login com sua conta Claude Pro/Max (a mesma da sua subscription) e autorize o acesso.
Copie o código de autorização
Após autorizar, a Anthropic redireciona para uma página oficial (console.anthropic.com/oauth/code/callback) que exibe um código de autorização — geralmente no formato abc123xyz#state456.
Clique em Copy Code (ou selecione e copie o código inteiro).
Formato do código
O código sempre contém um # separando duas partes. Copie tudo — o QuickClaw aceita o formato completo.
Cole no QuickClaw e conecte
Volte para a aba do QuickClaw onde o modal está aberto:
- Cole o código no campo Código de autorização
- Clique em Conectar
O QuickClaw faz a troca por tokens de acesso automaticamente, salva criptografado e propaga a configuração para o container do seu agente. Sem downloads, sem arquivos.
Proteção automática
Se você já tem uma API Key Anthropic configurada, ela é mantida como proteção. Caso o OAuth falhe ou expire, o agente continua funcionando via API Key.
Método B — CLI manual (avançado)
Se preferir gerar o token via terminal (útil para ambientes corporativos com restrição de browser ou automação), você pode usar o Claude Code CLI oficial e colar o token manualmente no QuickClaw.
Quando usar este método
Use o método A (login nativo) sempre que possível — é mais rápido e não requer instalar nada. Use o método B apenas se tiver alguma restrição de browser ou necessidade de automação.
Instale o Claude Code CLI
Requer Node.js 18+ e npm. Se não tiver, instale em nodejs.org (baixe a versão LTS).
🪟 Windows (PowerShell)
npm install -g @anthropic-ai/claude-code🍎 macOS / 🐧 Linux (Terminal)
npm install -g @anthropic-ai/claude-codeErro de permissão?
Windows: Execute o PowerShell como Administrador. Mac/Linux: Use sudo npm install -g @anthropic-ai/claude-code.
Gere o token OAuth
No mesmo terminal, execute:
claude /loginUm menu aparece. Use as setas do teclado para selecionar:
❯ Get a token to use Claude outside of claude.aiPressione Enter. O CLI abre o browser para autorização. Após autorizar, o token é exibido no terminal — começa com sk-ant-oat01-.
Selecione o token completo e copie (Ctrl+C / Cmd+C).
Mantenha o token seguro
Trate o OAuth Token como uma senha. Não compartilhe. O QuickClaw criptografa e nunca expõe o token.
Cole no QuickClaw
No dashboard do seu agente:
- Vá na aba Configurações → Chaves Principais
- Clique em Adicionar OAuth → selecione Anthropic
- Em vez de clicar "Conectar", role até "Ou cole token manualmente"
- Cole o token
sk-ant-oat01-...no campo - Marque o checkbox dos Termos de Uso
- Clique em Salvar
Problemas comuns
"OAuth authentication is currently not supported" (Anthropic)
Essa é a restrição política da Anthropic mencionada acima. Não há fix técnico no QuickClaw — a Anthropic precisa mudar a política. Enquanto isso, use uma API Key tradicional.
"Authorization code has already been used"
O código de autorização só pode ser usado uma vez. Se você colou duas vezes ou clicou em "Conectar" depois que já deu certo, aparece esse erro.
Solução: feche o modal e clique em "Conectar com Anthropic" de novo para gerar um código novo.
Sessão expirada
A sessão PKCE tem validade de 10 minutos. Se você demorou para colar o código, pode ter expirado.
Solução: clique em Conectar novamente para iniciar uma sessão nova.
claude /login faz login normal sem mostrar o token
Se você já tem uma sessão ativa no Claude Code CLI, o comando pode pular o menu. Force uma nova autenticação:
- Execute
claude logout - Execute
claude /loginde novo - Selecione "Get a token to use Claude outside of claude.ai"
Node.js / npm não encontrado
Se o terminal mostrar 'npm' is not recognized ou command not found: npm, instale o Node.js em nodejs.org (versão LTS), feche e reabra o terminal, depois verifique com node --version.
Como o QuickClaw usa o token
O QuickClaw armazena o access_token + refresh_token criptografados no banco. Quando o agente precisa chamar o modelo Claude:
- O Agent Manager injeta o token em
auth-profiles.jsondentro do container do agente - O pi-ai (engine do OpenClaw) lê esse arquivo e adiciona
Authorization: Bearer sk-ant-oat01-... - O pi-ai também adiciona os headers OAuth exigidos (
anthropic-beta,user-agent: claude-cli/..., etc) - A request vai direto para
api.anthropic.com— sem passar pelo proxy - Quando o access_token expira (~1h), o pi-ai usa o refresh_token para gerar novo automaticamente
- O QuickClaw sincroniza o novo refresh_token de volta ao banco via reconcile
Expiração e renovação
O access_token tem validade curta (~1 hora), mas o refresh_token é persistente e o pi-ai renova o access_token automaticamente sempre que necessário. Você geralmente não precisa fazer nada.
Quando precisa intervir:
- Você fez logout manual no Claude.ai → refresh_token é revogado
- Anthropic revoga permissões por política → precisa autorizar novamente
- Subscription Claude Max expirou → token para de funcionar
Para renovar: clique em Conectar com Anthropic novamente no dashboard — você vê a tela de autorização e aprova de novo. Funcionalmente é como se fosse a primeira vez.
Dica: mantenha uma API Key como proteção
Configure uma API Key da Anthropic além do OAuth Token. A proteção é automática e transparente — se o OAuth falhar (restrição política, expiração, revogação), o agente continua funcionando via API Key.
