# 3分钟让 ClaudeCode 变成 DeepSeekCode：Mac 完整配置指南

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 的“终端”应用，粘贴下面的命令：

```bash
curl -fsSL https://claude.ai/install.sh | bash
```

这是 Claude Code 官方推荐的 macOS、Linux 和 WSL 安装方式。

安装完成后，输入：

```bash
claude --version
```

如果终端能够显示 Claude Code 的版本号，就代表安装成功。

如果提示：

```text
command not found: claude
```

可以关闭当前终端窗口，重新打开一个终端，再次执行：

```bash
claude --version
```

---

## 第二步：创建 DeepSeek API Key

进入 DeepSeek 开放平台并登录账号，然后打开 **API Keys** 页面。

点击创建新的 API Key，并复制生成的密钥。DeepSeek 的 API Key 通常以 `sk-` 开头。



例如：

```text
sk-xxxxxxxxxxxxxxxxxxxxxxxx
```

请注意：

* API Key 只会完整显示一次，创建后及时复制；
* 不要把 API Key 发给其他人；
* 不要把 API Key 上传到 GitHub；
* 需要确保 DeepSeek API 账户中有可用余额。

复制好 API Key 后，先不要关闭页面，下一步需要将它粘贴到终端中。

---

## 第三步：粘贴自动配置脚本

回到 Mac 终端，将下面整段脚本完整复制并粘贴进去，然后按回车执行：

```bash
{
  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
}
```

执行脚本后，终端会显示：

```text
请粘贴 DeepSeek API Key：
```

此时粘贴刚刚复制的 DeepSeek API Key，然后按回车。

输入密钥时，终端不会显示星号，也不会显示输入内容，这是正常的安全设计。

脚本会自动完成以下工作：

* 检查 Claude Code 是否已经安装；
* 备份原来的 `~/.zshrc`；
* 写入 DeepSeek API 配置；
* 创建一个名为 `deepseek` 的终端命令；
* 设置 DeepSeek Anthropic 兼容接口；
* 配置 DeepSeek 主模型和子代理模型；
* 让配置立即生效。


## 第四步：输入 deepseek 启动

配置完成后，在终端中直接输入：

```bash
deepseek
```

第一次在某个目录启动 Claude Code 时，可能会看到安全确认：

```text
Is this a project you created or one you trust?
```

它是在询问当前目录是否是你信任的项目。

建议先进入自己的代码项目目录：

```bash
cd 你的项目目录
```

然后再运行：

```bash
deepseek
```

确认是自己的项目后，选择：

```text
1. Yes, I trust this folder
```

进入 Claude Code 后，输入：

```text
你是什么模型？
```



如果配置成功，模型通常会回答自己是 DeepSeek 模型。


配置中的 `deepseek-v4-pro[1m]` 是主模型，轻量任务和子代理则使用 `deepseek-v4-flash`，与 DeepSeek 当前提供的 Claude Code 集成配置一致。

---

## 第五步：配置完成

以后每次使用时，只需要进入项目目录：

```bash
cd 你的项目目录
```

然后输入：

```bash
deepseek
```

Claude Code 就会通过 DeepSeek API 工作。

如果电脑中原本已经配置过 Claude Code，还可以保留不同的启动方式：

```bash
claude
```

使用原来的 Claude Code 配置。

```bash
deepseek
```

使用 DeepSeek API 启动 Claude Code。

两个命令相互独立，不需要反复修改配置。

---

## 配置时需要注意

如果运行时出现：

```text
401 Unauthorized
```

通常表示 API Key 无效、填写错误或已经被删除。

如果出现余额不足提示，需要进入 DeepSeek 开放平台充值 API 余额。

如果修改配置后命令没有生效，可以执行：

```bash
source ~/.zshrc
```

然后重新输入：

```bash
deepseek
```

至此，我们就完成了 Claude Code 与 DeepSeek API 的连接。以后无需重复配置，进入项目目录并运行 `deepseek`，就可以直接使用 DeepSeek 驱动 Claude Code 进行编程。

---

本文同步自凉风Lab。原文与后续更新：https://liangfenglab.com/guides/deepseek-code/