claude-proxy

claude-proxy is published on npm as @sunflower0305/claude-proxy. It is a lightweight Express proxy that lets Claude Code or the Claude Agent SDK talk to domestic Chinese LLM providers through Anthropic-compatible /v1/messages endpoints.

It currently supports qwen, deepseek, glm, minimax, kimi, and mimo.

Introduction Blog：

• https://blog.zhangleyang.com/2026-06-18-c-yi-g
• https://blog.zhangleyang.com/2026-06-24-7nknko

Install

Requires Node.js 20.12 or newer.

Run without installing:

npx @sunflower0305/claude-proxy

Or install globally:

npm install -g @sunflower0305/claude-proxy
claude-proxy

Configure

The proxy reads configuration from environment variables. You can export them in your shell or create a .env file in the directory where you run claude-proxy; .env loading uses Node.js built-in .env file support.

Example .env:

PROVIDER=deepseek
PROXY_PORT=8080
# Optional: require clients to send this token to write endpoints.
# PROXY_API_KEY=your-local-proxy-token
DEEPSEEK_API_KEY=your-deepseek-api-key
DEEPSEEK_MODEL=deepseek-v4-pro

Available variables:

Variable	Purpose
PROVIDER	Active provider. Defaults to deepseek.
PROXY_PORT	Local server port. Defaults to 8080.
PROXY_API_KEY	Optional local proxy token for POST /v1/messages and POST /api/provider.
CLAUDE_PROXY_LOG	Enable local request/response capture logging. Disabled by default.
CLAUDE_PROXY_LOG_DIR	Capture directory. Defaults to .claude-proxy/sessions.
CLAUDE_PROXY_REDACT	Redact authorization and API key headers. Enabled by default.
QWEN_API_KEY	API key for Qwen.
DEEPSEEK_API_KEY	API key for DeepSeek.
GLM_API_KEY	API key for GLM.
MINIMAX_API_KEY	API key for MiniMax.
KIMI_API_KEY	API key for Kimi.
MIMO_API_KEY	API key for MIMO.
QWEN_ANTHROPIC_BASE_URL, DEEPSEEK_ANTHROPIC_BASE_URL, GLM_ANTHROPIC_BASE_URL, MINIMAX_ANTHROPIC_BASE_URL, KIMI_ANTHROPIC_BASE_URL, MIMO_ANTHROPIC_BASE_URL	Override the upstream Anthropic-compatible base URL for a provider.
QWEN_MODEL, DEEPSEEK_MODEL, GLM_MODEL, MINIMAX_MODEL, KIMI_MODEL, MIMO_MODEL	Override the default upstream model for a provider.

Provider defaults:

Provider	Model env	Default model
deepseek (default)	DEEPSEEK_MODEL	deepseek-v4-pro
qwen	QWEN_MODEL	qwen3.7-plus
glm	GLM_MODEL	glm-5.2
minimax	MINIMAX_MODEL	minimax-m3
kimi	KIMI_MODEL	kimi-k2.7-code
mimo	MIMO_MODEL	mimo-v2.5-pro

Local Capture Logging

Capture logging is disabled by default. Enable it only for local debugging in a trusted environment:

CLAUDE_PROXY_LOG=1
CLAUDE_PROXY_LOG_DIR=.claude-proxy/sessions
CLAUDE_PROXY_REDACT=1

Each completed, failed, or client-aborted POST /v1/messages request is written as one JSON file. With redaction enabled, Authorization and x-api-key headers are replaced with [REDACTED].

Capture files still contain complete request and response bodies. Prompts, messages, tool inputs and outputs, metadata, generated content, and other sensitive payload data are not redacted. The capture store currently has no body-size limit, file rotation, or retention policy, so long-running streams and repeated requests can consume memory and disk space. Use this feature only for short-lived debugging, protect the capture directory, and remove captures when they are no longer needed.

You can use the bundled example as a starting point:

cp node_modules/@sunflower0305/claude-proxy/.env.example .env

If you installed globally, create .env manually or export the variables in your shell before starting the proxy.

Start The Proxy

claude-proxy

When the server starts, it listens on http://localhost:8080 by default.

Point Claude Code or the Claude Agent SDK at the proxy:

export ANTHROPIC_BASE_URL=http://localhost:8080
export ANTHROPIC_API_KEY=any-string-works

If you set PROXY_API_KEY, set the client ANTHROPIC_API_KEY to the same value. The proxy accepts it through either x-api-key or Authorization: Bearer. If PROXY_API_KEY is not set, the local proxy does not validate the client API key and any non-empty string can be used.

Example SDK usage:

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "http://localhost:8080",
  apiKey: process.env.PROXY_API_KEY || "any-string",
});

Runtime Endpoints

Method	Path	Description
POST	/v1/messages	Main Anthropic Messages API proxy endpoint
GET	/v1/models	Lists supported Claude-facing model ids
GET	/health	Health check
GET / POST	/api/provider	Read or switch the active provider

Health check:

curl http://localhost:8080/health

Switch provider at runtime:

curl -X POST http://localhost:8080/api/provider \
  -H "Content-Type: application/json" \
  -d '{"provider":"qwen"}'

Library Usage

The package also keeps the programmatic Express entrypoint:

import { createApp } from "@sunflower0305/claude-proxy";

const app = createApp();
app.listen(8080);

Development

From source:

npm install
npm run dev

Changelog

See CHANGELOG.md and GitHub Releases for release notes.

License

MIT