atuscode

Claude Code fork que roteia todo o tráfego pelo gateway Atus (https://atus.hostclube.com/v1). Carrega o binário oficial da Anthropic como peer dependency — sem reembarar 250 MB de payload nativo.

atuscode é um wrapper que:

1. Sobe um adapter de protocolo em loopback HTTP (127.0.0.1:0) que traduz o protocolo Anthropic (/v1/messages, x-api-key, tool_use) para o protocolo OpenAI-compat do Atus (/v1/chat/completions, Authorization: Bearer, tool_calls).
2. Seta ANTHROPIC_BASE_URL=http://127.0.0.1:<porta> e ANTHROPIC_AUTH_TOKEN=<chave> no ambiente do binário nativo.
3. Mapeia modelos por tier (opus/sonnet/haiku) para IDs disponíveis no Atus — escolha via wizard de primeira execução.

Instalação

npm install -g @atuscode/cli
atuscode           # primeira execução dispara o wizard

Wizard de primeira execução

Pergunta endpoint (default https://atus.hostclube.com/v1), valida a chave com GET /v1/models, lista os modelos disponíveis e pede que você escolha três: opus, sonnet, haiku (podem ser o mesmo). Persiste em:

• ~/.config/atuscode/config.json (0644) — endpoint + aliases de modelo
• ~/.config/atuscode/credentials.json (0600) — chave Bearer

Re-rodar o wizard a qualquer momento: atuscode --wizard ou apagar ~/.config/atuscode/config.json.

Variáveis de ambiente relevantes

| Variável | Função | |---|---| | ANTHROPIC_BASE_URL | Apontado automaticamente pelo wrapper para o adapter em loopback | | ANTHROPIC_AUTH_TOKEN | Injetado a partir de credentials.json | | ANTHROPIC_DEFAULT_OPUS_MODEL / _SONNET_MODEL / _HAIKU_MODEL | Resolvidos do config.json | | ATUS_UPSTREAM_URL | Override do endpoint Atus (default https://atus.hostclube.com/v1) | | ATUS_LOG | debug habilita log de request/response em /tmp/atuscode-logs/ |

Atualizando a partir do upstream

git fetch upstream
git rebase upstream/main
# conflitos esperados só nos arquivos de rebrand (CHANGELOG, README, .claude-plugin/marketplace.json)

Segurança

• A chave nunca é logada, mesmo com ATUS_LOG=debug (redacted como ***).
• O adapter bind em 127.0.0.1 apenas — não exposto à rede.
• O arquivo de credenciais é gravado com permissão 0600.
• Nunca cole tokens em chat, issues ou PRs. Para configurar CI: npm login local ou GitHub Secrets.

Limitações conhecidas

• Beta flags não suportadas pelo Atus são descartadas silenciosamente com warning no log.
• count_tokens retorna estimativa baseada em caracteres/4 (OpenAI não expõe esse endpoint).
• messages/batches retorna 501 (Anthropic-only).

Licença

Inherit de anthropics/claude-code (proprietária, ver LICENSE).