一、安装 Node.js 环境 (Claude Code 前置依赖)
Claude Code 需要 Node.js 18+ 环境。Kali 自带的版本可能不够,推荐用 NVM 安装。
# 安装 NVM (Node Version Manager)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载 shell 配置
source ~/.bashrc
# 安装 Node.js LTS 版本 (推荐 20.x)
nvm install 20
# 设置为默认版本
nvm alias default 20二、安装 Claude Code
Claude Code 是 Anthropic 官方的 CLI AI 编程工具,通过 npm 全局安装:
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version🎯 安装成功后,在终端输入 claude 即可启动交互界面。
三、配置 DeepSeek V4 API (核心步骤)
这是本文最关键的部分——让 Claude Code 走 DeepSeek 的 API,用 DeepSeek V4 模型。
3.1获取 DeepSeek API Key
- 访问 https://platform.deepseek.com
- 注册/登录 DeepSeek 开发者平台
- 进入「API Keys」页面 → 点击「创建新的 API Key」
- 复制保存好 Key(只显示一次!)
💰 价格优势: DeepSeek V4 API 价格仅为 Claude 官方的约 1/10,400万 Token 的消费从 26 降至不到 2。
3.2推荐方式:cc-switch 一键配置 (可视化,零门槛)
手动敲环境变量容易出错,推荐使用开源工具 cc-switch,一键搞定 Claude Code 的模型供应商切换:
# 1. 克隆 cc-switch 项目
git clone https://github.com/farion1231/cc-switch.git
cd cc-switch
#注意因网络连接问题git clone可能速度很慢,也可以直接访问(https://github.com/farion1231/cc-switch/releases),根据自己的架构选择对应的.deb安装包
# 2. 安装依赖
npm install
# 3. 启动 cc-switch 图形界面
npm start启动后会打开一个 Web 可视化界面,操作步骤如下:
| 步骤 | 操作 |
|---|---|
| ① | 选择供应商 → DeepSeek |
| ② | 粘贴你的 DeepSeek API Key (sk-xxxx) |
| ③ | 选择默认模型:deepseek-v4-pro[1m] (1M 长上下文) |
| ④ | Flash 模型选:deepseek-v4-flash (轻量快速任务用) |
| ⑤ | 推理深度设为 max (最高质量) |
| ⑥ | 点击「应用配置」,完成! |
cc-switch 会自动帮你把以下环境变量写入 ~/.bashrc,无需手动操作:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxx # 你的 Key
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max🎯 cc-switch 的强大之处:
- 🌐 支持多供应商一键切换(DeepSeek、硅基流动、智谱等),不用反复改配置
- 🔑 多 API Key 管理,团队共享配置
- 📊 模型性能对比
- ⬇️ 配置导入/导出,换机器不用重新配
配置完成后,执行 source ~/.bashrc 让配置生效即可。
3.3 备选方式:手动配置环境变量
如果你不想用图形界面,也可以直接在终端中手动配置:
# 永久生效 (写入 ~/.bashrc)
cat >> ~/.bashrc << 'EOF'
# ==== Claude Code + DeepSeek V4 配置 ====
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # 替换为你的 Key
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
EOF3.4 环境变量详解
| 环境变量 | 值 | 说明 |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.deepseek.com/anthropic | 将 Claude Code 的 API 请求转发到 DeepSeek |
ANTHROPIC_AUTH_TOKEN | 你的 API Key | DeepSeek 的认证令牌 |
ANTHROPIC_MODEL | deepseek-v4-pro[1m] | 默认使用的主模型 (1M上下文) |
ANTHROPIC_DEFAULT_SONNET_MODEL | deepseek-v4-pro[1m] | Sonnet 级别任务使用的模型 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | deepseek-v4-flash | Haiku 级别任务使用的轻量模型 |
CLAUDE_CODE_SUBAGENT_MODEL | deepseek-v4-flash | 子代理使用的模型 (轻量快速) |
CLAUDE_CODE_EFFORT_LEVEL | max | 推理深度设为最高 |
3.5 验证配置
# 检查环境变量是否生效
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_MODEL
# 启动 Claude Code 测试
claude
# 在 Claude 交互界面中输入测试问题
> 你好,请介绍一下你自己,你是什么模型?如果 Claude Code 正常响应并提到 DeepSeek V4,说明配置成功!
好的,这是为您补充的"注意事项"章节,您可以直接将其添加到文档的末尾:
四、注意事项:解决 Kali 无法连接 GitHub 的问题
在 Kali Linux 初始环境中,由于网络策略或 DNS 解析问题,经常会出现无法访问 raw.githubusercontent.com 或 github.com 的情况。这会导致上述步骤中 安装 NVM(curl 命令)或 克隆 cc-switch 项目(git clone 命令)失败。
解决方法:修改 Hosts 文件
通过手动指定 GitHub 相关域名的 IP 地址,可以绕过 DNS 解析故障。
查询真实 IP
访问 IPAddress.com 或类似的 IP 查询网站,分别查询以下域名的最新 IP 地址:github.comraw.githubusercontent.com
编辑 Hosts 文件
在 Kali 终端中打开 hosts 文件进行编辑:sudo nano /etc/hosts添加映射记录
在文件末尾添加查询到的 IP 和域名映射(示例如下,请务必替换为你查询到的实时 IP):# GitHub Hosts Start 140.82.113.4 github.com 199.232.68.133 raw.githubusercontent.com # GitHub Hosts End保存并刷新
- 按
Ctrl + O保存,按Enter确认,然后按Ctrl + X退出编辑器。 刷新 DNS 缓存使配置立即生效:
sudo /etc/init.d/networking restart # 或者尝试 sudo systemd-resolve --flush-caches
- 按
- 验证连接
再次尝试之前的安装命令,通常即可顺利下载。如果仍然不通,可能是 IP 变动,请重新查询并更新 hosts 文件。
这是根据图片内容提取的 Markdown 格式文档:
五、常见问题排查
Q1: claude 命令找不到?
# 检查 npm 全局安装路径
npm list -g @anthropic-ai/claude-code
# 确保 ~/.npm-global/bin 在 PATH 中
export PATH="$HOME/.npm-global/bin:$PATH"Q2: Claude Code 启动后报认证错误?
# 检查环境变量
env | grep ANTHROPIC
# 确认 API Key 前缀是 sk-
# 确认没有多余的空格或引号Q3: 请求速度慢?
# 尝试切换到 flash 模型做轻度任务
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
# 降低推理深度
export CLAUDE_CODE_EFFORT_LEVEL=mediumQ4: Kali 网络不通?
# 检查 NAT 网络配置
ip a
# 重启网络服务
sudo systemctl restart networking
# 测试外网连通性
ping -c 4 8.8.8.8以上就是kali中claude的安装并接入deepseek的api教程
评论 (0)