Ubuntu离线安装Claude Code接入DeepSeek V4完整教程

前言

Claude Code 是 Anthropic 推出的命令行 AI 编程助手。与 GitHub Copilot、Cursor 等 IDE 插件形态不同，它以终端为核心交互界面，能够直接读取和修改项目文件、执行 shell 命令，并理解整个代码仓库的上下文——这种设计使其特别适合服务器端开发和 DevOps 场景。然而由于其底层需要访问 api.anthropic.com，国内用户在线安装时经常遭遇下载失败的问题。本文将详细介绍如何在 Ubuntu 系统上通过离线方式安装 Claude Code，并借助 CC Switch 工具接入免费的 DeepSeek V4 模型，让你无需翻墙也能顺畅使用 AI 编程助手。

整个过程大约只需 10 分钟，涉及三个核心步骤：离线安装 Node.js 环境、安装 Claude Code、配置 CC Switch 并接入国产大模型。

为什么选择离线安装Claude Code？

在线安装 Claude Code 需要从 GitHub 等海外服务器下载依赖包，国内网络环境下经常出现以下问题：

下载速度极慢：部分依赖包托管在海外 CDN 上，不翻墙几乎无法正常下载
安装中断：网络不稳定导致安装过程中途失败，需要反复重试
版本不一致：多次重试可能导致依赖版本混乱

离线安装的核心思路是：提前从官网下载好所有安装包（Node.js、npm 及 Claude Code 本身），然后在目标机器上依次手动安装。这种方式虽然多了一步准备工作，但胜在稳定可靠，一次成功率极高。

第一步：离线安装Node.js运行环境

Claude Code 以 npm 包形式分发（@anthropic-ai/claude-code），因此依赖 Node.js 生态的模块解析机制运行。Node.js 是基于 Chrome V8 引擎构建的 JavaScript 运行时，npm（Node Package Manager）是其配套的包管理器，也是目前全球最大的开源软件注册表，托管超过 200 万个软件包。

安装时我们选择 LTS（Long Term Support）版本——这是 Node.js 官方推荐用于生产环境的稳定版本，通常提供 30 个月的安全更新支持。离线安装时无需 NVM（Node Version Manager），直接解压预编译的二进制包并配置 PATH 是最简洁可靠的方式，完全不需要编译源码。

解压并配置Node.js环境变量

将提前下载好的 Node.js 安装包（本文使用的版本为 v84.15.0 对应的 LTS 版本）复制到 Ubuntu 系统中，解压到目标目录后，需要配置环境变量使其全局可用。

Node.js环境配置完成

具体操作流程：

将安装包解压到指定目录
编辑 ~/.bashrc 或 ~/.profile 文件，添加 Node.js 的 bin 路径到 PATH 环境变量
使用 Ctrl+O 保存配置文件
执行 source ~/.bashrc 使配置生效

注意：环境变量配置是整个流程的关键基础。若 PATH 未正确包含 Node.js 的 bin 目录，后续所有依赖 node 和 npm 命令的步骤都将失败。

验证Node.js安装结果

配置生效后，执行以下命令验证安装是否成功：

node -v
npm -v

如果能正确显示版本号，说明 Node.js 环境已经就绪。

第二步：通过npm安装Claude Code

Node.js 环境准备好之后，就可以安装 Claude Code 了。这一步需要通过 npm 从网络下载 Claude Code 包，好消息是这个步骤不需要翻墙，只是网速可能稍慢。

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

安装完成后，在终端中输入 claude 启动 Claude Code。

Claude Code启动界面

如果看到 Claude Code 的交互界面正常弹出，说明安装成功。界面中可能会显示连接模型失败的提示，这是正常现象——因为 Claude Code 原生指向 Anthropic 官方 API 服务器，我们还没有完成模型后端的重定向配置，接下来通过 CC Switch 来解决这个问题。

第三步：安装CC Switch并接入DeepSeek V4

CC Switch 是一个模型切换工具，其工作原理是通过修改 Claude Code 的环境变量（如 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY），将原本指向 Anthropic 官方服务器的 API 请求重定向到第三方兼容接口。由于硅基流动等平台提供了与 Anthropic API 格式兼容的接口规范，Claude Code 无需任何代码修改即可无缝切换模型后端。这种「API 兼容层」设计在 AI 工具生态中已成为主流模式，使得一个客户端工具可以对接数十种不同的模型服务。

安装CC Switch工具

将提前下载好的 CC Switch 的 .deb 安装包放到系统中，执行安装命令：

sudo dpkg -i ccswitch_xxx.deb

如果安装过程中出现依赖缺失的错误，可以通过以下命令修复：

sudo apt-get install -f

修复依赖后重新执行安装命令即可。安装成功后可以在应用列表中找到 CC Switch 并打开。

获取硅基流动API密钥

硅基流动（SiliconFlow）是国内领先的大模型推理云平台，专注于提供高性价比的模型 API 服务，支持 DeepSeek、Qwen、GLM 等主流国产大模型的在线推理。平台为新注册用户提供免费 Token 额度，是国内开发者以零成本接入顶级代码模型的低门槛路径。获取 API 密钥的步骤如下：

访问硅基流动官网，使用手机号和验证码登录
首次登录需完成实名认证
认证完成后系统会赠送代金券，即可免费使用
进入 API 管理页面，点击「创建新密钥」
复制生成的 API Key

CC Switch配置界面

配置DeepSeek V4模型接入

打开 CC Switch，将复制的 API 密钥填入硅基流动的配置项中。模型选择方面，推荐使用 DeepSeek V4——这是深度求索公司推出的混合专家架构（MoE）模型，在代码生成、数学推理等基准测试中表现优异，部分指标接近 GPT-4o 水平，且推理成本显著低于同级别闭源模型，非常适合作为 Claude Code 的后端引擎。

配置时需注意以下几点：

部分旧模型可能已下架，检测时会提示「模型不存在」
可以进入硅基流动的「模型广场」查看当前可用模型
复制 DeepSeek V4 的完整模型名称填入配置

配置完成后点击「检测」按钮，如果显示连接正常，说明配置成功。

模型检测通过

第四步：验证Claude Code使用效果

一切配置就绪后，重新打开 Claude Code 终端。此时界面上应该能看到已经切换到 DeepSeek V4 模型。选择工作目录后即可开始使用，尝试输入一个简单的编程问题进行测试，如果模型能正常回复，说明整个环境已经搭建成功。

方案总结与注意事项

安装组件清单

组件	用途	安装方式
Node.js + npm	运行环境	离线安装
Claude Code	AI 编程助手	npm 在线安装（无需翻墙）
CC Switch	模型切换工具	deb 包离线安装

常见问题与注意事项

系统快照：建议在安装前对 Ubuntu 系统做一个快照，方便出问题时回滚
模型选择：硅基流动的模型会不定期更新，如果某个模型检测失败，去模型广场确认是否仍然可用
免费额度：硅基流动赠送的代金券额度有限，日常轻度使用基本够用，重度使用需考虑付费
环境变量：离线安装 Node.js 后务必确认环境变量配置正确，否则后续步骤都会失败

通过这套方案，国内开发者可以在不翻墙的前提下，以零成本体验 Claude Code 的 AI 编程能力，同时借助 DeepSeek V4 等国产大模型获得高质量的代码生成和分析服务。

核心要点

采用离线安装方式在Ubuntu上部署Claude Code，避免因网络问题导致安装失败
通过CC Switch工具修改API端点环