Linux Ubuntu 安装 Claude Code 并接入 DeepSeek V4 Pro 教程

本教程基于 Ubuntu 系统，演示如何安装 Claude Code CLI 并配置使用 DeepSeek V4 Pro 模型（通过 DeepSeek Anthropic 兼容 API）。

---

1. 环境要求

• 操作系统: Ubuntu 20.04+ / Debian 系 Linux
• Node.js: >= 18.x
• npm: >= 9.x
• curl: 用于下载 NodeSource 安装脚本

验证并安装 curl

Node.js 安装脚本需要通过 curl 下载，先确认系统已安装 curl：

# 检查 curl 是否存在
which curl || sudo apt install -y curl

以上命令：若 curl 已存在则跳过安装，若不存在则通过 apt 安装。

安装 Node.js（如未安装）

# 使用 NodeSource 安装 Node.js 22 LTS
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version   # 应输出 v22.x.x
npm --version    # 应输出 10.x.x 或更高

---

2. 安装 Claude Code

通过 npm 全局安装：

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

验证安装：

claude --version
# 输出示例: 2.1.150 (Claude Code)

---

3. 获取 DeepSeek API Key

1. 登录 DeepSeek 开放平台
2. 进入 API Keys 页面
3. 点击 创建 API Key，复制生成的 key

API Key 格式: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

---

4. 配置环境变量

Claude Code 通过以下环境变量来接入第三方 Anthropic 兼容 API：

环境变量	说明
ANTHROPIC_BASE_URL	API 端点地址
ANTHROPIC_AUTH_TOKEN	API 鉴权 Token
ANTHROPIC_MODEL	使用的模型名称

方式一：写入 ~/.claude/set_env.sh（推荐，会话级自动加载）

cat > ~/.claude/set_env.sh << 'EOF'
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeek-API-Key"
export ANTHROPIC_MODEL="deepseek-v4-pro"
EOF

此文件会在每次 Claude Code 启动时自动 source。

方式二：写入 ~/.bashrc 或 ~/.zshrc（全局生效）

cat >> ~/.bashrc << 'EOF'

# Claude Code + DeepSeek
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeek-API-Key"
export ANTHROPIC_MODEL="deepseek-v4-pro"
EOF

source ~/.bashrc

注意: 两种方式均可，~/.claude/set_env.sh 更轻量且仅对 Claude Code 生效。

---

5. 其他可选配置

设置暗色主题

cat > ~/.claude/settings.json << 'EOF'
{
  "theme": "dark"
}
EOF

启用扩展思考模式（可选）

在启动时添加 --effort high 参数，或设置环境变量：

export CLAUDE_EFFORT=high

---

6. 验证配置

在终端中启动 Claude Code：

cd ~
claude

进入交互界面后，输入 /model 确认当前使用的模型：

/model

应显示为 deepseek-v4-pro。

输入测试问题确认回复正常：

请用中文回复：你是什么模型？

---

7. 常见问题

Q: 启动报错 ANTHROPIC_AUTH_TOKEN is not set

确认 ~/.claude/set_env.sh 中的 Token 是否正确，且文件有读权限：

cat ~/.claude/set_env.sh
# 确认输出包含正确的 Token

Q: 请求返回 401 错误

检查 API Key 是否有效，确认在 DeepSeek 后台该 Key 未被删除或过期。

Q: 请求返回 404 或模型不存在

确认 ANTHROPIC_MODEL 值为 deepseek-v4-pro（注意拼写），且你的 DeepSeek 账户有该模型的访问权限。

Q: 如何切换回 Anthropic 官方 API

删除或注释 ~/.claude/set_env.sh 中的三行环境变量，然后重启 Claude Code 即可。

---

8. 配置摘要一览

项目	值
Claude Code 版本	@anthropic-ai/claude-code (npm 全局安装)
API 端点	https://api.deepseek.com/anthropic
模型	deepseek-v4-pro
认证	sk-你的DeepSeek-API-Key
主题	dark（可选）
环境配置	~/.claude/set_env.sh 或 ~/.bashrc

---

最后更新: 2026-05-26 | Claude Code 版本: 2.1.150