Ubuntu 部署 AI agent 指导文档目标在 Ubuntu 虚拟机有图形桌面上安装 Claude Code通过 CC-switch 工具对接 DeepSeek使新环境像 Windows 一样辅助工作。0. 整体原理Claude Code 本质是一个命令行程序CLI默认对接 Anthropic 官方 API。要让它对接 DeepSeek只需把接口地址 密钥 模型名改成 DeepSeek 的即可。CC-switch是图形界面工具它做的事就是帮你写~/.claude/settings.json把配置封装成可视化操作。整套流程 装 Claude CodeCLI装 CC-switchGUI配 DeepSeekAPI Key。你 ──► CC-switch(GUI) ──写入──► ~/.claude/settings.json │ ▼ Claude Code(CLI) ──► DeepSeek API1. 前置准备1.1 检查硬盘空间务必先做df-h/若可用空间 1GB建议先扩容否则装到一半会报空间不足。部署三件套Node.js Claude Code CC-switch约需 500MB建议留出至少 1~2GB 余量。VMware 扩容步骤如果空间不够VMware 关机 → 虚拟机设置 → 硬盘 → 扩展如 20G → 40G开机进 Ubuntu终端执行lsblk# 看 / 分区是哪个通常是 sda3且是最后一块df-h/sudoaptinstall-ycloud-guest-utils# 安装 growpartsudogrowpart /dev/sda3# 把分区号 3 换成你实际的sudoresize2fs /dev/sda3# 扩展文件系统ext4df-h/# 验证容量变大注意仅适用于/是 ext4 且为磁盘最后分区的情况。若是 LVM 或分区布局不同先lsblk看输出再处理。1.2 检查基础工具 curlcurl--version若提示找不到命令 curl先装sudoaptinstall-ycurl2. 安装 Node.js20 LTSClaude Code 依赖 Node.js要求 18推荐 20 LTS。2.1 若 apt 报 404失效 PPA 源执行安装时如果看到类似错误E: 仓库 ... ppa.launchpadcontent.net/ubuntu-desktop/ubuntu-make ... 没有 Release 文件 404 Not Found说明系统里有失效的第三方 PPA 源。先删掉它ls/etc/apt/sources.list.d/# 找出报错的那个 .list 文件sudorm-f/etc/apt/sources.list.d/*ubuntu-make*.list# 按报错源名删sudoaptupdate# 更新应不再报 404原则凡是在apt update里报404 Not Found的源都删掉不影响系统使用。2.2 正式安装curl-fsSLhttps://deb.nodesource.com/setup_20.x|sudo-Ebash-sudoaptinstall-ynodejsnode-v# 应显示 v20.xnpm-v3. 安装 Claude Code3.1 若 npm 下载很慢一直转圈npm 默认走国外源慢是正常的。换国内镜像# 临时指定镜像安装最快sudonpminstall-ganthropic-ai/claude-code--registryhttps://registry.npmmirror.com# 或永久换源以后装任何 npm 包都快sudonpmconfigsetregistry https://registry.npmmirror.comsudonpminstall-ganthropic-ai/claude-code3.2 验证claude--version# 显示类似 2.x.x (Claude Code)若claude找不到重开终端刷新 PATH。4. 安装 CC-switch图形界面4.1 选对架构的安装包Release 页面会有多个.debuname-m# 输出 x86_64 → 下载 CC-Switch-*-Linux-x86_64.deb# 输出 aarch64 → 需要 arm64 版4.2 若访问不了 GitHub下载失败方案 A推荐Windows 下载 VMware 共享文件夹传过去Windows 浏览器打开github.com/farion1231/cc-switch→ Releases下载 对应架构 的.deb放到 VMware 共享文件夹对应的 Windows 目录注Ubuntu虚拟机与Windows物理机之间共享文件夹的设置方法请自行上网搜索本篇不再赘述。Ubuntu 里cd/mnt/hgfs/Applications# 你的共享文件夹路径ls-laCC-Switch*.deb# 确认能看到sudodpkg-iCC-Switch-*-Linux-x86_64.debsudoapt-getinstall-f# 若提示依赖错误方案 B给下载链接加 GitHub 加速前缀如https://ghproxy.com/ 原链接。4.3 启动按Super 键搜 “CC Switch” 启动或终端运行cc-switch。5. 准备 DeepSeek API Key浏览器打开https://platform.deepseek.com/注册 / 登录 → API keys 页面 → 创建 API key只显示一次复制保存先充值10~50 元否则调用时报402 Insufficient Balance6. 在 CC-switch 中配置 DeepSeek打开 CC-switch → 点「」添加供应商「预设 / Provider」选DeepSeek自动填好地址填 API Key → 添加回首页点该供应商的「启用 / Use」配置项值Base URLhttps://api.deepseek.com/anthropic认证字段ANTHROPIC_AUTH_TOKEN填 API Key主模型deepseek-v4-pro或deepseek-v4-pro[1m]轻量模型deepseek-v4-flash模型名以 DeepSeek 官方文档最新为准。7. 跳过 Claude Code 首次引导关键否则 Claude Code 会尝试连 Anthropic 官方启动报错。方法一CC-switch「设置 → 通用」开启「跳过 Claude Code 初次安装确认」。方法二手动写配置echo{hasCompletedOnboarding: true}~/.claude.json8. 验证cd~/Desktopmkdirclaude-testcdclaude-test claude输入测试问题能收到 DeepSeek 回复即成功 ✅9. 常见问题汇总问题原因解决找不到命令 curl精简镜像没装 curlsudo apt install -y curlapt 报404 Not Found失效 PPA 源删/etc/apt/sources.list.d/里对应.listnpm 一直转圈国外源慢换registry.npmmirror.comGitHub 打不开网络无法访问 GitHubWindows 下载 共享文件夹或 ghproxy 加速装错 .deb 架构分不清 arm64/x86_64uname -m确认空间不足20G 太小VMware 扩盘 growpart resize2fs402 Insufficient BalanceDeepSeek 余额不足platform.deepseek.com 充值Unable to connect to Anthropic没跳过引导 / Base URL 错做第 7 步核对 Base URLclaude: command not foundPATH 未刷新重开终端配置不生效终端没重启重开终端再claudeCC-switch 打不开依赖缺失sudo apt-get install -f附方法二纯命令行headless 备用无桌面环境时不用 CC-switch直接配环境变量cat~/.bashrcEOF export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN你的DeepSeek_API_Key export ANTHROPIC_MODELdeepseek-v4-pro export ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro export ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro export ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash EOFsource~/.bashrc再做第 7 步跳过引导和第 8 步验证。效果与 CC-switch 完全相同。 Ubuntu 部署 AI agent 指导文档
Ubuntu 部署 AI agent 指导文档目标在 Ubuntu 虚拟机有图形桌面上安装 Claude Code通过 CC-switch 工具对接 DeepSeek使新环境像 Windows 一样辅助工作。0. 整体原理Claude Code 本质是一个命令行程序CLI默认对接 Anthropic 官方 API。要让它对接 DeepSeek只需把接口地址 密钥 模型名改成 DeepSeek 的即可。CC-switch是图形界面工具它做的事就是帮你写~/.claude/settings.json把配置封装成可视化操作。整套流程 装 Claude CodeCLI装 CC-switchGUI配 DeepSeekAPI Key。你 ──► CC-switch(GUI) ──写入──► ~/.claude/settings.json │ ▼ Claude Code(CLI) ──► DeepSeek API1. 前置准备1.1 检查硬盘空间务必先做df-h/若可用空间 1GB建议先扩容否则装到一半会报空间不足。部署三件套Node.js Claude Code CC-switch约需 500MB建议留出至少 1~2GB 余量。VMware 扩容步骤如果空间不够VMware 关机 → 虚拟机设置 → 硬盘 → 扩展如 20G → 40G开机进 Ubuntu终端执行lsblk# 看 / 分区是哪个通常是 sda3且是最后一块df-h/sudoaptinstall-ycloud-guest-utils# 安装 growpartsudogrowpart /dev/sda3# 把分区号 3 换成你实际的sudoresize2fs /dev/sda3# 扩展文件系统ext4df-h/# 验证容量变大注意仅适用于/是 ext4 且为磁盘最后分区的情况。若是 LVM 或分区布局不同先lsblk看输出再处理。1.2 检查基础工具 curlcurl--version若提示找不到命令 curl先装sudoaptinstall-ycurl2. 安装 Node.js20 LTSClaude Code 依赖 Node.js要求 18推荐 20 LTS。2.1 若 apt 报 404失效 PPA 源执行安装时如果看到类似错误E: 仓库 ... ppa.launchpadcontent.net/ubuntu-desktop/ubuntu-make ... 没有 Release 文件 404 Not Found说明系统里有失效的第三方 PPA 源。先删掉它ls/etc/apt/sources.list.d/# 找出报错的那个 .list 文件sudorm-f/etc/apt/sources.list.d/*ubuntu-make*.list# 按报错源名删sudoaptupdate# 更新应不再报 404原则凡是在apt update里报404 Not Found的源都删掉不影响系统使用。2.2 正式安装curl-fsSLhttps://deb.nodesource.com/setup_20.x|sudo-Ebash-sudoaptinstall-ynodejsnode-v# 应显示 v20.xnpm-v3. 安装 Claude Code3.1 若 npm 下载很慢一直转圈npm 默认走国外源慢是正常的。换国内镜像# 临时指定镜像安装最快sudonpminstall-ganthropic-ai/claude-code--registryhttps://registry.npmmirror.com# 或永久换源以后装任何 npm 包都快sudonpmconfigsetregistry https://registry.npmmirror.comsudonpminstall-ganthropic-ai/claude-code3.2 验证claude--version# 显示类似 2.x.x (Claude Code)若claude找不到重开终端刷新 PATH。4. 安装 CC-switch图形界面4.1 选对架构的安装包Release 页面会有多个.debuname-m# 输出 x86_64 → 下载 CC-Switch-*-Linux-x86_64.deb# 输出 aarch64 → 需要 arm64 版4.2 若访问不了 GitHub下载失败方案 A推荐Windows 下载 VMware 共享文件夹传过去Windows 浏览器打开github.com/farion1231/cc-switch→ Releases下载 对应架构 的.deb放到 VMware 共享文件夹对应的 Windows 目录注Ubuntu虚拟机与Windows物理机之间共享文件夹的设置方法请自行上网搜索本篇不再赘述。Ubuntu 里cd/mnt/hgfs/Applications# 你的共享文件夹路径ls-laCC-Switch*.deb# 确认能看到sudodpkg-iCC-Switch-*-Linux-x86_64.debsudoapt-getinstall-f# 若提示依赖错误方案 B给下载链接加 GitHub 加速前缀如https://ghproxy.com/ 原链接。4.3 启动按Super 键搜 “CC Switch” 启动或终端运行cc-switch。5. 准备 DeepSeek API Key浏览器打开https://platform.deepseek.com/注册 / 登录 → API keys 页面 → 创建 API key只显示一次复制保存先充值10~50 元否则调用时报402 Insufficient Balance6. 在 CC-switch 中配置 DeepSeek打开 CC-switch → 点「」添加供应商「预设 / Provider」选DeepSeek自动填好地址填 API Key → 添加回首页点该供应商的「启用 / Use」配置项值Base URLhttps://api.deepseek.com/anthropic认证字段ANTHROPIC_AUTH_TOKEN填 API Key主模型deepseek-v4-pro或deepseek-v4-pro[1m]轻量模型deepseek-v4-flash模型名以 DeepSeek 官方文档最新为准。7. 跳过 Claude Code 首次引导关键否则 Claude Code 会尝试连 Anthropic 官方启动报错。方法一CC-switch「设置 → 通用」开启「跳过 Claude Code 初次安装确认」。方法二手动写配置echo{hasCompletedOnboarding: true}~/.claude.json8. 验证cd~/Desktopmkdirclaude-testcdclaude-test claude输入测试问题能收到 DeepSeek 回复即成功 ✅9. 常见问题汇总问题原因解决找不到命令 curl精简镜像没装 curlsudo apt install -y curlapt 报404 Not Found失效 PPA 源删/etc/apt/sources.list.d/里对应.listnpm 一直转圈国外源慢换registry.npmmirror.comGitHub 打不开网络无法访问 GitHubWindows 下载 共享文件夹或 ghproxy 加速装错 .deb 架构分不清 arm64/x86_64uname -m确认空间不足20G 太小VMware 扩盘 growpart resize2fs402 Insufficient BalanceDeepSeek 余额不足platform.deepseek.com 充值Unable to connect to Anthropic没跳过引导 / Base URL 错做第 7 步核对 Base URLclaude: command not foundPATH 未刷新重开终端配置不生效终端没重启重开终端再claudeCC-switch 打不开依赖缺失sudo apt-get install -f附方法二纯命令行headless 备用无桌面环境时不用 CC-switch直接配环境变量cat~/.bashrcEOF export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN你的DeepSeek_API_Key export ANTHROPIC_MODELdeepseek-v4-pro export ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro export ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro export ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash EOFsource~/.bashrc再做第 7 步跳过引导和第 8 步验证。效果与 CC-switch 完全相同。