AI Agent / 系统课时

在 Linux 上安装

在 Linux 上安装

Linux 上最简单的方式是使用官方原生安装器,它安装到用户目录并支持后台更新。需要由系统包管理器统一维护时,也可以使用签名的软件仓库。本课以 Ubuntu、Debian 常见环境为主,完成安装、权限检查和终端验证。

学习目标

  • 使用原生安装器完成 Linux 安装
  • 了解 apt 安装与升级方式
  • 处理 PATH、权限和依赖问题

安装前检查

官方支持 Ubuntu 20.04 及以上、Debian 10 及以上和 Alpine Linux 3.19 及以上,并要求 x64 或 ARM64、至少 4 GB 内存。先运行:

bash
cat /etc/os-release | sed -n '1,4p'
uname -m
git --version
curl --version | head -n 1

预期输出应显示受支持的发行版与版本、x86_64 或 aarch64 等架构,以及 Git、curl 版本。

使用原生安装器

在普通用户终端执行:

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

预期结果是命令以退出码 0 完成,并在用户目录中安装启动器。不要为了省事把整个安装命令放到 sudo 下,否则可能造成用户目录文件归属错误。重新打开终端后验证:

bash
command -v claude
claude --version
claude doctor

预期输出示例:

text
/home/<USER>/.local/bin/claude
<VERSION> (Claude Code)
诊断完成;未发现阻断项,或列出明确修复建议

原生安装器通常把启动器放在 ~/.local/bin/claude。若命令找不到,确认该目录已加入 PATH。

使用 apt 管理

希望通过系统包管理器安装时,应配置官方签名仓库。以下示例适用于 Ubuntu 和 Debian 的稳定通道:

bash
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 显示签名密钥,指纹应由管理员与官方文档当前公布值核对后再继续,不能跳过验证。确认密钥后注册稳定仓库并安装:

bash
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 自身后台升级,后续使用:

bash
sudo apt update
sudo apt upgrade claude-code

预期结果是软件包升级成功,或提示已经是仓库中的最新版本。

权限与 PATH 故障

出现 permission denied 时,不要直接对整个主目录执行递归 chmod 或 chown。先检查实际文件归属:

bash
ls -ld "$HOME" "$HOME/.local" "$HOME/.local/bin"
ls -l "$HOME/.local/bin/claude"

预期结果是这些路径由当前用户拥有,并具有目录访问和文件执行权限。若此前误用 sudo 造成单个安装目录归属异常,只修复相关目录。

PATH 缺少 ~/.local/bin 时,可在当前 Shell 配置中加入:

bash
export PATH="$HOME/.local/bin:$PATH"

这是配置片段。写入 ~/.bashrc 或 ~/.zshrc 后重新加载,并再次运行 claude --version。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

在 Linux 上安装

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通