Linux 服务器安装 Claude Code CLI 对接 DeepSeek API 完整指南

含踩坑修复 + 环境变量 + 配置文件 + VSCode 适配 + 全量排错

一、前言

国内服务器直接安装 Claude Code 会遇到区域限制、官方 API 无法访问、强制登录等问题。本文提供一套国内可用方案：安装 Claude Code CLI + 完全对接 DeepSeek 兼容接口，全程可落地、可直接复制执行。

二、环境要求

系统：Ubuntu 20.04+ / Debian 系 Linux
权限：普通用户 / root / sudo
依赖：curl、git
必备：DeepSeek 账号 + 有效 API Key

三、两种安装方式（二选一）

方式一：NPM 安装【推荐｜国内无限制】

需要 Node.js 18+

bash

# 安装 Node.js 官方源
curl -fsSL https://deb.nodesource.com/setup_lts.x | bash -
apt install -y nodejs git

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

# 验证
claude --version

方式二：官方脚本安装【需代理｜不推荐国内直接用】

bash

# 临时代理
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# 官方安装
curl -fsSL https://claude.ai/install.sh | bash

# 验证
claude --version

国内裸网会下载到 HTML 错误页面，直接报错，不建议使用。

四、核心：配置 DeepSeek 兼容 Anthropic 接口

1. 环境变量配置（全局永久生效）

编辑环境变量文件：

bash

nano ~/.bashrc

末尾粘贴以下内容，替换你的 DeepSeek Key：

bash

# Claude Code 对接 DeepSeek 全局配置
export ANTHROPIC_API_KEY="你的DeepSeek-API-Key"
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_MODEL="deepseek-v4-pro"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_EFFORT_LEVEL="max"

生效配置：

bash

source ~/.bashrc

校验是否生效：

bash

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

2. 兜底方案：Claude 本地配置文件

环境变量不生效、VSCode 终端读取异常时使用：

bash

nano ~/.claude.json

写入标准 JSON：

json

{
  "apiBaseUrl": "https://api.deepseek.com/anthropic",
  "apiKey": "你的DeepSeek-API-Key",
  "model": "deepseek-v4-pro",
  "smallFastModel": "deepseek-v4-flash"
}

五、VSCode 远程终端适配配置

VSCode 远程 SSH 默认不会读取 .bashrc 变量，需手动注入：

打开 设置 → 打开设置(JSON)，添加：

json

"terminal.integrated.env.linux": {
  "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
  "ANTHROPIC_API_KEY": "你的DeepSeek-API-Key",
  "ANTHROPIC_MODEL": "deepseek-v4-pro"
}

保存并重启终端。

六、常用命令

bash

# 启动命令行对话（稳定可用）
claude

# 查看当前配置
claude config list

# 查看版本
claude --version

七、高频问题 & 完整排错

问题1：curl 安装报错，下载内容是 HTML

报错：syntax error near unexpected token '<' 原因：区域限制，被拦截返回提示页面。解决：

开启代理
改用 NPM 安装方案

问题2：输入 claude 弹出登录、无法使用 DeepSeek

原因：

VSCode 官方 Claude 扩展强制走官方登录，不读自定义接口
环境变量未加载解决：

只用 终端执行 claude 命令，不要用 VSCode 侧边栏插件
检查 ANTHROPIC_API_KEY 变量名正确

问题3：新建会话卡住、无输出、Combobulating 卡死

原因：

仍在请求官方 Anthropic 接口
BaseURL 错误 / Key 错误 / 模型名非法解决：

确认 BaseURL： https://api.deepseek.com/anthropic
清理错误模型名，删除终端乱码字符
纯终端运行 claude，避开 VSCode 插件

问题4：环境变量 VSCode 终端不生效

解决：

写入 ~/.profile 或 VSCode 手动环境变量注入
重启窗口 + 重新连接服务器

问题5：API 调用失败、鉴权错误

排查命令：

bash

curl -X POST https://api.deepseek.com/anthropic/v1/messages \
-H "Authorization: Bearer 你的APIKEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4-pro","max_tokens":100,"messages":[{"role":"user","content":"hi"}]}'

有正常 JSON 返回 = 接口正常
报错则检查 Key 余额、权限、模型名称

八、卸载方案

bash

# NPM 卸载
npm uninstall -g @anthropic-ai/claude-code

# 官方二进制卸载
rm -f ~/.local/bin/claude

# 清理所有配置
rm -rf ~/.claude ~/.claude.json