deepclaude

使用 Claude Code 的自主智能体循环，通过 DeepSeek V4 Pro、OpenRouter 或任何兼容 Anthropic 的后端运行。体验相同，成本降低 17 倍。

功能简介

Claude Code 是目前最优秀的自主编码智能体——但其每月成本高达 200 美元且有使用限制。DeepSeek V4 Pro 在 LiveCodeBench 上得分高达 96.4%，且输出 token 价格仅为每百万 $0.87。

deepclaude 在保留原有“身体”（交互界面）的同时，更换了其“大脑”（模型）：

你的终端
  +-- Claude Code CLI (工具循环、文件编辑、bash、git - 原样保留)
        +-- API 调用 -> DeepSeek V4 Pro ($0.87/M) 代替 Anthropic ($15/M)

所有功能均可正常工作：文件读取、编辑、bash 执行、子智能体派生、自主多步编码循环。唯一的区别在于决策模型不同。

快速上手 (2 分钟)

1. 获取 DeepSeek API Key

在 platform.deepseek.com 注册账户，充值 $5 余额，并复制你的 API Key。

2. 设置环境变量

Windows (PowerShell):

setx DEEPSEEK_API_KEY "sk-your-key-here"

macOS/Linux:

echo 'export DEEPSEEK_API_KEY="sk-your-key-here"' >> ~/.bashrc
source ~/.bashrc

3. 安装

Windows:

# 将脚本复制到 PATH 中的目录
Copy-Item deepclaude.ps1 "$env:USERPROFILE\.local\bin\deepclaude.ps1"

# 或将仓库目录添加到 PATH
setx PATH "$env:PATH;C:\path\to\deepclaude"

macOS/Linux:

chmod +x deepclaude.sh
sudo ln -s "$(pwd)/deepclaude.sh" /usr/local/bin/deepclaude

4. 使用方法

deepclaude                  # 使用 DeepSeek V4 Pro 启动 Claude Code
deepclaude --status         # 查看可用后端及密钥状态
deepclaude --backend or     # 使用 OpenRouter（最便宜，输入成本 $0.44/M）
deepclaude --backend fw     # 使用 Fireworks AI（速度最快，美国服务器）
deepclaude --backend anthropic  # 使用原生 Claude Code（需要 Opus 时）
deepclaude --cost           # 查看价格对比
deepclaude --benchmark      # 测试各提供商的延迟
deepclaude --switch ds      # 在会话中途切换后端（无需重启）

工作原理

Claude Code 通过读取环境变量来决定 API 调用的目的地：

变量	作用
ANTHROPIC_BASE_URL	API 端点 (默认: api.anthropic.com)
ANTHROPIC_AUTH_TOKEN	后端 API 密钥
ANTHROPIC_DEFAULT_OPUS_MODEL	Opus 级别任务的模型名称
ANTHROPIC_DEFAULT_SONNET_MODEL	Sonnet 级别任务的模型名称
ANTHROPIC_DEFAULT_HAIKU_MODEL	Haiku 级别（子智能体）的模型名称
CLAUDE_CODE_SUBAGENT_MODEL	派生子智能体的模型

deepclaude 会在每次会话中临时设置这些变量，启动 Claude Code，并在退出后恢复你原本的设置。

支持的后端

后端	标识	输入/M	输出/M	服务器	备注
DeepSeek (默认)	--backend ds	$0.44	$0.87	中国	自动上下文缓存（重复对话时便宜 120 倍）
OpenRouter	--backend or	$0.44	$0.87	美国	最便宜，从美国/欧洲访问延迟最低
Fireworks AI	--backend fw	$1.74	$3.48	美国	推理速度最快
Anthropic	--backend anthropic	$3.00	$15.00	美国	原版 Claude Opus（处理困难问题时使用）

各后端设置

DeepSeek (默认 - 仅需 DEEPSEEK_API_KEY):

setx DEEPSEEK_API_KEY "sk-..."           # Windows
export DEEPSEEK_API_KEY="sk-..."         # macOS/Linux

OpenRouter (可选):

setx OPENROUTER_API_KEY "sk-or-..."      # Windows
export OPENROUTER_API_KEY="sk-or-..."    # macOS/Linux

Fireworks AI (可选):

setx FIREWORKS_API_KEY "fw_..."          # Windows
export FIREWORKS_API_KEY="fw_..."        # macOS/Linux

成本对比

使用水平	Anthropic Max	deepclaude (DeepSeek)	节省
轻度 (10 天/月)	$200/月 (封顶)	~$20/月	90%
重度 (25 天/月)	$200/月 (封顶)	~$50/月	75%
包含自动循环	$200/月 (封顶)	~$80/月	60%

DeepSeek 的自动上下文缓存功能使智能体循环的成本极低——在首次请求后，系统提示词和文件上下文会被缓存，缓存后仅需 $0.004/M（相比未缓存时的 $0.44/M）。

功能支持情况

支持的功能

• 文件读取、写入、编辑 (Read/Write/Edit 工具)
• Bash/PowerShell 执行
• Glob 和 Grep 搜索
• 多步自主工具循环
• 子智能体派生
• Git 操作
• 项目初始化 (/init)
• 思考模式 (Thinking mode，默认开启)

不支持或功能受限

功能	原因
图像/视觉输入	DeepSeek 的 Anthropic 兼容端点不支持图像
并行工具调用	DeepSeek 支持（每次调用最多 128 个），但 Claude Code 默认顺序发送工具
MCP 服务器工具	通过兼容层无法支持
Prompt 缓存节省	DeepSeek 有自己的缓存（自动），但 Anthropic 的 cache_control 会被忽略