Agent skill

Anthropic Sub Proxy

by John-Rood in John-Rood/claude-proxy

Troubleshoot and configure the Anthropic Subscription Proxy for OpenClaw.

No licenceAuto-check: notesBackend & APIs

Install Anthropic Sub Proxy

skills CLI
$ npx skills add John-Rood/claude-proxy --skill anthropic-sub-proxy -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install John-Rood/claude-proxy anthropic-sub-proxy --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/John-Rood/claude-proxy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/anthropic-sub-proxy .claude/skills/anthropic-sub-proxy && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
anthropic-sub-proxy
GitHub stars
112
Token cost
~3.1k tokens
SKILL.md length
978 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

Troubleshoot and configure the Anthropic Subscription Proxy for OpenClaw.

  • Works in 6 steps: Is the proxy running? → Is OpenClaw actually hitting the proxy? → Is the baseUrl override being respected? → …
  • The user has The AI service returned an error
  • SKILL.md covers How It Works, Critical: How Keys Actually Work, Diagnostic Checklist and Quick Validation Test, plus 3 more sections
  • Calls curl, node and python3; reaches api.anthropic.com and apple.com; needs ANTHROPIC_API_KEY

What it does

Anthropic Sub Proxy is an agent skill from John-Rood/claude-proxy. Troubleshoot and configure the Anthropic Subscription Proxy for OpenClaw. Use when the user has "The AI service returned an error", 401 auth failures through the proxy, key routing issues, pi-ai baseUrl overwrites, or needs help setting up the Claude Code proxy with OpenClaw. Also use when the proxy is not receiving requests, or requests bypass the proxy entirely.

Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs. The repository describes itself as: Lightweight proxy that routes Anthropic API billing through Claude Code subscriptions. Zero dependencies, ~150 lines.

When your agent uses it

  • The user has The AI service returned an error
  • 401 auth failures through the proxy
  • Key routing issues
  • Pi-ai baseUrl overwrites

Example prompts

  • “The AI service returned an error”
  • “/anthropic-sub-proxy”

Requirements

  • Python 3
  • Node.js
  • A credential in ANTHROPIC_API_KEY

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Is the proxy running?
  2. Is OpenClaw actually hitting the proxy?
  3. Is the baseUrl override being respected?
  4. Auth token issues (401 errors)
  5. Proxy returns 502 (upstream error)
  6. Proxy works but response is wrong/truncated

What it can do on your machine

Read from SKILL.md and the folder at commit e72c0ab. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • node
    • python3
    • claude

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.anthropic.com
    • apple.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ANTHROPIC_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Anthropic Sub Proxy loads about 3.1k tokens when it runs. Until then it costs about 97 tokens; SKILL.md has 978 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~3.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:321
    - ❌ `~/.openclaw/.env` with `ANTHROPIC_API_KEY` — auth-profiles.json takes priority

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 978 words (~3,097 tokens).

“The proxy is a lightweight Node.js server (~150 lines, zero dependencies) that sits between OpenClaw and api.anthropic.com. It adds the Claude Code envelope (beta header + system prompt) to requests so Claude Code subscription billing applies instead of direct API…”

— opening of SKILL.md by John-Rood
name
anthropic-sub-proxy

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/anthropic-sub-proxy of John-Rood/claude-proxy.

Open the folder on GitHubat commit e72c0ab

Compare with similar skills

Anthropic Sub Proxy next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Anthropic Sub Proxy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Anthropic Sub Proxy this skillJohn-Rood/claude-proxy112—~3.1kAutomated safety check: NotesNone
Configuring Horizoncoollabsio/coolify63k4 repos~898Automated safety check: PassMIT
Nestjs Best Practicesrolling-scopes/rsschool-app10k6 repos~1.2kAutomated safety check: PassMIT
Sub2API AdminWei-Shaw/sub2api44k1 repos~717Automated safety check: PassLGPL-3.0
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0

Similar skills

  • Configuring Horizon

    coollabsio/coolify

    A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.

    63k GitHub starsUsed in 4 repos~898 tokens
    Backend & APIsAuto-check passed
  • Nestjs Best Practices

    rolling-scopes/rsschool-app

    NestJS best practices and architecture patterns for building production-ready applications.

    10k GitHub starsUsed in 6 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Sub2API Admin

    Wei-Shaw/sub2api

    Manages a Sub2API deployment from the command line: accounts, redeem and invitation codes, groups, proxies, imports, exports and raw admin API calls.

    44k GitHub starsUsed in 1 repo~717 tokens
    Backend & APIsAuto-check passed
  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes
  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed

Categories

Questions about Anthropic Sub Proxy

What does Anthropic Sub Proxy do?

Troubleshoot and configure the Anthropic Subscription Proxy for OpenClaw. Anthropic Sub Proxy is an agent skill from John-Rood/claude-proxy. Troubleshoot and configure the Anthropic Subscription Proxy for OpenClaw.

When should I use Anthropic Sub Proxy?

Anthropic Sub Proxy fits situations like: the user has The AI service returned an error; 401 auth failures through the proxy; key routing issues; pi-ai baseUrl overwrites.

How do I install Anthropic Sub Proxy in Claude Code?

Run `npx skills add John-Rood/claude-proxy --skill anthropic-sub-proxy -a claude-code`. Or copy the skill folder (skills/anthropic-sub-proxy in John-Rood/claude-proxy) into .claude/skills/anthropic-sub-proxy in your project. Claude Code loads it when a task matches its description.

How do I install Anthropic Sub Proxy in Codex?

Run `npx skills add John-Rood/claude-proxy --skill anthropic-sub-proxy -a codex`. Or copy the skill folder (skills/anthropic-sub-proxy in John-Rood/claude-proxy) into .agents/skills/anthropic-sub-proxy in your project. Codex loads it when a task matches its description.

Can I use Anthropic Sub Proxy in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add John-Rood/claude-proxy --skill anthropic-sub-proxy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/anthropic-sub-proxy, .gemini/skills/anthropic-sub-proxy, .github/skills/anthropic-sub-proxy and .opencode/skills/anthropic-sub-proxy in your project.

What does Anthropic Sub Proxy need to run?

Going by SKILL.md and its folder, Anthropic Sub Proxy needs the command-line tools its instructions call (curl, node, python3 and claude) and credentials named ANTHROPIC_API_KEY. Our summary lists: Python 3; Node.js; A credential in ANTHROPIC_API_KEY.

Does Anthropic Sub Proxy access the network?

SKILL.md names 2 domains. In commands or code: api.anthropic.com and apple.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Anthropic Sub Proxy safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Anthropic Sub Proxy use?

No licence was found for Anthropic Sub Proxy or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Anthropic Sub Proxy use?

About 3.1k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Anthropic Sub Proxy?

Skills that share tags, products or a category with Anthropic Sub Proxy: Configuring Horizon (coollabsio/coolify, 63k stars), Nestjs Best Practices (rolling-scopes/rsschool-app, 10k stars), Sub2API Admin (Wei-Shaw/sub2api, 44k stars) and Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Anthropic Sub Proxy?

John-Rood (a GitHub user) maintains it in John-Rood/claude-proxy, which has 112 GitHub stars. The repository was last updated on April 11, 2026.

Source: John-Rood/claude-proxy on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.