dsv4-cc-proxy 1.8.0

DeepSeek Anthropic API 兼容性代理 — 让 Claude Code 在 DeepSeek V4 模型上稳定运行

中文版 README

dsv4-cc-proxy

Make DeepSeek V4 work flawlessly with Claude Code

Anthropic API compatibility proxy that fixes 3 DeepSeek V4 incompatibilities.

Claude Code ←→ localhost:16889 (dsv4-cc-proxy) ←→ api.deepseek.com/anthropic

---

Why dsv4-cc-proxy

DeepSeek V4 implements the Anthropic API format, but has 3 critical incompatibilities that break Claude Code. This proxy fixes them transparently.

#	Problem	Symptom	Fix
1	tool_use assistant messages missing a thinking block	reasoning_content 400 error	Inject empty thinking block before each tool_use
2	DeepSeek unconditionally emits thinking/signature_delta SSE events even when thinking is disabled	Tool result missing due to internal error in Claude Code	Strip thinking events from the SSE response stream
3	thinking.type=adaptive (Claude Code default) + reasoning_effort not supported by DeepSeek	Stream truncation / 400 errors	Normalize to disabled + strip reasoning_effort

Non-DeepSeek requests and non-/messages endpoints pass through with zero overhead.

Quick Start

Option 1: pip install (recommended)

pip install dsv4-cc-proxy

# Start the proxy (default port 16889)
dsv4-cc-proxy

# Stop the proxy
dsv4-cc-proxy --stop

Option 2: pipx (isolated environment)

pipx install dsv4-cc-proxy
dsv4-cc-proxy

Option 3: Docker

docker run -d -p 16889:16889 --name dsv4-cc-proxy hosheali/dsv4-cc-proxy:latest

Or via docker compose:

docker compose up -d

Configuration

Point Claude Code to the proxy by adding to your settings.local.json:

"ANTHROPIC_BASE_URL": "http://localhost:16889"

Configuration

Env Var	Default	Description
PROXY_UPSTREAM	https://api.deepseek.com/anthropic	DeepSeek API base URL
PROXY_HOST	127.0.0.1	Bind address
PROXY_PORT	16889	Bind port
PROXY_LOG_LEVEL	warning	Log level (info for debugging)
PROXY_DUMP_DIR	(empty=off)	Debug traffic dump directory. ⚠ Contains conversation data

Comparison

Scenario	Without Proxy	With Proxy
tool_use msg without thinking	400 error	Auto-injected empty thinking
Claude Code sends thinking.type=adaptive	Stream truncation / 400	Normalized to disabled
DeepSeek SSE thinking events	Tool result missing error	Silently stripped from stream
Non-messages endpoints	—	Zero-overhead passthrough
Non-DeepSeek models	—	Zero-overhead passthrough

Platform Guides

macOS (launchd auto-start)

# Copy and edit paths in the plist file first!
cp scripts/com.deepseek.thinking-proxy.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.deepseek.thinking-proxy.plist

Note: Edit the plist file to update paths like /Users/yourname/.claude/proxy/ to match your setup.

Windows (Scheduled Task)

:: One-time setup (auto-start at logon, restart on crash)
scripts\install_windows_service.ps1 -Install

:: Start manually in terminal
scripts\start.bat

:: Or with PowerShell
scripts\start.ps1

Linux (systemd)

Create /etc/systemd/system/dsv4-cc-proxy.service:

[Unit]
Description=dsv4-cc-proxy — DeepSeek Anthropic API proxy
After=network.target

[Service]
Type=simple
User=your-user
WorkingDirectory=/path/to/dsv4-cc-proxy
ExecStart=/path/to/.venv/bin/python3 proxy/deepseek-thinking-proxy.py
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now dsv4-cc-proxy

Docker (manual build)

docker build -t dsv4-cc-proxy .
docker run -d -p 16889:16889 --name dsv4-cc-proxy dsv4-cc-proxy

How It Works

┌─────────────┐     ┌──────────────────┐     ┌────────────────────┐
│ Claude Code │ ──→ │  dsv4-cc-proxy   │ ──→ │  api.deepseek.com  │
│             │     │  localhost:16889  │     │  /anthropic        │
└─────────────┘     └──────────────────┘     └────────────────────┘
                           │
                   ┌───────┴────────┐
                   │  Fixes applied  │
                   │  1. Thinking     │
                   │     injection   │
                   │  2. Thinking     │
                   │     normalize   │
                   │  3. SSE events   │
                   │     strip       │
                   └────────────────┘

The proxy intercepts POST /v1/messages and applies three fixes for deepseek-v4* models. All other requests pass through transparently.

Testing

pip install dsv4-cc-proxy[test]
pytest tests/ -v

Health Check

curl http://localhost:16889/health
# → {"status":"ok","version":"1.8.0","upstream":"https://api.deepseek.com/anthropic"}

Project Structure

.
├── dsv4_cc_proxy/
│   ├── __init__.py                  # Package entry, exports VERSION + create_app
│   ├── __main__.py                  # CLI entry — dsv4-cc-proxy command
│   ├── _version.py                  # VERSION = "1.8.0" (single source of truth)
│   └── proxy.py                     # Core proxy logic (factory pattern)
├── tests/
│   └── test_proxy.py                # 22 unit tests
├── scripts/
│   ├── start.bat                    # Windows batch startup
│   ├── start.ps1                    # PowerShell startup
│   ├── install_windows_service.ps1  # Windows Task Scheduler setup
│   └── com.deepseek.thinking-proxy.plist  # macOS launchd (optional)
├── Dockerfile                       # Docker multi-stage build
├── docker-compose.yml               # Docker Compose
├── pyproject.toml                   # Build config, entry point
├── MANIFEST.in                      # Package extras
├── .github/workflows/ci.yml         # GitHub Actions CI
├── LICENSE                          # MIT License
└── CONTRIBUTING.md                  # Contributor guidelines

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

License

MIT