freebuff2api-openai-proxy — Claude Code skill: proxy setup
Set up a Freebuff proxy with an OpenAI-style API, token rotation, and Docker deployment for compatible SDKs and CLI clients.
npx skills add reason-machines/trending-skills --skill freebuff2api-openai-proxy -a claude-codeWhat freebuff2api-openai-proxy does
This skill covers a proxy that accepts OpenAI-format requests and converts them for Freebuff. It exposes /v1/chat/completions, supports streaming, rotates several auth tokens, and can send outbound traffic through an HTTP proxy. The guide shows connections from curl, Python and Node.js SDKs, plus LangChain.
Deployment examples use Docker or Docker Compose. A source build requires Go 1.23+. Configuration can live in environment variables or config.json, with options such as ROTATION_INTERVAL, REQUEST_TIMEOUT, and API_KEYS. A Freebuff auth token is required before the proxy can reach the upstream service.
What it helps with
- deploy an OpenAI-compatible Freebuff proxy
- connect Python or Node.js clients to Freebuff
- rotate several Freebuff auth tokens
- protect the proxy with
API_KEYS - route outbound traffic through an HTTP proxy
Example prompts for the agent
- Set up
freebuff2api-openai-proxyfor Claude Code with Docker andAUTH_TOKENS. - Create a
config.jsonfor token rotation and proxy access throughAPI_KEYS. - Connect the Python SDK to
http://localhost:8080/v1and enable streaming.
How to install freebuff2api-openai-proxy
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill freebuff2api-openai-proxy -a claude-code2Manually: put the files in place
~/.claude/skills/freebuff2api-openai-proxy/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/freebuff2api-openai-proxy/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill freebuff2api-openai-proxy -a codex2Manually: put the files in place
.agents/skills/freebuff2api-openai-proxy/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill freebuff2api-openai-proxy -a cursor2Manually: put the files in place
.cursor/skills/freebuff2api-openai-proxy/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills freebuff2api-openai-proxy2Manually: put the files in place
.github/skills/freebuff2api-openai-proxy/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill freebuff2api-openai-proxy -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/freebuff2api-openai-proxyManually: put the files in place
.devin/skills/freebuff2api-openai-proxy/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill freebuff2api-openai-proxy -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about freebuff2api-openai-proxy
How do I install freebuff2api-openai-proxy in Claude Code?
Run npx skills add reason-machines/trending-skills --skill freebuff2api-openai-proxy -a claude-code, then check ~/.claude/skills/freebuff2api-openai-proxy/SKILL.md.
What does freebuff2api-openai-proxy do?
It guides the setup of a proxy that accepts OpenAI-compatible requests and forwards them to Freebuff. The skill also covers Docker deployment, token rotation, and client connections.
What is required to run the proxy?
You need one or more Freebuff auth tokens. Docker can run the published image; building from source requires Go 1.23+.