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 建主機時，image 要選 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 的家目錄。