如何在 Ubuntu 26.04 LTS (Resolute Raccoon) 上安装 Claude Code

你是否曾盯着终端,想知道如何才能让一个 AI 代理真正”住”进你的项目目录——阅读你的代码、运行你的测试、推送你的提交?这就是 Claude Code,Anthropic 官方 CLI 工具,将 Claude 直接带到你的终端中。它不是给命令行硬套上一个网页聊天界面。它拥有完整的仓库感知能力,能理解你的 Git 历史,运行 Shell 命令,编辑文件,甚至能为复杂任务启动子代理。

截至 2026 年中,Claude Code 已经显著成熟。它现在支持 MCP 服务器钩子(hooks)子代理编排,并兼容最新的 Claude 模型,包括 Opus 4.8 和 Fable 5。好消息是?在 Ubuntu 26.04 LTS 上安装它出奇地简单。

本指南涵盖三种安装方法、身份验证以及快速验证,让你在五分钟内从零开始使用 claude


开始之前

Ubuntu 26.04 LTS (Resolute Raccoon) 于 2026 年 4 月 23 日 发布。它预装了 GNOME 50(仅 Wayland)、systemd 259 以及默认仓库中的 Node.js。Claude Code 需要:

  • 至少 4 GB RAM(较大代码库建议 8 GB)
  • 能够访问 api.anthropic.comclaude.ai互联网连接
  • Claude 订阅——Pro($20/月)、Max($100-200/月)、Teams 或 Enterprise。免费的 Claude.ai 计划包含 Claude Code 访问权限
  • 来自 console.anthropic.comAPI 密钥(可选,用于基于 API 的身份验证)

方法一:原生安装器(推荐)

Anthropic 现在发布了一个无需任何依赖的原生 Linux 安装器。这是最干净的方式,并且会在后台自动更新

Bash
curl -fsSL https://claude.ai/install.sh | bash

就这样。脚本将 claude 二进制文件放置在 ~/.local/bin/claude,并将版本化二进制文件存储在 ~/.local/share/claude/versions/ 中以支持回滚。

如果安装后找不到 claude,你的 PATH 可能不包含 ~/.local/bin。修复方法:

Bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

验证安装:

Bash
claude --version

预期输出:2.x.xxx (Claude Code)


方法二:官方 APT 仓库

Anthropic 还发布了一个签名的 APT 仓库,适合希望通过常规 apt upgrade 工作流获取更新的用户。如果你集中管理软件包,这是个很好的选择。

Bash
# 添加仓库和签名密钥
sudo tee /etc/apt/sources.list.d/claude-code.sources >/dev/null <<EOF
Types: deb
URIs: https://downloads.claude.ai/claude-code/apt/latest
Suites: latest
Components: main
Signed-By:
$(curl -sS https://downloads.claude.ai/keys/claude-code.asc | sed "s/^/ /")
EOF

# 刷新并安装
sudo apt update
sudo apt install -y claude-code

检查版本:

Bash
claude --version

方法三:npm 全局安装(传统方式)

如果你更喜欢 npm 或已安装了 Node.js 18+,可以通过 npm 安装。Claude Code 以 @anthropic-ai/claude-code 发布。

Ubuntu 26.04 默认的 Node.js 可用,但如需最新的 LTS 版本(Node.js 24),请使用 NodeSource:

Bash
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo bash -
sudo apt install -y nodejs

然后全局安装:

Bash
sudo npm install -g @anthropic-ai/claude-code
which claude
claude --version

这会立即将 claude 添加到你的 PATH 中。


身份验证

首次运行 claude 时,它会打开浏览器窗口进行 OAuth 身份验证。在无头服务器上,请使用:

Bash
claude login

这会打印一个 URL。在任意浏览器中打开它,登录你的 Anthropic 账户,然后授权 CLI。

或者,直接设置 API 密钥

Bash
export ANTHROPIC_API_KEY="sk-ant-..."
claude

首次运行

导航到项目目录并启动 Claude Code:

Bash
cd ~/your-project
claude

首次启动时,Claude Code 会:

  1. 询问你是否信任当前目录(只读或完全访问)
  2. 可选地让你选择主题(浅色/深色)
  3. 提示设置目录级权限(能否读取文件?能否运行命令?)

配置完成后,你就进入了环境。可以试试这样:

Bash
What's the top-level structure of this project?

卸载

如果使用了原生安装器,删除缓存数据:

Bash
rm -rf ~/.claude ~/.claude.json ~/.local/share/claude

如果使用了 APT 仓库

Bash
sudo apt purge --autoremove -y claude-code
sudo rm -rf /etc/apt/sources.list.d/claude-code.sources
rm -rf ~/.claude ~/.claude.json

如果使用了 npm

Bash
sudo npm uninstall -g @anthropic-ai/claude-code

总结

Claude Code 已成为许多开发者在 Linux 上工作流程中不可或缺的一部分。原生安装器是在 Ubuntu 26.04 LTS 上最快、最可靠的方式——只需一条 curl 命令即可完成。APT 方法更适合需要跨多台机器集中管理软件包的情况。

无论选择哪种方式,结果都一样:一个驻留在终端中的 AI 编程代理,它能理解你的项目,并且能够实际执行操作,而不仅仅是给出建议。

试试看吧。你可能会惊讶于”让我问问 Claude”成为日常习惯的速度有多快。

最后修改: 2026年7月10日

作者

评论

发表评论

您的邮箱地址不会被公开。