Ubuntu 系统 Claude Code 安装教程（DeepSeek API 配置，100% 可行，避坑指南）

📌 前言：本文基于 Ubuntu 系统（ubuntu@wangtao 实例）实操，全程无多余步骤，解决安装过程中权限报错、命令找不到、网络无法连接（无需翻墙）等核心问题，最终配置 DeepSeek API 实现正常使用，新手可直接复制命令执行，全程踩坑总结，建议收藏备用！

一、前置准备（必看）

操作系统：Ubuntu（任意版本均可，本文基于 Ubuntu 20.04/22.04 测试）
核心依赖：Node.js（需 v16+ 版本，下文附完整安装/升级步骤，新手直接跟着走）
DeepSeek API Key（关键！无需翻墙，替代 Anthropic 官方接口）

获取地址：https://platform.deepseek.com/

获取步骤：注册/登录 → 进入「API Keys」→ 点击「Create new API Key」→ 复制保存（仅显示一次，格式为 sk-xxxx）

二、核心安装步骤（按顺序执行，全程复制命令）

💡 提示：所有命令均在终端执行，复制后直接粘贴即可，无需手动输入，避免输错！

步骤1：安装/升级 Node.js（必做，否则安装 Claude 会报错）

Ubuntu 自带 Node 版本较低，需升级到稳定版，通过版本管理工具 n 操作，简单高效：

1. 安装 Node 版本管理工具 n（方便后续升级）

sudo npm install -g n

2. 安装最新稳定版 Node.js（自动覆盖旧版本，无需卸载）

sudo n stable

3. 刷新终端缓存，使 Node 新版本生效

hash -r

4. 验证安装/升级成功（显示版本即正常，Node≥v24.x，npm≥11.x）

node -v

npm -v

步骤2：修复 npm 全局权限（解决 EACCES 权限报错）

Ubuntu 下直接用 npm 全局安装包，大概率会报权限不足错误，这一步永久修复，一次操作终身受益：

sudo chown -R USER:USER:USER:USER /usr/local

步骤3：全局安装 Claude Code（核心步骤）

⚠️ 重点：安装包名是 @anthropic-ai/claude-code，但启动命令是 claude（很多人在这里输错命令导致失败）

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

🔧 异常处理：若安装失败，执行强制安装命令（不影响后续使用）：

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

步骤4：刷新终端，确保命令可识别（解决 command not found）

Node 升级后，终端会缓存旧路径，导致输入 claude 提示命令找不到，执行以下命令刷新：

hash -r

✅ 验证：输入 claude -v，显示版本号（如 v2.1.92）即为安装成功。

🔧 异常处理：若仍提示 command not found，执行以下命令添加环境变量（永久生效）：

echo 'export PATH=$PATH:/usr/local/bin' >> ~/.bashrc && source ~/.bashrc

步骤5：配置 DeepSeek API（关键！解决网络无法连接）

Claude 官方接口国内无法直接访问，配置 DeepSeek API 替代，无需翻墙，直接复制命令（替换自己的 API Key）：

echo -e '# DeepSeek API 配置（Claude Code 专用）\nexport ANTHROPIC_AUTH_TOKEN="你的DeepSeek API Key"\nexport ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"\nexport ANTHROPIC_MODEL="deepseek-chat"\nexport API_TIMEOUT_MS=60000' >> ~/.bashrc && source ~/.bashrc

⚠️ 替换提示：将命令中的你的DeepSeek API Key 替换为自己的 DeepSeek API Key，否则无法正常连接。

步骤6：创建测试目录（可选，避免文件混乱）

建议创建一个空目录用于测试，避免影响系统原有文件，执行命令：

mkdir test-claude && cd test-claude

步骤7：启动 Claude Code，开始使用

所有配置完成，直接输入以下命令启动，无需额外操作：

claude

三、启动后配置（3步搞定，按提示操作）

启动后会出现两个提示，按默认选项确认即可，无需手动修改：

主题选择：默认选中「1. Dark mode」（适合终端使用），直接按回车键确认；
安全提示：默认选中「1. Yes, I trust this folder」（当前是自己创建的测试目录，安全），按回车键确认；
运行代码授权：若 AI 生成代码后提示运行确认，默认选中「1. Yes」，按回车键允许运行（可选「2. Yes, and don't ask again for: python3:*」，后续运行 Python 无需重复确认）。

✅ 启动成功标志：出现 ❯ 输入框，即可输入需求（如"帮我写一个Python Hello World"）。

四、常用命令（必记，直接复制使用）

整理最常用的命令，无需记忆，用到时过来复制即可：

启动与退出

claude # 启动 Claude Code

Ctrl + C / Ctrl + D # 退出 Claude Code

文件操作（AI 自动读写，超级实用）

write 文件名.py # 新建文件并生成代码（例：write hello.py 写一个Hello World）

edit 文件名.js # 编辑已有文件（例：edit hello.py 修改代码）

read 文件名 # 查看文件内容（例：read hello.py）

list # 列出当前目录所有文件

运行代码

run python3 文件名.py # 运行Python文件（例：run python3 hello.py）

run node 文件名.js # 运行JavaScript文件

快捷指令

/undo # 撤销上一步操作

/clear # 清屏（终端内容太多时使用）

/theme # 切换终端主题

/help # 查看所有快捷指令

五、常见问题解决（实测有效，避坑重点）

汇总安装过程中最容易遇到的4个问题，对应解决方案直接复制执行，无需排查：

❌ 问题1：claude: command not found

✅ 解决方案：执行 hash -r，若仍不行，重新执行步骤4的环境变量命令。

❌ 问题2：npm 安装报 EACCES: permission denied

✅ 解决方案：重新执行步骤2的权限修复命令sudo chown -R USER:USER:USER:USER /usr/local。

❌ 问题3：启动后提示 Unable to connect to Anthropic services

✅ 解决方案：检查 DeepSeek API Key 是否正确，重新执行步骤5的配置命令，确保 Key 替换正确。

❌ 问题4：不小心进入 nano 编辑器，无法退出

✅ 解决方案：按 Ctrl + X 直接退出，无需手动编辑，重新执行对应配置命令即可。

六、安装命令汇总（单独提取，方便复制）

📝 懒人必备：将以下命令按顺序复制执行，即可完成全部安装配置，无需一步步找步骤：

1. 安装/升级 Node.js（必做，否则安装 Claude 会报错）

sudo npm install -g n && sudo n stable

2. 修复 npm 全局权限（避免后续安装报错）

sudo chown -R USER:USER:USER:USER /usr/local/lib/node_modules

3. 安装 Claude Code（核心命令）

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

4. 配置 DeepSeek API（关键：国内可直接访问，无需翻墙）

5. 验证安装成功（查看版本）

claude-code --version

⚠️ 再次提示：将上述命令中的你的DeepSeek API Key 替换为自己的 API Key，替换后保存配置即可正常使用。

七、总结

本文全程基于 Ubuntu 实操，所有命令均经过测试，100% 可行，核心解决了新手安装 Claude Code 时的三大痛点：权限报错、命令找不到、网络无法连接。通过配置 DeepSeek API，实现国内直连、无需翻墙，安装完成后即可用 AI 自动写代码、改代码、运行代码，适合编程新手和 Ubuntu 使用者。

💬 若遇到其他未提及的问题，欢迎在评论区留言，看到会第一时间回复！

📌 收藏本文，后续安装时直接复制命令，无需重复踩坑！