Claude Code 接入 DeepSeek 模型：问题排查与终极配置手册
本手册针对在 Mac 环境下，使用 Claude Code 客户端调用 DeepSeek (Anthropic 兼容接口) 时常见的网络拦截、鉴权失败等问题提供标准解决方案。

常见问题与排查指南

1. SSL 证书验证失败 (网络请求被拦截)
   报错现象：

终端提示：Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates

右下角可能伴随提示：Auto-update failed

问题根源：
Claude Code 基于 Node.js 运行。当你开启了本地网络代理时，代理软件接管流量所使用的自签名证书不被 Node.js 的底层安全机制信任，导致请求被强行阻断。

解决方案：
绕过 Node.js 的 SSL 校验，并让目标域名的流量直连、不走代理。在终端执行或在启动脚本中加入以下环境变量：

Bash

关闭 Node.js 严格的 SSL 证书校验

export NODE_TLS_REJECT_UNAUTHORIZED=0

让 DeepSeek 的 API 域名绕过本地代理直连

export NO_PROXY=“api.deepseek.com”
2. 401 鉴权失败 (即使已设置新的 API Key)
报错现象：

终端提示：401 {“error”:{“message”:“Authentication Fails, Your api key: ****xxxx is invalid”…}}

报错信息中显示的尾号（如 ****566a）与你刚刚设置的最新 API Key 不符。

问题根源：
Claude Code 内部存在缓存机制，或者读取了系统级存储的旧凭证。它会优先使用缓存中的旧 Key，从而无视你刚刚通过 export 命令注入的新环境变量。此外，Anthropic 官方 SDK 识别的标准鉴权变量名为 ANTHROPIC_API_KEY，而非 ANTHROPIC_AUTH_TOKEN。

解决方案：
强制清理缓存，并使用正确的环境变量名重新赋值。

Bash

1. 强制退出当前账号，清除 Claude Code 内部缓存状态

claude logout

2. 清除可能造成干扰的旧环境变量

unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_API_KEY

3. 使用标准变量名注入新的 API Key

export ANTHROPIC_API_KEY=“sk-你的完整API_KEY”
终极完美配置方案 (Mac/Zsh 环境)
为了彻底避免上述所有问题，并在官方 Claude 模型与本地 DeepSeek 模型之间无缝切换，强烈建议在终端配置文件中固化一个专属的快捷命令。

配置步骤：

使用编辑器打开终端配置文件：

Bash
nano ~/.zshrc
将以下脚本添加到文件最末尾（请替换为你真实的 API Key）：

Bash

Claude Code - DeepSeek 专属启动环境

function claude-ds() {
# 强制清理可能干扰的旧 Token
unset ANTHROPIC_AUTH_TOKEN

# 注入 DeepSeek 配置及网络放行规则
env ANTHROPIC_API_KEY="sk-你的完整API_KEY" \
    ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" \
    ANTHROPIC_MODEL="deepseek-chat" \
    ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat" \
    API_TIMEOUT_MS=600000 \
    NODE_TLS_REJECT_UNAUTHORIZED=0 \
    NO_PROXY="api.deepseek.com" \
    claude "$@"

}
保存退出并让配置生效：

Bash
source ~/.zshrc
日常使用方式：

在终端输入 claude：默认使用官方原版环境。

在终端输入 claude-ds：启动经过全面网络优化的 DeepSeek 环境。

验证配置是否成功
在目标文件夹下运行 claude-ds 后输入“你好”。如果 Claude Code 能够正常回复，并且主动调用终端工具（如 Bash(pwd && ls -la)）来识别当前目录状态，即代表接口通信、模型推理与工具调用（Tool Calling）功能均已完美跑通。

如何切换到R1模型

function claude-ds() {
unset ANTHROPIC_AUTH_TOKEN
env ANTHROPIC_API_KEY=“sk-你的API Key”
ANTHROPIC_BASE_URL=“https://api.deepseek.com/anthropic”
ANTHROPIC_MODEL=“deepseek-chat”
ANTHROPIC_SMALL_FAST_MODEL=“deepseek-chat”
API_TIMEOUT_MS=600000
NODE_TLS_REJECT_UNAUTHORIZED=0
NO_PROXY=“api.deepseek.com”
claude “$@”
}

function claude-r1() {
unset ANTHROPIC_AUTH_TOKEN
env ANTHROPIC_API_KEY=“sk-你的API Key”
ANTHROPIC_BASE_URL=“https://api.deepseek.com/anthropic”
ANTHROPIC_MODEL=“deepseek-reasoner”
ANTHROPIC_SMALL_FAST_MODEL=“deepseek-chat”
API_TIMEOUT_MS=600000
NODE_TLS_REJECT_UNAUTHORIZED=0
NO_PROXY=“api.deepseek.com”
claude “$@”
}

2. 让配置生效
   保存退出后（Ctrl + O, Enter, Ctrl + X），在终端刷新配置：

Bash
source ~/.zshrc
3. 使用 R1 模型
现在，你可以通过不同的命令来启动 Claude Code 了：

输入 claude-ds：启动 V3 模型（适合绝大多数需要大量读取文件、执行终端命令的任务）。

输入 claude-r1：启动 R1 模型（适合遇到困难 Bug、需要重构复杂架构、或者需要深度推理的场景）。