Claude Code ARM64 安装：Oracle Ampere A1 跑得动吗？兼容性、内存与常见错误

我的 Claude Code 运行在 Oracle Cloud 的 Ampere A1 主机上，操作系统是 Ubuntu 24.04，架构是 ARM64（aarch64）。这篇整理 Claude Code ARM64 的官方支持范围，以及我在 A1 上安装、常驻运行时要注意的地方。

先说结论：Claude Code 官方支持 ARM64，Linux 支持 Ubuntu 20.04 以上，硬件要求是 4 GB 以上内存。 安装命令和 x64 一样，用官方安装脚本即可。我在 Ampere A1 上用这种方式装好了 Claude Code，也成功把 Remote Control 做成了常驻服务。要注意的是内存规划、装在哪个用户下，以及自动更新后服务要重启。

本文是我 2026 年 10 月在 Oracle Cloud 部署时的记录，加上对 Claude Code 官方文档的整理（Advanced setup、Troubleshoot installation，2026 年 10 月 12 日查阅）。支持的平台和安装方式可能变动，以官方最新说明为准。用户名都换成了 project-a 这类示例。

Claude Code ARM64 的官方支持范围

官方系统要求和我的 Ampere A1 环境对照：

项目	官方系统要求	我的环境
处理器	x64 或 ARM64	Ampere A1（aarch64）
操作系统	macOS 13.0+、Windows 10 1809+ 或 Windows Server 2019+、Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+	Ubuntu 24.04
内存	4 GB 以上	视 A1 配置而定，见后面的内存规划
网络	需要互联网连接	Oracle 主机的对外连接
Shell	Bash、Zsh、PowerShell 或 CMD	Bash
所在地	Anthropic 支持的国家和地区	—

官方列出的预编译平台包含 linux-arm64 和 linux-arm64-musl，也就是普通 Linux（glibc）和 Alpine 这类 musl 系统的 ARM64 都有对应版本。搜索用的 ripgrep 通常已经内置在 Claude Code 里。

Claude Code 本身还需要 Pro、Max、Team、Enterprise 或 Console 账号，免费的 claude.ai 方案不包含 Claude Code。要用 Remote Control，则限 Pro、Max、Team、Enterprise 方案，不支持 API key。

我这台主机的实际配置

写这篇的时候，Jason Finance 的 Claude Code 就运行在一台 Oracle Ampere A1 主机上。2026 年 10 月 12 日在主机上查到的状态：

项目	实际状态	怎么查
CPU 架构	`aarch64`（ARM64）	`uname -m`
系统	Ubuntu 24.04.5 LTS	`cat /etc/os-release`
CPU 与内存	2 核、约 12 GB	`nproc`、`free -h`
swap	4 GB 的 `/swapfile`	`swapon --show`
Claude Code	2.1.296，用官方安装脚本装在 `~/.local/bin/claude`	`claude --version`、`which claude`
常驻方式	systemd 服务运行 `claude remote-control`	`systemctl --user status`

平时开着 Remote Control、同时做构建和测试，内存大约用掉 2 GB 多，其余大多是系统缓存。这只是我这台主机某一天的状态，不代表你的用量。

安装前先确认架构和系统

在 Oracle 创建主机时，镜像要选 Ubuntu 24.04 的 ARM64（aarch64）版本，shape 选 VM.Standard.A1.Flex。创建好后 SSH 进去，先确认：

uname -m       # 预期 aarch64
uname -s       # 预期 Linux
cat /etc/os-release

uname -m 显示 aarch64 就是 ARM64。官方故障排查也提供了确认 C 库的命令，Ubuntu 会显示 GNU libc（glibc）：

ldd --version 2>&1 | head -1

主机怎么创建、遇到 Out of host capacity 怎么办，见《Oracle Out of host capacity 怎么办》。

安装：官方脚本，装在项目用户下

ARM64 不需要另外的命令，官方的原生安装命令同时适用于 macOS、Linux 和 WSL。我是切换到实际要运行 Claude Code 的 Linux 用户再安装，不要用 sudo 装到 root 的主目录：

sudo -iu project-a
curl -fsSL https://claude.ai/install.sh | bash
~/.local/bin/claude --version

claude --version 打印出版本号就是装好了。官方文档提到的几个细节：

安装位置：在 macOS 和 Linux 上，可执行文件放在 ~/.local/bin/claude。如果 shell 提示找不到 claude，说明这个目录不在 PATH 里；安装程序会在输出的 Setup notes: 中提示，但不会自己修改 PATH。在 systemd 服务里，我一律写完整路径 ~/.local/bin/claude，并在 unit 文件的 Environment=PATH= 里加上这个目录。
检查安装状态：claude doctor 不开 session，打印安装健康状态、配置文件校验错误和 Remote Control 资格等诊断。
其他安装方式：官方也提供 apt 软件源和 npm 包（npm 需要 Node.js 22 以上）。我只用过原生安装脚本，其他方式没有实测，要用的话请照官方说明操作。
每个用户各自安装、各自登录：第一次运行 ~/.local/bin/claude 时按界面提示完成登录。不要把别的用户的 ~/.claude/ 复制过来。

