omni-proxies — Claude Code skill: what it does, how to install
Configures HTTP, HTTPS and SOCKS proxies for upstream provider requests, with per-provider or global rules, connectivity checks and rotation.
npx skills add cheaper-inference/OmniRoute --skill omni-proxies -a claude-codeWhat omni-proxies does
The omni-proxies skill sets HTTP, HTTPS and SOCKS proxies for upstream provider requests inside the OmniRoute project. You can apply a proxy globally or per provider, test connectivity, and rotate proxies across multiple addresses.
Install it with npx skills add cheaper-inference/OmniRoute --skill omni-proxies -a claude-code; the skill file lands in ~/.claude/skills/omni-proxies/SKILL.md. Other platforms use the same command with a different -a flag and install path, for example .cursor/skills/omni-proxies/SKILL.md for Cursor.
Calls to the API need a Bearer token or session cookie, obtained through POST /api/auth/login, or you can set REQUIRE_API_KEY=false for local development. The specific endpoints for this area aren't mapped yet — check docs/openapi.yaml or GET /api/openapi/spec for the request and response schemas.
What it helps with
- set a proxy for requests to a specific provider
- switch between HTTP, HTTPS and SOCKS proxies
- test proxy connectivity before relying on it
- rotate proxies across multiple addresses
- restrict upstream provider traffic to one proxy
Example prompts for the agent
- Set a SOCKS proxy for requests to OpenAI
- Test whether the Anthropic proxy is reachable
- Turn on proxy rotation for all providers
How to install omni-proxies
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-proxies -a claude-code2Manually: put the files in place
~/.claude/skills/omni-proxies/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/omni-proxies/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-proxies -a codex2Manually: put the files in place
.agents/skills/omni-proxies/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-proxies -a cursor2Manually: put the files in place
.cursor/skills/omni-proxies/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cheaper-inference/OmniRoute omni-proxies2Manually: put the files in place
.github/skills/omni-proxies/SKILL.md1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-proxies -a gemini-cli2Platform CLI
gemini skills install https://github.com/cheaper-inference/OmniRoute --path skills/omni-proxiesManually: put the files in place
.devin/skills/omni-proxies/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-proxies -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set34
The whole set →Similar
Questions about omni-proxies
How do I install omni-proxies in Claude Code?
Run npx skills add cheaper-inference/OmniRoute --skill omni-proxies -a claude-code. The skill installs into ~/.claude/skills/omni-proxies/SKILL.md.
What does omni-proxies do?
It sets HTTP, HTTPS and SOCKS proxies for upstream provider requests, applies rules globally or per provider, tests connectivity, and manages proxy rotation.
What's needed to call the OmniRoute API with this skill?
Requests need a Bearer token or session cookie, obtained through POST /api/auth/login, or you can set REQUIRE_API_KEY=false for local development.
Source text
SKILL.md · MIT
--- name: omni-proxies description: Configure HTTP/HTTPS/SOCKS proxies for upstream provider requests. Set per-provider or global proxy rules, test connectivity, and manage proxy rotation. --- <!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten --> ## Overview Configure HTTP/HTTPS/SOCKS proxies for upstream provider requests. Set per-provider or global proxy rules, test connectivity, and manage proxy rotation. ## Authentication All requests require a valid Bearer token or session cookie. Obtain a token via `POST /api/auth/login` or configure `REQUIRE_API_KEY=false` for local development. ## Endpoints _No endpoints mapped for this area yet._ ## Payloads See the full OpenAPI specification at `GET /api/openapi/spec` or `docs/openapi.yaml` for detailed request/response schemas.
© cheaper-inference · MIT · cheaper-inference/OmniRoute