Claude Code 是 Anthropic 推出的终端 AI 编程助手。它能理解你的整个代码库，编辑文件、执行 git 操作、调试、写文档——全部通过自然语言完成。
本文覆盖 Ubuntu 下的所有安装方式，从零基础到进阶用户都适用。
1. 环境要求
开始之前，确认你的系统满足以下条件：
| 要求 | 最低配置 |
|---|---|
| Ubuntu | 20.04 及以上 |
| 内存 | 4 GB+ |
| 处理器 | x64 或 ARM64 |
| 网络 | 需要互联网连接 |
| 终端 | Bash 或 Zsh |
| Node.js | 18.0+（仅 npm 安装方式需要） |
同时需要你在 Anthropic 支持的国家/地区内。
2. 安装方式
方式一：原生安装（推荐）
官方提供的一键安装脚本，安装后会自动在后台更新，始终保持在最新版本。
curl -fsSL https://claude.ai/install.sh | bash
脚本运行完毕后即安装完成。启动 Claude Code：
claude
提示： 想先看看脚本内容？可以先 pipe 到
less预览：curl -fsSL https://claude.ai/install.sh | less
方式二：npm（通用方案）
如果你已经有 Node.js 环境，npm 是最灵活的方式，同样适用于 macOS 和 WSL。
# 如果还没有 Node.js 18+，先安装
# curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
# sudo apt install -y nodejs
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version
后续升级：
npm install -g @anthropic-ai/claude-code@latest
⚠️ 不要用
npm update -g——它会遵循原始安装时的 semver 范围，可能不会拉到最新版本。
方式三：APT（Debian/Ubuntu 包管理器）
如果你偏好系统级包管理，可以添加 Anthropic 的官方 APT 源：
# 添加 Anthropic 的 GPG 密钥和仓库
curl -fsSL https://apt.anthropic.com/apt.anthropic.com.gpg.key | \
sudo gpg --dearmor -o /usr/share/keyrings/anthropic.gpg
echo "deb [signed-by=/usr/share/keyrings/anthropic.gpg] https://apt.anthropic.com stable main" | \
sudo tee /etc/apt/sources.list.d/anthropic.list
# 安装
sudo apt update
sudo apt install claude-code
方式四：Homebrew
如果你在 Linux 上使用 Homebrew：
brew install --cask claude-code
Homebrew 提供两个版本通道：
claude-code—— 稳定通道（比最新版慢约一周，跳过重大回退版本）claude-code@latest—— 最新通道，发布即更新
3. 认证登录
首次运行时，Claude Code 会要求认证。有两种方式：
OAuth 登录（推荐）
claude
终端会输出一次性验证码并自动打开浏览器，按提示关联你的 Anthropic 账户。完成后，后续启动无需再登录。
API Key
如果你有 API Key，设置环境变量即可：
export ANTHROPIC_API_KEY="sk-ant-..."
# 或者写入 shell 配置文件持久化
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.bashrc
然后启动：
claude --dangerously-skip-permissions
4. 初次使用
进入你的项目目录后启动：
cd ~/my-project
claude
Claude Code 会自动扫描代码库，然后你就可以开始对话了。试试这些例子：
5. 升级更新
| 安装方式 | 升级命令 |
|---|---|
| 原生安装 | 自动（后台静默更新） |
| npm | npm install -g @anthropic-ai/claude-code@latest |
| APT | sudo apt update && sudo apt upgrade |
| Homebrew | brew upgrade claude-code |
6. 卸载
| 安装方式 | 卸载命令 |
|---|---|
| 原生安装 | sudo rm -f /usr/local/bin/claude ~/.local/bin/claude |
| npm | npm uninstall -g @anthropic-ai/claude-code |
| APT | sudo apt remove claude-code |
| Homebrew | brew uninstall claude-code |
7. 常见问题
“claude: command not found”
- 原生安装： 检查
~/.local/bin是否在 PATH 中：echo $PATH。如果没有，将export PATH="$HOME/.local/bin:$PATH"添加到~/.bashrc中。 - npm： 运行
npm list -g --depth=0确认全局包已安装。
认证失败
- 确认你所在的地区在 Anthropic 支持列表内。
- 尝试
claude logout后重新运行claude来重新认证。
搜索功能异常
- Claude Code 内置了
ripgrep，但如果搜索失败，手动安装：sudo apt install ripgrep。
通用诊断
claude doctor
运行后会输出安装状态、认证、网络连通性、工具可用性等诊断信息。
总结
| 安装方式 | 适合人群 | 自动更新 |
|---|---|---|
| 原生安装 | 大多数用户，简单快捷 | ✅ |
| npm | Node.js 开发者，灵活可控 | ❌ |
| APT | 偏好系统包管理的用户 | ❌ |
| Homebrew | Homebrew 用户 | ❌ |
对于大多数 Ubuntu 用户，原生安装是最佳选择——一条命令搞定，无需管理依赖，始终最新。选一个适合你工作流的方式，开始写代码吧。