Ubuntu 20.04 安装与使用 Claude Code 的实用教程

本文摘要介绍了在Ubuntu 20.04+系统上安装和使用Claude Code的完整指南。主要内容包括：1) 两种安装方式（官方native installer和apt仓库安装）；2) 登录认证流程；3) 基础使用方法；4) 典型开发场景应用；5) 权限管理与安全建议；6) 常见问题解决方案。文档强调官方推荐使用native installer方式，该方式支持自动更新，同时详细说明了apt安装、

code_pgf

526人浏览 · 2026-05-01 08:30:00

code_pgf · 2026-05-01 08:30:00 发布

Claude Code 官方支持 Ubuntu 20.04+，推荐使用官方 native installer；也可以用 apt 仓库安装。官方要求联网，硬件建议 4GB+ RAM，并支持 Bash/Zsh 等 shell。([Claude][1])

1. 安装前准备

先更新系统并安装常用依赖：

sudo apt update
sudo apt install -y curl ca-certificates git build-essential ripgrep

检查系统版本：

lsb_release -a
uname -m

Claude Code 支持 x64 和 ARM64 处理器；Ubuntu 20.04 满足官方系统要求。([Claude][1])

2. 推荐安装方式：官方 native installer

在 Ubuntu 20.04 终端执行：

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

安装后重新加载 shell：

source ~/.bashrc

如果提示 claude: command not found，把 ~/.local/bin 加到 PATH：

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

验证安装：

claude --version
claude doctor

官方推荐 native install；该方式在 macOS、Linux、WSL 上使用同一个安装命令，并且 native installation 会自动后台更新。([Claude][1])

3. 备选安装方式：apt 仓库安装

如果你更喜欢用 Ubuntu 的包管理方式安装，可以用官方 apt 源：

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

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

验证 GPG key 指纹：

gpg --show-keys /etc/apt/keyrings/claude-code.asc

官方文档要求指纹应为：

31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE

apt 安装不会通过 Claude Code 自己自动更新，而是通过系统升级流程更新：

sudo apt update
sudo apt upgrade claude-code

官方文档列出了 apt 安装命令、签名 key、指纹和升级方式。([Claude][1])

4. 登录 Claude Code

进入任意目录，运行：

claude

首次启动会要求登录。可用的账户类型包括：

Claude Pro / Max / Team / Enterprise
Claude Console 账户
Amazon Bedrock / Google Vertex AI / Microsoft Foundry 等企业云提供方

官方说明：Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 等账户；Claude.ai 免费计划不包含 Claude Code 访问权限。([Claude][1])

如果你在服务器 SSH 环境，没有浏览器弹出，Claude Code 通常会给登录链接或 code。官方说明中提到：浏览器未自动打开时，可以复制登录 URL 到浏览器；如果浏览器显示登录 code，再粘回终端。([Claude][2])

你也可以显式登录：

claude auth login

查看登录状态：

claude auth status --text

退出登录：

claude auth logout

这些 auth 命令在官方 CLI reference 中列出。([Claude][3])

5. 第一次使用

进入你的项目目录：

cd /path/to/your/project
claude

进入交互界面后，可以先让它理解项目：

what does this project do?

或者：

explain the folder structure
where is the main entry point?
what technologies does this project use?

官方 quickstart 也建议从让 Claude Code 理解代码库开始；它会按需读取项目文件，你不必手动把所有代码贴进去。([Claude][4])

6. 常用命令速查

claude

启动交互模式。

claude "explain this project"

带初始问题启动交互模式。

claude -p "explain this function"

一次性提问，输出后退出。

cat logs.txt | claude -p "explain the error"

把文件内容通过管道交给 Claude Code 分析。

claude -c

继续当前目录最近一次会话。

claude -r

恢复历史会话。

claude update

更新 Claude Code。

官方 CLI reference 列出了这些命令，包括交互模式、一次性查询、管道输入、继续/恢复会话、更新、登录状态等。([Claude][3])

7. 典型开发用法

让它读项目

