Claude Code 接入 DeepSeek 保姆级教程，WSL/Linux 通用

- 一、前置说明
- [二、安装 Claude Code](#二、安装 Claude Code)
- - [1. 切换 NPM 源（网络不佳时推荐）](#1. 切换 NPM 源（网络不佳时推荐）)
  - [2. 常规安装（网络正常可直接执行）](#2. 常规安装（网络正常可直接执行）)
  - [3. 验证是否安装成功](#3. 验证是否安装成功)
- [三、配置 Claude Code 对接 DeepSeek](#三、配置 Claude Code 对接 DeepSeek)
- - [1. 处理配置目录权限（解决 Vim 无法保存报错）](#1. 处理配置目录权限（解决 Vim 无法保存报错）)
  - [2. 编辑配置文件](#2. 编辑配置文件)
- 四、接口连通性测试（可选，排查网络问题）
- 五、启动使用
- 六、常见问题总结

本文手把手教你在国内环境安装配置 Claude Code，通过 DeepSeek 中转正常使用，解决官方 Anthropic 地域限制、网络连接报错问题。

一、前置说明

运行环境：WSL / Linux 终端
核心方案：借助 DeepSeek 兼容接口中转，无需境外代理即可使用 Claude Code
提前准备：DeepSeek API Key（前往 DeepSeek 平台申请）

二、安装 Claude Code

1. 切换 NPM 源（网络不佳时推荐）

npm安装教程

国内网络不稳定可临时切换为 NPM 官方源安装，安装完成后切回国内镜像：

bash 复制代码

# 切换为官方源
npm config set registry https://registry.npmjs.org

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 安装完毕，切回国内淘宝镜像（日常使用）
npm config set registry https://registry.npmmirror.com

2. 常规安装（网络正常可直接执行）

bash 复制代码

npm install -g @anthropic-ai/claude-code

3. 验证是否安装成功

输出版本号即代表安装完成：

bash 复制代码

claude --version

三、配置 Claude Code 对接 DeepSeek

1. 处理配置目录权限（解决 Vim 无法保存报错）

若编辑配置文件提示权限不足、无法写入，依次执行以下命令（当前用户为 dou3）：

bash 复制代码

# 创建 .claude 配置目录
mkdir -p /home/dou3/.claude

# 配置目录归属用户
chown -R dou3:dou3 /home/dou3/.claude

# 赋予目录读写执行权限
chmod -R 755 /home/dou3/.claude

2. 编辑配置文件

使用 vim 打开配置文件：

bash 复制代码

vim ~/.claude/settings.json

粘贴以下完整配置（务必删除模型名后多余字符，替换为你自己的 DeepSeek API Key）：

json 复制代码

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek-API-Key",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

ANTHROPIC_AUTH_TOKEN：填写你个人的 DeepSeek API Key
按 Esc，输入 :wq 保存并退出 vim

四、接口连通性测试（可选，排查网络问题）

执行以下命令测试 DeepSeek 中转接口是否正常连通，返回正常 JSON 则代表接口可用：

bash 复制代码

curl -X POST https://api.deepseek.com/anthropic/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的DeepSeek-API-Key" \
  -d '{
    "model": "deepseek-v4-flash",
    "max_tokens": 10,
    "messages": [{"role": "user", "content": "test"}]
  }'

五、启动使用

所有配置完成后，直接在终端运行命令启动 Claude Code：

bash 复制代码

claude

六、常见问题总结

E212: Can't open file for writing
原因：目录/文件权限不足 → 执行本文「配置目录权限」三条命令即可解决。
Unable to connect to Anthropic services / 403 Forbidden
原因：直连官方接口受地域限制 → 确认 ANTHROPIC_BASE_URL 配置为 DeepSeek 中转地址。
接口 401 报错
原因：API Key 错误或账户余额不足 → 核对 Key 有效性、检查 DeepSeek 账户状态。
接口 404 报错
原因：模型名称填写错误 → 保证模型名为 deepseek-v4-flash，无多余符号。