A lightweight proxy that translates Anthropic API calls to v0's OpenAI-compatible API format. Run Claude Code with v0 models.
npx v0-proxy --api-key YOUR_V0_API_KEYThat's it — Claude Code launches automatically, connected to v0's API.
Claude Code → Anthropic API format → v0-proxy → OpenAI API format → v0 API
Claude Code sends requests in Anthropic's format. v0-proxy translates them to OpenAI's format on the fly, forwards them to v0's API, and translates the responses back. Streaming, tool calls, and reasoning all work transparently.
# Run directly (no install needed)
npx v0-proxy --api-key YOUR_V0_API_KEY
# Or install globally
npm install -g v0-proxy
v0-proxy --api-key YOUR_V0_API_KEY- Claude Code installed and on your PATH
- A v0 API key
export V0_API_KEY=your-v0-api-key
v0-proxy| Flag | Default | Description |
|---|---|---|
-k, --api-key <key> |
V0_API_KEY env var |
v0 API key |
-p, --port <port> |
3000 |
Proxy server port |
--base-url <url> |
https://api.v0.dev |
v0 API base URL |
--model <model> |
v0-1.5-lg |
Primary model |
--small-model <model> |
v0-1.5-md |
Fast model for simple tasks |
--debug |
false |
Enable debug logging |
# Use a different port
v0-proxy --api-key YOUR_KEY --port 8080
# Use a specific model
v0-proxy --api-key YOUR_KEY --model v0-1.5-lg
# Debug mode — see all request/response payloads
v0-proxy --api-key YOUR_KEY --debug| Feature | Status |
|---|---|
| Text messages | Supported |
| Streaming responses | Supported |
| Tool calls | Supported |
| Reasoning/thinking | Supported |
| System messages | Supported |
| Non-streaming responses | Supported |
| Technology | Purpose |
|---|---|
| Node.js | Runtime |
| Fastify | HTTP server |
| Commander | CLI interface |
git clone https://github.com/stevederico/v0-proxy
cd v0-proxy
npm install
node index.js --api-key YOUR_KEY --debugAdapted from grok-cli and anthropic-proxy.
MIT License — see LICENSE for details.
Built by Steve Derico
Star on GitHub — it helps!
