← 效率指南
Tool中等 · 约 3min发布 2026/07/31

[工具指南]3分钟让 ClaudeCode 变成 DeepSeekCode:Mac 完整配置指南

3分钟让 ClaudeCode 变成 DeepSeekCode,同时还不影响原本Claude的配置

本页目录
01 · RESULT
RESULT FIRST · 先看结果

输入DeepSeek即可让ClaudeCode使用DeepSeek,而不会影响其他配置

3分钟让 ClaudeCode 变成 DeepSeekCode,同时还不影响原本Claude的配置

Claude Code 是一款运行在终端中的 AI 编程工具,可以读取项目代码、修改文件、执行命令并协助完成开发任务。

除了使用 Claude 官方模型,我们也可以通过 DeepSeek 提供的 Anthropic 兼容接口,让 Claude Code 调用 DeepSeek 模型。

整个配置过程只需要五步:

  1. 安装 Claude Code
  2. 创建 DeepSeek API Key
  3. 粘贴自动配置脚本
  4. 输入 deepseek 启动
  5. 验证模型并开始使用

本文以 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- 开头。

Image

例如:

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 后,输入:

你是什么模型?
Image

如果配置成功,模型通常会回答自己是 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 进行编程。

META

发布信息

  • caludecode
  • deepseek
  • AI

内容如有事实、结论或链接更新,会在本页标注更新时间。

← 返回效率指南