kristianvast/hermes-claude-auth
211 stars · Last commit 2026-05-06
Claude Code OAuth bypass for hermes-agent
README preview
# hermes-claude-auth Claude Code OAuth bypass for hermes-agent, use your Claude Code subscription (Max/Pro) with Hermes. ## What this does Patches hermes-agent at runtime to pass Anthropic's server-side OAuth content validation. It does not modify hermes-agent source files. Installation happens through a Python import hook that monkey-patches `build_anthropic_kwargs` on startup. ## Why this exists On 2026-04-04, Anthropic added server-side validation that rejects OAuth requests from third-party tools. This patch adds the billing header signature and system prompt structure the API expects. ## Prerequisites - hermes-agent installed (`~/.hermes/hermes-agent/`) - Claude Code CLI authenticated (valid credentials at `~/.claude/.credentials.json`) - hermes-agent configured for OAuth (`credential_pool` has a `claude_code` entry in `~/.hermes/auth.json`) - Python 3.11+ ## Install ```bash curl -fsSL https://raw.githubusercontent.com/kristianvast/hermes-claude-auth/main/install-remote.sh | bash ```