先不要修改代码。请阅读项目结构，总结：
1. 这是一个什么项目
2. 主要入口在哪里
3. 如何启动
4. 如何运行测试

修 bug

登录后页面空白。请检查 auth 相关代码，找出根因，先给我修复计划，不要直接改代码。

实现功能

为用户列表接口增加分页参数 page 和 pageSize。
要求：
1. 保持向后兼容
2. 补充单元测试
3. 运行测试并修复失败项

代码审查

review my changes and suggest improvements

Git 操作

what files have I changed?

commit my changes with a descriptive message

官方 quickstart 中也展示了用自然语言让 Claude Code 查看改动、提交代码、创建分支、解决冲突等 Git 工作流。([Claude][4])

8. 权限与安全习惯

Claude Code 默认在修改文件前会展示改动并请求批准；官方 quickstart 明确说它会在编辑前请求权限，你可以逐项批准，也可以在会话中启用接受全部改动模式。([Claude][4])

建议你这样用：

先分析，不要改代码。给我一个计划，列出要修改的文件。

确认方案后再说：

按这个方案实现。每次修改前让我确认。

不要一上来就使用跳过权限的模式，尤其是在生产仓库、服务器、含密钥的项目里。CLI 里确实有跳过权限相关 flag，但它属于高风险用法。([Claude][3])

9. 建议添加 CLAUDE.md

在项目根目录创建：

touch CLAUDE.md

示例内容：

# Project instructions for Claude Code

## Tech stack
- Ubuntu 20.04
- Python 3.10
- PostgreSQL
- FastAPI

## Commands
- Install deps: pip install -r requirements.txt
- Run tests: pytest
- Run lint: ruff check .
- Start dev server: uvicorn app.main:app --reload

## Rules
- Do not modify database migrations unless explicitly asked.
- Always run tests after changing backend logic.
- Prefer small, reviewable changes.
- Explain risky changes before editing.

Claude Code 支持用户级、项目级、本地级配置；项目中的 CLAUDE.md 或 .claude/CLAUDE.md 可作为项目说明文件使用。官方 settings 文档也说明了用户级、项目级、本地级配置位置和优先级。([Claude][5])

10. 常见问题

`claude: command not found`

执行：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
which claude
claude --version

登录时服务器打不开浏览器

运行：

claude

然后复制终端里的登录链接到你本机浏览器，完成登录后把 code 粘回 SSH 终端。官方认证文档说明了浏览器不自动打开时复制登录 URL，以及需要时把 code 粘回终端的流程。([Claude][2])

想更新 Claude Code

native installer：

claude update

apt 安装：

sudo apt update
sudo apt upgrade claude-code

官方说明 native installation 会自动后台更新；apt/dnf/apk 这类包管理器安装需要通过系统升级流程更新。([Claude][1])

想卸载

native installer：

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

apt 安装：

sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

删除用户配置：

rm -rf ~/.claude
rm -f ~/.claude.json

官方文档给出了 native、apt、npm 等不同安装方式的卸载命令。([Claude][1])

11. 推荐工作流

最稳的用法是：

1. 先让 Claude Code 阅读项目，不改代码
2. 让它输出修改计划
3. 你确认计划
4. 让它实现
5. 让它运行测试、lint、build
6. 你 review diff
7. 再让它 commit

Anthropic 官方最佳实践也推荐“先探索、再计划、再编码”，并强调给 Claude Code 明确的验证方式，比如测试、lint、期望输出或错误日志。([Claude][6])

参考链接：
[1]: https://code.claude.com/docs/en/setup “Advanced setup - Claude Code Docs”
[2]: https://code.claude.com/docs/en/authentication “Authentication - Claude Code Docs”
[3]: https://code.claude.com/docs/en/cli-reference “CLI reference - Claude Code Docs”
[4]: https://code.claude.com/docs/en/quickstart “Quickstart - Claude Code Docs”
[5]: https://code.claude.com/docs/en/settings “Claude Code settings - Claude Code Docs”
[6]: https://code.claude.com/docs/en/best-practices “Best Practices for Claude Code - Claude Code Docs”