AI Agent / 系统课时
在 Linux 上安装
在 Linux 上安装
Linux 上最简单的方式是使用官方原生安装器,它安装到用户目录并支持后台更新。需要由系统包管理器统一维护时,也可以使用签名的软件仓库。本课以 Ubuntu、Debian 常见环境为主,完成安装、权限检查和终端验证。
学习目标
- 使用原生安装器完成 Linux 安装
- 了解 apt 安装与升级方式
- 处理 PATH、权限和依赖问题
安装前检查
官方支持 Ubuntu 20.04 及以上、Debian 10 及以上和 Alpine Linux 3.19 及以上,并要求 x64 或 ARM64、至少 4 GB 内存。先运行:
cat /etc/os-release | sed -n '1,4p'
uname -m
git --version
curl --version | head -n 1预期输出应显示受支持的发行版与版本、x86_64 或 aarch64 等架构,以及 Git、curl 版本。
使用原生安装器
在普通用户终端执行:
curl -fsSL https://claude.ai/install.sh | bash预期结果是命令以退出码 0 完成,并在用户目录中安装启动器。不要为了省事把整个安装命令放到 sudo 下,否则可能造成用户目录文件归属错误。重新打开终端后验证:
command -v claude
claude --version
claude doctor预期输出示例:
/home/<USER>/.local/bin/claude
<VERSION> (Claude Code)
诊断完成;未发现阻断项,或列出明确修复建议原生安装器通常把启动器放在 ~/.local/bin/claude。若命令找不到,确认该目录已加入 PATH。
使用 apt 管理
希望通过系统包管理器安装时,应配置官方签名仓库。以下示例适用于 Ubuntu 和 Debian 的稳定通道:
sudo apt install -y curl gnupg
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
-o /etc/apt/keyrings/claude-code.asc
gpg --show-keys /etc/apt/keyrings/claude-code.asc预期结果是 gpg 显示签名密钥,指纹应由管理员与官方文档当前公布值核对后再继续,不能跳过验证。确认密钥后注册稳定仓库并安装:
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install -y claude-code预期结果是 apt 成功安装 claude-code,随后 claude --version 能打印版本。apt 安装不会由 Claude Code 自身后台升级,后续使用:
sudo apt update
sudo apt upgrade claude-code预期结果是软件包升级成功,或提示已经是仓库中的最新版本。
权限与 PATH 故障
出现 permission denied 时,不要直接对整个主目录执行递归 chmod 或 chown。先检查实际文件归属:
ls -ld "$HOME" "$HOME/.local" "$HOME/.local/bin"
ls -l "$HOME/.local/bin/claude"预期结果是这些路径由当前用户拥有,并具有目录访问和文件执行权限。若此前误用 sudo 造成单个安装目录归属异常,只修复相关目录。
PATH 缺少 ~/.local/bin 时,可在当前 Shell 配置中加入:
export PATH="$HOME/.local/bin:$PATH"这是配置片段。写入 ~/.bashrc 或 ~/.zshrc 后重新加载,并再次运行 claude --version。