Claude Code + DeepSeek API 部署指南

命令终端环境: Linux x86_64 (RHEL / Rocky ) ，其他发行版本也可参考
APP开发环境：VS Code + Claude Code for VS Code
当前版本: Claude Code 2.1.x + DeepSeek API

环境概览

本指南基于当前部署的实战经验整理，整体架构如下：

┌──────────────┐         ┌──────────────────┐
│  Claude Code │ ──HTTPS──▶  DeepSeek API    │
│  (CLI/IDE)   │         │  Anthropic 兼容层 │
└──────────────┘         └──────────────────┘

Claude Code 是 Anthropic 推出的 AI 编程助手 CLI 工具，通过设置 ANTHROPIC_BASE_URL 环境变量，可以将其后端模型替换为 DeepSeek API（兼容 Anthropic Messages API），实现国产模型驱动的智能编程体验。

环境准备

系统要求

项目	要求
操作系统	Linux x86_64 (macOS/Windows 也支持)
Node.js	>= 18.x（推荐 20.x+）
npm	>= 9.x
网络	能访问 DeepSeek API (`api.deepseek.com`)
磁盘	安装占用约 ~500MB

安装 Node.js（如未安装）

curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
dnf install nodejs -y

安装 Claude Code

全局安装

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

验证安装

[root@master01 ~]# claude -version 
2.1.170 (Claude Code)

配置 DeepSeek API

获取 DeepSeek API Key

访问 DeepSeek 开放平台
注册/登录账号
在「API Keys」页面创建新的 API Key
复制 Key（格式：sk-xxxxxxxxxxxxxxxx）

设置环境变量

将以下配置写入 ~/.bashrc 或 ~/.env，确保持久化：

# ─── DeepSeek API 核心配置 ───

# 将 Anthropic API 请求转发到 DeepSeek 兼容层
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

# DeepSeek API Key
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# ─── 模型映射（关键配置） ───

# 默认使用的模型
export ANTHROPIC_MODEL="deepseek-v4-pro[1m]"

# Opus（最强推理）→ V4 Pro [1M 上下文]
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"

# Sonnet（均衡）→ V4 Pro [1M 上下文]
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"

# Haiku（快速轻量）→ V4 Flash
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"

# ─── Claude Code 专用配置 ───

# 子代理使用轻量模型（省 token）
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"

# 努力程度：max / high / medium / low
export CLAUDE_CODE_EFFORT_LEVEL="max"

使配置生效

source ~/.bashrc
# 或者
source ~/.env

验证配置

echo  $ANTHROPIC_BASE_URL # 输出: https://api.deepseek.com/anthropic echo$ ANTHROPIC_MODEL
# 输出: deepseek-v4-pro[1m]

启动 Claude Code

交互模式

# 直接启动
claude

# 启动并进入计划模式
claude --plan

# 指定工作目录
claude --cwd /path/to/your/project

非交互模式（管道）

# 一次性问答
echo "用 Python 写一个快速排序" | claude -p

# 传入文件
cat bug_report.txt | claude -p "分析这个 bug"

# 自动化脚本
claude -p "列出当前目录的文件并解释用途"

VScode 集成模式

在 VSCode 中下载 Claude Code for VS Code 插件
在插件设置中找到“在 settings.json 中编辑”
填写以下参数，保存即可

{
  "claudeCode.environmentVariables": [


    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-xx"  // 填入你的 API Key
    },
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://api.deepseek.com/anthropic"  // 填入你的中转或服务商 API 地址
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "deepseek-v4-pro" // 填入你想要使用的模型名称
    }
],
"claudeCode.preferredLocation": "panel",
"claudeCode.disableLoginPrompt": true,
"claudeCode.useTerminal": true,
"workbench.editor.enablePreview": false,
"git.enableSmartCommit": true,
"git.confirmSync": false,
"explorer.confirmDelete": false,
"git.autofetch": true,
"explorer.confirmDragAndDrop": false,
"workbench.colorTheme": "One Dark Modern"
}

模型对照表

DeepSeek 模型 → Claude 角色映射

Claude 角色	DeepSeek 模型	特点
Opus (最强推理)	`deepseek-v4-pro[1m]`	1M 上下文，复杂推理
Sonnet (均衡)	`deepseek-v4-pro[1m]`	同上，速度与质量平衡
Haiku (子代理)	`deepseek-v4-flash`	快速响应，适合文件搜索等轻量任务

可用模型列表

deepseek-v4-pro[1m]    # 主力模型，推荐
deepseek-v4-pro        # 标准版（无 1M 长上下文）
deepseek-v4-flash      # 快速版，适合子代理

切换模型

# 临时切换（本次会话生效）
export ANTHROPIC_MODEL="deepseek-v4-pro"

# 或者直接在 Claude Code 中使用 /model 命令
/model deepseek-v4-flash

配置文件说明

配置文件路径

文件	用途
`~/.claude.json`	主配置文件（用户偏好、项目设置）
`~/.claude/settings.json`	本地设置（主题、权限等）
`~/.env`	环境变量（API Key、模型设置）
`CLAUDE.md`	项目级指令文件（放在项目根目录）

~/.claude.json 关键字段

{
  "installMethod": "global",
  "hasCompletedOnboarding": true,
  "projects": {
    "/root": {
      "allowedTools": [],
      "mcpServers": {},
      "hasTrustDialogAccepted": false
    }
  }
}

~/.claude/settings.json

{
  "theme": "dark"
}

目录结构

/root/
├── .env                          # ← 环境变量（API Key 等）
├── .claude.json                  # ← 主配置
├── .claude/                      # Claude Code 数据目录
│   ├── settings.json             # 用户设置
│   ├── backups/                  # 配置备份
│   ├── projects/                 # 项目缓存
│   ├── memory/                   # 持久记忆
│   └── worktrees/                # Git 工作树
├── CLAUDE.md                     # ← 项目指令（可选，放项目根目录）
└── your-project/
    └── CLAUDE.md                 # ← 子项目指令

常用命令速查

斜杠命令（在 Claude Code 交互中使用）

命令	说明
`/help`	帮助
`/model`	切换模型
`/config`	打开配置
`/memory`	管理持久记忆
`/cost`	查看 Token 用量
`/compact`	压缩上下文
`/clear`	清空对话
`/init`	初始化项目 CLAUDE.md
`/review`	审查 PR
`/pr-comment`	PR 评论

终端命令（在外部 shell 使用）

命令	说明
`claude`	启动交互模式
`claude -p "prompt"`	一次性问答
`claude --cwd /path`	指定工作目录
`claude --plan`	进入计划模式
`claude --model sonnet`	指定模型
`claude update`	更新 Claude Code

Claude Code 的请求会发送到 ANTHROPIC_BASE_URL 指向的端点，DeepSeek API 实现了 Anthropic Messages API 的兼容层，因此可以无缝替换后端模型。包括 流式输出、工具调用（Tool Use）、多模态输入 等特性均支持。

扩展阅读

Kubecc

要想成为扫地僧，需要不断的学习进步，这个世界，在悄悄惩罚那些不改变的人