DeepSeek Proxy para Claude Code
fakefishtoucher/Deepseek-Proxy
Proxy local que compatibiliza Claude Code com DeepSeek API
Ver no GitHubProxy HTTP local sem dependências que resolve conflitos de compatibilidade entre Claude Code e DeepSeek API, corrigindo automaticamente requisições com parâmetros incompatíveis (thinking=disabled + effort). Funciona como intermediário entre Claude Code e DeepSeek, incluindo watchdog para failover automático.
Instalação
npx convez-ai fakefishtoucher/Deepseek-Proxy1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Usar DeepSeek como backend de Claude Code sem erros 400
- Executar agentes e sub-agentes Claude Code com DeepSeek
- Monitorar e recuperar automaticamente falhas do proxy
Veredito

Solução técnica prática para um problema real de incompatibilidade entre APIs. Implementação limpa em Python puro com gerenciamento de processos e failover automático, mas demanda conhecimento em linha de comando e configuração manual de variáveis de ambiente.
README
A tradução para o português deste README ainda está na fila.
DeepSeek Proxy for Claude Code
一个零依赖的本地代理,解决 Claude Code 子代理(Agent)在使用 DeepSeek API 时的兼容性问题。
问题
Claude Code 的子代理调用会发送以下组合:
{
"thinking": { "type": "disabled" },
"output_config": { "effort": "max" }
}
DeepSeek 的 Anthropic 兼容 API 会拒绝这个组合,返回:
400: thinking options type cannot be disabled when reasoning_effort is set
导致所有子代理调用失败(包括 Agent、WebSearch、WebFetch 等工具)。
解决方案
一个运行在 127.0.0.1:3461 的本地 HTTP 代理,自动修复请求中的兼容性冲突,然后转发到 DeepSeek API。
Claude Code → localhost:3461 → api.deepseek.com/anthropic
│
├─ thinking=disabled + output_config.effort → 剥离 effort
└─ 其他请求 → 原封转发
前置环境
| 依赖 | 说明 |
|---|---|
| Python 3.6+ | 仅使用标准库,零 pip 依赖 |
| DeepSeek API Key | 或其他兼容 Anthropic Messages API 的端点 |
| Linux / macOS | 进程管理使用了 POSIX 信号 (Windows 待适配) |
安装
# 1. 复制文件到 PATH
cp deepseek-proxy ~/.local/bin/
chmod +x ~/.local/bin/deepseek-proxy
cp deepseek_proxy.py ~/
# 2. (可选)设置 WSL/代理环境变量,如果机器无法直连外网
# export https_proxy=http://<你的代理IP>:<端口>
快速开始
# 启动代理
deepseek-proxy start
# 启动看门狗(自动故障切换)
deepseek-proxy watch
# 切到代理模式
deepseek-proxy enable
然后在 Claude Code 的 ~/.claude/settings.json 中设置:
{
"env": {
"ANTHROPIC_BASE_URL": "http://127.0.0.1:3461"
}
}
注意:
deepseek-proxy enable命令会自动修改 settings.json。如果不想自动修改,手动设置ANTHROPIC_BASE_URL即可。
WSL 自启动
在 ~/.bashrc 末尾添加:
if command -v deepseek-proxy &> /dev/null; then
deepseek-proxy start 2>/dev/null
deepseek-proxy watch 2>/dev/null
fi
命令参考
deepseek-proxy {start|stop|status|enable|disable|watch|log}
start 启动代理守护进程
stop 停止代理
status 检查代理状态(进程、健康检查、看门狗、BASE_URL)
enable 将 Claude Code 指向代理 (修改 settings.json)
disable 将 Claude Code 切回直连 (修改 settings.json)
watch 启动看门狗(后台监控 + 故障自动切换)
log 查看代理运行日志
自定义端口
deepseek-proxy --port 8080 start
deepseek-proxy --port 8080 watch
看门狗机制
看门狗是一个独立的后台守护进程,每 10 秒检测代理健康状态:
代理进程消失 → 切直连 + 自动重启代理
进程在但 /health 不通 → 只切直连(上游可能挂了)
恢复正常 50 秒 → 自动切回代理模式
这确保即使代理挂掉,Claude Code 也不会断连——看门狗会自动将 BASE_URL 切到直连,保证主会话不受影响。
架构
┌──────────────┐ HTTP ┌─────────────────┐ HTTPS ┌──────────────┐
│ Claude Code │ ──────────→ │ deepseek_proxy │ ──────────→ │ DeepSeek API │
│ │ ←────────── │ (127.0.0.1:3461) │ ←────────── │ │
└──────────────┘ └────────┬────────┘ └──────────────┘
│
│ PID + /health
▼
┌─────────────────┐
│ 看门狗 │
│ (watchdog) │
│ 10s 间隔检测 │
│ 故障自动切直连 │
│ 恢复自动切代理 │
└────────┬────────┘
│ 修改
▼
┌─────────────────┐
│ settings.json │
│ BASE_URL 切换 │
└─────────────────┘
适用场景
- 使用 DeepSeek API 作为 Claude Code 后端的用户
- 使用其他 Anthropic 兼容 API(非官方 Anthropic)遇到 thinking/effort 冲突的用户
- 任何需要轻量级 API 请求修复代理的场景
故障排查
# 查看运行状态
deepseek-proxy status
# 查看代理日志
deepseek-proxy log
# 紧急切回直连
deepseek-proxy disable
# 手动重启
deepseek-proxy stop
deepseek-proxy start
deepseek-proxy enable
License
MIT