如何在 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.com和claude.ai的互联网连接 - Claude 订阅——Pro($20/月)、Max($100-200/月)、Teams 或 Enterprise。免费的 Claude.ai 计划不包含 Claude Code 访问权限
- 来自 console.anthropic.com 的 API 密钥(可选,用于基于 API 的身份验证)
方法一:原生安装器(推荐)
Anthropic 现在发布了一个无需任何依赖的原生 Linux 安装器。这是最干净的方式,并且会在后台自动更新。
curl -fsSL https://claude.ai/install.sh | bash就这样。脚本将 claude 二进制文件放置在 ~/.local/bin/claude,并将版本化二进制文件存储在 ~/.local/share/claude/versions/ 中以支持回滚。
如果安装后找不到 claude,你的 PATH 可能不包含 ~/.local/bin。修复方法:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc验证安装:
claude --version预期输出:2.x.xxx (Claude Code)。
方法二:官方 APT 仓库
Anthropic 还发布了一个签名的 APT 仓库,适合希望通过常规 apt upgrade 工作流获取更新的用户。如果你集中管理软件包,这是个很好的选择。
# 添加仓库和签名密钥
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检查版本:
claude --version方法三:npm 全局安装(传统方式)
如果你更喜欢 npm 或已安装了 Node.js 18+,可以通过 npm 安装。Claude Code 以 @anthropic-ai/claude-code 发布。
Ubuntu 26.04 默认的 Node.js 可用,但如需最新的 LTS 版本(Node.js 24),请使用 NodeSource:
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo bash -
sudo apt install -y nodejs然后全局安装:
sudo npm install -g @anthropic-ai/claude-code
which claude
claude --version这会立即将 claude 添加到你的 PATH 中。
身份验证
首次运行 claude 时,它会打开浏览器窗口进行 OAuth 身份验证。在无头服务器上,请使用:
claude login这会打印一个 URL。在任意浏览器中打开它,登录你的 Anthropic 账户,然后授权 CLI。
或者,直接设置 API 密钥:
export ANTHROPIC_API_KEY="sk-ant-..."
claude首次运行
导航到项目目录并启动 Claude Code:
cd ~/your-project
claude首次启动时,Claude Code 会:
- 询问你是否信任当前目录(只读或完全访问)
- 可选地让你选择主题(浅色/深色)
- 提示设置目录级权限(能否读取文件?能否运行命令?)
配置完成后,你就进入了环境。可以试试这样:
What's the top-level structure of this project?卸载
如果使用了原生安装器,删除缓存数据:
rm -rf ~/.claude ~/.claude.json ~/.local/share/claude如果使用了 APT 仓库:
sudo apt purge --autoremove -y claude-code
sudo rm -rf /etc/apt/sources.list.d/claude-code.sources
rm -rf ~/.claude ~/.claude.json如果使用了 npm:
sudo npm uninstall -g @anthropic-ai/claude-code总结
Claude Code 已成为许多开发者在 Linux 上工作流程中不可或缺的一部分。原生安装器是在 Ubuntu 26.04 LTS 上最快、最可靠的方式——只需一条 curl 命令即可完成。APT 方法更适合需要跨多台机器集中管理软件包的情况。
无论选择哪种方式,结果都一样:一个驻留在终端中的 AI 编程代理,它能理解你的项目,并且能够实际执行操作,而不仅仅是给出建议。
试试看吧。你可能会惊讶于”让我问问 Claude”成为日常习惯的速度有多快。
评论