非 root 用户安装 Claude Code 并配置 DeepSeek API 完整指南

前言

最近 Claude Code 非常火，但 Anthropic 官方 API 的使用门槛较高。好消息是，我们可以通过配置使其接入 DeepSeek API，享受高性价比的 AI 编程助手服务。本文记录了在 CentOS 服务器上不使用 root 权限完成整个安装和配置的过程。

适用场景

• 你只有服务器的普通用户权限，没有 sudo
• 想在服务器上使用 Claude Code 进行代码开发
• 希望使用 DeepSeek API 而非官方 Anthropic API

环境要求

• 操作系统：CentOS / RHEL 系列
• 用户权限：非 root 用户
• 网络：能够访问外网（访问 DeepSeek API）

---

第一步：安装 Node.js（用户空间）

Claude Code 需要 Node.js 18+ 版本，但这里我们使用 Node.js 16.20.0 实测也完全可用。由于没有 root 权限，我们需要将 Node.js 安装到自己的用户目录下。

# 下载 Node.js 二进制包
wget https://nodejs.org/dist/v16.20.0/node-v16.20.0-linux-x64.tar.xz

# 创建安装目录
mkdir -p ~/biosoft/node-v16.20.0

# 解压到指定目录（--strip 1 去掉外层文件夹）
tar -xJf node-v16.20.0-linux-x64.tar.xz --strip 1 -C ~/biosoft/node-v16.20.0

# 添加到环境变量（写入 ~/.bashrc 永久生效）
echo 'export PATH="$HOME/biosoft/node-v16.20.0/bin:$PATH"' >> ~/.bashrc

# 立即生效
source ~/.bashrc

# 验证安装
node --version   # 应输出 v16.20.0
npm --version    # 应输出对应版本号

第二步：安装 Claude Code

使用 npm 全局安装 Claude Code（同样会安装到用户目录下）：

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

# 验证安装
claude --version   # 应输出版本号，如 v2.1.121

注意：如果 claude 命令找不到，确认 ~/biosoft/node-v16.20.0/bin 已经在 PATH 中，或者 npm config get prefix 查看全局包安装路径并添加到 PATH。

第三步：准备 DeepSeek API Key

1. 访问 DeepSeek 开放平台
2. 注册/登录账号
3. 进入 API Keys 页面
4. 点击 创建 API Key，复制保存生成的密钥（以 sk- 开头）

⚠️ 安全提醒：API Key 相当于密码，请妥善保管，不要在公开场合暴露。

第四步：配置 Claude Code 使用 DeepSeek API

核心思路是修改环境变量，让 Claude Code 将请求发送到 DeepSeek 提供的兼容接口。

方法一：通过 ~/.bashrc 配置（推荐）

# 添加配置到 ~/.bashrc
echo "export ANTHROPIC_BASE_URL='https://api.deepseek.com/anthropic'" >> ~/.bashrc
echo "export ANTHROPIC_AUTH_TOKEN='你的-API-Key'" >> ~/.bashrc
echo "export ANTHROPIC_MODEL='deepseek-chat'" >> ~/.bashrc
echo "export ANTHROPIC_SMALL_FAST_MODEL='deepseek-chat'" >> ~/.bashrc

# 使配置生效
source ~/.bashrc

方法二：通过配置文件设置

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

# 写入配置文件
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的-API-Key",
    "ANTHROPIC_MODEL": "deepseek-chat",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-chat"
  }
}
EOF

第五步：验证配置

1. 检查环境变量

echo $ANTHROPIC_BASE_URL   # 应输出 https://api.deepseek.com/anthropic
echo $ANTHROPIC_MODEL      # 应输出 deepseek-chat

2. 测试 API 连通性

curl -X POST https://api.deepseek.com/anthropic/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: 你的-API-Key" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "deepseek-chat",
    "max_tokens": 10,
    "messages": [{"role": "user", "content": "Hi"}]
  }'

如果返回正常的 JSON 响应（如 {"id":"...", "type":"message", ...}），说明 API 配置正确。

3. 启动 Claude Code

# 进入你的项目目录
cd ~/your-project

# 启动 Claude Code
claude

成功启动后，你会看到类似这样的界面：

4. 测试对话

输入任意问题测试，例如：

❯ 请用 Python 打印 "Hello, World!"

如果 Claude Code 正常响应，恭喜你，配置成功！🎉

可能遇到的问题及解决方案

问题1：请求超时

现象：API_TIMEOUT_MS=3000000ms ... Retrying

解决方案：

# 设置更长的超时时间
export API_TIMEOUT_MS=600000

# 或在配置文件中添加
cat >> ~/.claude/settings.json << 'EOF'
{
  "apiTimeoutMs": 600000
}
EOF

问题2：claude 命令找不到

解决方案：

# 确认 npm 全局包安装路径
npm config get prefix

# 将该路径下的 bin 目录添加到 PATH
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc
source ~/.bashrc

问题3：网络连接问题

解决方案：测试基础连通性

# 测试能否连接到 DeepSeek API
curl -I https://api.deepseek.com/anthropic

# 如果公司服务器需要代理，设置代理
export HTTP_PROXY=http://your-proxy:port
export HTTPS_PROXY=http://your-proxy:port

日常使用

启动 Claude Code

cd ~/your-project
claude

常用命令

命令	说明
/help	查看帮助信息
/init	初始化项目配置文件
Ctrl+C	退出 Claude Code
/model	查看当前使用的模型

模型选择

• deepseek-chat：DeepSeek-V3.1-Terminus（非思考模式）
• deepseek-reasoner：DeepSeek-R1（思考模式，适合复杂推理任务）

修改模型：

export ANTHROPIC_MODEL='deepseek-reasoner'

总结

通过以上步骤，我们在没有 root 权限的情况下成功完成了：

1. ✅ 用户空间安装 Node.js
2. ✅ 安装 Claude Code CLI 工具
3. ✅ 配置 DeepSeek API 接入
4. ✅ 验证和测试

现在你可以愉快地使用 Claude Code + DeepSeek API 来辅助编程了！相比官方 Anthropic API，DeepSeek 性价比更高，对国内用户也更友好。

相关链接

• Claude Code 官方文档
• DeepSeek 开放平台
• DeepSeek API 文档

---

📝 最后提醒：请确保 API Key 安全，不要提交到公开代码仓库。如果 Key 意外泄露，立即在 DeepSeek 平台删除并重新生成。

---

这篇博客涵盖了你的完整安装流程，你可以直接复制使用。如果需要调整格式或补充某些细节，请告诉我！