完整的主机设置、GitHub 权限和 systemd 常驻步骤，见《Oracle Cloud 运行 Claude Code Remote Control 常驻教程》。

内存规划：4 GB 门槛、A1 额度与 swap

A1 开多大

官方系统要求是 4 GB 以上内存。我在主教程里建议 A1 先从 1 OCPU / 6 GB 或 2 OCPU / 12 GB 开始，两种都在 4 GB 以上。

Oracle 的 A1 免费额度，两份官方文档写法不同（每月 1,500 OCPU 小时、9,000 GB 小时，和 3,000、18,000），我按保守的 2 OCPU、12 GB 规划，实际以账户的 Always Free 标示和账单为准。细节见《Oracle Out of host capacity 怎么办》的额度部分。

安装时被 Killed

官方文档说明，安装需要约 512 MB 可用内存，运行时需要更多。内存不够时，Linux 的 OOM killer 可能中断安装，脚本会显示 Installation was killed before it could finish (exit code 137)。官方建议的处理方法：加 swap、关掉其他进程释放内存，或换大一点的规格。

我的主机加 swap 的做法写在主教程里。swap 不是 RAM，会增加磁盘读写，执行前先用 df -h 确认磁盘空间足够，也不要重复写入 /etc/fstab。

多个服务的内存上限

我在同一台主机上运行多个 Remote Control 服务，每个 systemd 服务都设置了 MemoryHigh=2500M、MemoryMax=3500M。这是每个服务各自的上限，不是整台主机的总量，官方也没有规定单个服务要多少；多个服务同时运行时，要根据主机的实际内存调整。

ARM64 常见错误速查

症状	官方说明的原因	先做什么
`Illegal instruction`	其中一种是架构不匹配，例如在 ARM 主机上拿到 x86 的版本	`uname -m` 确认架构；不匹配时官方建议附上输出到 GitHub 反馈
`Error loading shared library libstdc++.so.6`	下载了不对的版本（glibc 系统拿到 musl 版本，或者反过来）	`ldd --version 2>&1 \| head -1` 确认 C 库，glibc 系统拿到 musl 版本就删除后重装
安装时 `Killed`、exit code 137	内存不足，安装被系统强制终止	加 swap、释放内存或换大一点的规格
`claude: command not found`	`~/.local/bin` 不在 PATH 里	用完整路径 `~/.local/bin/claude`，或把目录加入 PATH

Claude Code 以外的工具也要有 Linux ARM64 版本。下载其他程序的二进制文件时，先确认是 ARM64（aarch64）版，不要直接套用 AMD64 的下载命令；遇到 exec format error，先检查下载的可执行文件的架构，改文件权限解决不了架构不兼容。我在主机上用 Ubuntu 的 apt 安装 git、gh 这类工具，包管理器会装对应架构的版本。

自动更新与常驻服务

官方文档说明，原生安装会在后台自动更新：Claude Code 启动时和运行中会检查更新，下载安装后，要到下一次启动 Claude Code 才生效。在 macOS 和 Linux 上，~/.local/bin/claude 是指向 ~/.local/share/claude/versions/ 的链接。要立即更新，可以运行 claude update。

对常驻的 Remote Control 服务来说，这意味着服务一直运行时，用的仍是启动时的版本，要重启服务才会换成新版。我的建议是在各项目的 Linux 用户下按官方方式更新，一次只重启一个服务，确认日志显示连接成功、手机或网页上能看到环境，再处理下一个，不要一次重启所有服务。

如果是用 apt 软件源安装的，官方说明它不会通过 Claude Code 自动更新，要走系统的升级流程。

服务重启后起不来、systemd 显示 status=1/FAILURE，排查方法见《Claude Code Remote Control exit code 1 怎么办》；systemctl --user 出现 No medium found，见《systemctl –user 出现 No medium found 怎么办》；同一台主机要运行多个环境，见《一台主机运行多个 Claude Code Remote Control》。

常见问题

Claude Code 支持 ARM64 吗？

支持。2026 年 10 月 12 日查阅时，Claude Code 官方系统要求写的是 x64 或 ARM64 处理器、4 GB 以上内存，Linux 支持 Ubuntu 20.04 以上、Debian 10 以上和 Alpine Linux 3.19 以上。官方预编译的版本也包含 linux-arm64。

Oracle 的 Ampere A1 主机能运行 Claude Code 吗？

可以。我的环境是 Oracle Cloud 的 Ubuntu 24.04 aarch64（Ampere A1），用官方安装脚本装好了 Claude Code，并成功启动了 Remote Control。其他操作系统版本要先对照官方的系统要求。

ARM64 主机要用哪个命令安装 Claude Code？

和 x64 一样，用官方的原生安装命令 curl -fsSL https://claude.ai/install.sh | bash，安装后运行 claude --version 确认。建议切换到实际要运行 Claude Code 的 Linux 用户再安装，不要用 sudo 装到 root 的主目录。