Claude Code 是一款运行在终端中的 AI 编程工具,可以读取项目代码、修改文件、执行命令并协助完成开发任务。
除了使用 Claude 官方模型,我们也可以通过 DeepSeek 提供的 Anthropic 兼容接口,让 Claude Code 调用 DeepSeek 模型。
整个配置过程只需要五步:
- 安装 Claude Code
- 创建 DeepSeek API Key
- 粘贴自动配置脚本
- 输入
deepseek启动 - 验证模型并开始使用
本文以 macOS 的 zsh 终端为例。
第一步:安装 Claude Code
打开 Mac 的“终端”应用,粘贴下面的命令:
curl -fsSL https://claude.ai/install.sh | bash
这是 Claude Code 官方推荐的 macOS、Linux 和 WSL 安装方式。
安装完成后,输入:
claude --version
如果终端能够显示 Claude Code 的版本号,就代表安装成功。
如果提示:
command not found: claude
可以关闭当前终端窗口,重新打开一个终端,再次执行:
claude --version
第二步:创建 DeepSeek API Key
进入 DeepSeek 开放平台并登录账号,然后打开 API Keys 页面。
点击创建新的 API Key,并复制生成的密钥。DeepSeek 的 API Key 通常以 sk- 开头。
例如:
sk-xxxxxxxxxxxxxxxxxxxxxxxx
请注意:
- API Key 只会完整显示一次,创建后及时复制;
- 不要把 API Key 发给其他人;
- 不要把 API Key 上传到 GitHub;
- 需要确保 DeepSeek API 账户中有可用余额。
复制好 API Key 后,先不要关闭页面,下一步需要将它粘贴到终端中。
第三步:粘贴自动配置脚本
回到 Mac 终端,将下面整段脚本完整复制并粘贴进去,然后按回车执行:
{
echo "开始配置 DeepSeek + Claude Code"
echo
read -s "DEEPSEEK_API_KEY?请粘贴 DeepSeek API Key:"
echo
if [[ -z "$DEEPSEEK_API_KEY" ]]; then
echo "配置失败:API Key 不能为空"
return 1
fi
if ! command -v claude >/dev/null 2>&1; then
echo "配置失败:没有找到 claude 命令"
echo "请先安装 Claude Code"
unset DEEPSEEK_API_KEY
return 1
fi
ZSHRC="$HOME/.zshrc"
BACKUP="$HOME/.zshrc.backup.$(date +%Y%m%d-%H%M%S)"
TEMP_FILE="$(mktemp)"
touch "$ZSHRC"
cp "$ZSHRC" "$BACKUP"
# 删除之前由本脚本生成的 DeepSeek 配置
awk '
$0 == "# >>> deepseek-claude-code >>>" {
skipping = 1
next
}
$0 == "# <<< deepseek-claude-code <<<" {
skipping = 0
next
}
!skipping {
print
}
' "$ZSHRC" > "$TEMP_FILE"
cat "$TEMP_FILE" > "$ZSHRC"
rm -f "$TEMP_FILE"
KEY_ESCAPED="$(printf '%q' "$DEEPSEEK_API_KEY")"
cat >> "$ZSHRC" <<EOF
## >>> deepseek-claude-code >>>
deepseek() {
(
unset ANTHROPIC_API_KEY
unset ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN=$KEY_ESCAPED
export ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_EFFORT_LEVEL="max"
exec claude "\$@"
)
}
## <<< deepseek-claude-code <<<
EOF
chmod 600 "$ZSHRC"
unset DEEPSEEK_API_KEY KEY_ESCAPED
source "$ZSHRC"
echo
echo "配置完成。"
echo "配置文件备份:$BACKUP"
echo
type deepseek
echo
deepseek --version
}
执行脚本后,终端会显示:
请粘贴 DeepSeek API Key:
此时粘贴刚刚复制的 DeepSeek API Key,然后按回车。
输入密钥时,终端不会显示星号,也不会显示输入内容,这是正常的安全设计。
脚本会自动完成以下工作:
- 检查 Claude Code 是否已经安装;
- 备份原来的
~/.zshrc; - 写入 DeepSeek API 配置;
- 创建一个名为
deepseek的终端命令; - 设置 DeepSeek Anthropic 兼容接口;
- 配置 DeepSeek 主模型和子代理模型;
- 让配置立即生效。
第四步:输入 deepseek 启动
配置完成后,在终端中直接输入:
deepseek
第一次在某个目录启动 Claude Code 时,可能会看到安全确认:
Is this a project you created or one you trust?
它是在询问当前目录是否是你信任的项目。
建议先进入自己的代码项目目录:
cd 你的项目目录
然后再运行:
deepseek
确认是自己的项目后,选择:
1. Yes, I trust this folder
进入 Claude Code 后,输入:
你是什么模型?
如果配置成功,模型通常会回答自己是 DeepSeek 模型。
配置中的 deepseek-v4-pro[1m] 是主模型,轻量任务和子代理则使用 deepseek-v4-flash,与 DeepSeek 当前提供的 Claude Code 集成配置一致。
第五步:配置完成
以后每次使用时,只需要进入项目目录:
cd 你的项目目录
然后输入:
deepseek
Claude Code 就会通过 DeepSeek API 工作。
如果电脑中原本已经配置过 Claude Code,还可以保留不同的启动方式:
claude
使用原来的 Claude Code 配置。
deepseek
使用 DeepSeek API 启动 Claude Code。
两个命令相互独立,不需要反复修改配置。
配置时需要注意
如果运行时出现:
401 Unauthorized
通常表示 API Key 无效、填写错误或已经被删除。
如果出现余额不足提示,需要进入 DeepSeek 开放平台充值 API 余额。
如果修改配置后命令没有生效,可以执行:
source ~/.zshrc
然后重新输入:
deepseek
至此,我们就完成了 Claude Code 与 DeepSeek API 的连接。以后无需重复配置,进入项目目录并运行 deepseek,就可以直接使用 DeepSeek 驱动 Claude Code 进行编程。