convez.ai
AgenteIntegração & APIsIntermediário
fakefishtoucher

DeepSeek Proxy para Claude Code

fakefishtoucher/Deepseek-Proxy

Proxy local que compatibiliza Claude Code com DeepSeek API

Ver no GitHub
InicialPluginScore · de 0 a 100

Proxy 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-Proxy

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

Ver o original no GitHub

Bom para

Relacionados