Ubuntu 系统部署教程

一、教程说明

本部分仅适用于 Ubuntu 系统，并按照实际部署流程编排：先切换 Ubuntu 国内软件源，再安装 Node.js 与 npm，通过 NPM 全局安装 Claude Code，随后写入 DeepSeek 环境变量并完成启动验证。

二、切换 Ubuntu 国内软件源

Ubuntu 默认软件源在部分网络环境下可能出现下载速度慢或超时。先在图形界面中切换为可用的国内镜像，示例使用华为云 Ubuntu 镜像。

1.点击桌面左下角的“显示应用程序”按钮，进入应用列表。

2.在应用列表中打开“软件和更新”。

3. 在“Ubuntu 软件”页面，将“下载自”切换为国内镜像。图中示例为华为云，完成后关闭窗口。

三、安装 Node.js 18.x LTS

Claude Code 运行需要 Node.js 与 npm。先更新系统软件，再安装基础环境，最后检查版本。

# 更新系统软件源并升级已安装软件
sudo apt update && sudo apt upgrade -y

# 安装 Node.js 与 npm
sudo apt install nodejs npm -y

# 验证安装是否成功（Node.js 需显示 v18.x）
node -v
npm -v

四、通过 NPM 全局安装 Claude Code

基础环境确认无误后，使用 NPM 全局安装官方 Claude Code。安装完成后，系统任意目录均可调用 claude 命令。

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

五、配置环境变量接入 DeepSeek

Claude Code 默认使用官方接口。下面通过修改 bash 环境变量，将接口地址和密钥切换为 DeepSeek。开始前请准备好自己的 DeepSeek API Key。

1. 打开环境变量配置文件

nano ~/.bashrc

2. 在文件末尾写入 DeepSeek 配置

滑动到文件最底部，粘贴以下配置，并将“你的 DeepSeek_API_KEY”替换为自己的密钥：

# 对接 DeepSeek 模型接口
export ANTHROPIC_BASE_URL=https://api.deepseek.com

# 替换为你的个人 DeepSeek API 密钥
export ANTHROPIC_API_KEY=你的 DeepSeek_API_KEY

# 默认使用 deepseek-chat 模型
export DEFAULT_MODEL=deepseek-chat

3. 保存并退出

依次按下：Ctrl + O（保存）→ Enter（确认）→ Ctrl + X（退出）。

4. 重新加载环境变量

source ~/.bashrc

六、启动并验证 DeepSeek 接入

完成环境变量配置后，在终端执行：

claude

启动后无报错并且可以正常对话，即表示 Claude Code 已成功接入 DeepSeek。

Windows 系统部署教程

一、教程简介

本文整理 Windows 环境下 Claude Code 的安装与配置流程，通过接入 DeepSeek API 实现 AI 辅助编程。

二、准备环境

本教程基于 Windows 10 / Windows 11 系统完成部署，需要科学上网工具。开始前准备以下内容：

• Windows 10 或 Windows 11 系统
• js 运行环境
• Release CC Switch v3.19.1 · farion1231/cc-switch · GitHub
• DeepSeek API Key

三、安装并检查 Node.js

Claude Code 运行需要 Node.js 环境。先完成 Node.js 安装，然后打开 CMD 执行：

node -v
npm -v

两条命令都能正常显示版本号，说明 Node.js 和 npm 已安装成功。

四、安装 Claude Code

在命令提示符中执行以下命令：

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

五、下载并安装 CC Switch

Claude Code 安装完成后，进入 CC Switch 的 GitHub Release 页面下载 Windows 安装包。下载时一定要选择 Windows 版本。

六、在 CC Switch 中添加 DeepSeek 路由

1.安装完成后启动 CC Switch，点击界面右上角的“+”号添加路由。

2.在供应商列表中找到并选择 DeepSeek。

3.下滑找到 API Key 输入框，在 DeepSeek 官网获取 API Key 后复制粘贴到对应位置，然后完成添加。

七、启动测试

完成路由配置后，打开 命令提示符，执行：

claude

如果能够进入交互界面并正常发送消息，则说明 Windows 环境配置成功。