在 Surface Pro X (ARM64) 上成功部署 Claude Code 的完整复盘

系统环境 ：Surface Pro X (ARM64) | Windows 11 | MSYS2 ClangARM64 | CLion
最终成果：成功在 MSYS2 终端安装 Claude Code v2.1.77，并通过海外区Apple ID完成付费订阅。

一、前言：为什么这条路不好走？

在 ARM64 设备上安装 Claude Code 并成功付费，确实比在标准 x86 电脑上要曲折一些。

主要挑战来自：

ARM64 兼容性：很多安装脚本和工具需要找到正确的架构版本。
网络环境：Claude 服务对网络有要求，需要稳定的代理。
支付风控：国内发行的信用卡直接支付很容易被风控拦截。
终端环境：MSYS2 作为 Unix-like 环境，与 PowerShell 和 Windows 原生程序的 PATH 需要手动整合。

这份复盘记录了所有踩过的"坑"和最终的解决方案，希望对后来者有参考价值。

二、第一阶段：安装脚本的陷阱与核心依赖的补全

1. 初次尝试：下载错误的 `install_claude.ps1`

操作：在 MSYS2 终端中直接运行 curl 命令下载安装脚本。

curl -fsSL https://claude.ai/install.ps1 | powershell -command-
or
curl -L -o install_claude.ps1 https://claude.ai/install.ps1

结果：下载到了一个 HTML 网页文件（因为IP限制，服务器返回了错误页面），并非真正的 PowerShell 脚本。
教训：不能完全信任命令行下载，需要检查文件内容。

2. 手工下载正确的 `bootstrap.ps1`

操作：

开启"魔法器"，将网络出口切换至 ** （或其他支持Claude的地区），并在 whatismyipaddress.com 确认IP生效。

在浏览器中访问 https://claude.ai/install.ps1，成功下载到 bootstrap.ps1 （大小约 3KB）。

将文件保存至 MSYS2 的home目录：C:\msys64\home\fishy\。
关键点 ：浏览器下载可以携带完整的会话信息，比命令行 curl 更可靠。

3. 执行 `bootstrap.ps1` 失败，暴露依赖缺失

操作：在 PowerShell 中执行 powershell -ExecutionPolicy Bypass -File C:\msys64\home\fishy\bootstrap.ps1。
结果：命令无反应或报错。这暴露了两个核心依赖的缺失：
- Git Bash：Claude Code 依赖其 Unix-like 环境。
- Node.js 和 npm ：bootstrap.ps1 本质上是一个 npm 包的安装引导程序。

4. 补全核心依赖：安装 Git 和 Node.js

Git for Windows (ARM64) ：
- 从官网下载 ARM64 版本的安装包。
- 安装时务必选择 "Git from the command line and also from 3rd-party software"，以便将 Git 添加到系统 PATH。
Node.js (ARM64) ：
- 从官网下载 ARM64 版本的 LTS 安装包。
- 安装后，在新的 PowerShell 窗口中验证 node --version 和 npm --version。
验证：成功显示版本号，说明依赖已就绪。

5. 用 npm 重新安装 Claude Code（这才是正解）

操作：在 PowerShell 中直接使用 npm 进行全局安装。
复制代码
```
npm install -g @anthropic-ai/claude-code
```

结果：

复制代码

added 2 packages in 17s

1 package is looking for funding
  run `npm fund` for details

验证：
复制代码
```
claude --version
```
输出：
复制代码
```
2.1.77 (Claude Code)
```
看似显示version , 但实际这次也没安装成功：

fishy@TABLET-SM7IJ CLANGARM64 /c/users/fishy/clionprojects/untitled00 $ claude

-bash: claude: command not found
关键点 ：前面bootstrap.ps1 安装失败后，无需卸载（因为它可能根本没装上），直接使用 npm 安装是最干净、最可靠的方式。

在 PowerShell 中安装的 npm 全局命令，默认不会被 MSYS2 环境识别。这是因为两个环境有各自独立的 PATH 变量。

三、第二阶段：打通 MSYS2 终端与 Windows 世界的 PATH

1. 问题：在 MSYS2 中找不到 `claude` 和 `node`

现象：在 MSYS2 终端运行 claude --version 报错 -bash: claude: command not found。
原因：MSYS2 的 bash 环境有自己的 PATH 变量，并不知道 Windows 里 npm 和 Node.js 的安装位置。

2. 解决方案：修改 MSYS2 的 `.bashrc` 文件

操作：
1. 在 MSYS2 终端编辑 ~/.bashrc 文件：
  位置：C:\msys64\home\fishy 目录下的.bashrc
  复制代码
```
nano ~/.bashrc
```
2. 在文件末尾添加以下两行，将 Windows 下的 npm 全局路径和 Node.js 路径追加到 PATH 中：
  复制代码
```
# 添加 npm 全局路径，让 MSYS2 能找到 claude
export PATH=$PATH:"/c/Users/fishy/AppData/Roaming/npm"
# 添加 Node.js 路径，让 MSYS2 能找到 node
export PATH=$PATH:"/c/Program Files/nodejs"
```
3. 保存并退出（Ctrl+X -> Y -> Enter）。
4. 重新加载配置使改动生效：
  复制代码
```
source ~/.bashrc
```
验证：
复制代码
```
node --version
```
输出：
复制代码
```
v20.11.0

claude --version
```
输出：
复制代码
```
2.1.77
```
成功标志 ：MSYS2 终端可以正常识别 node 和 claude 命令。

四、第三阶段：攻克付费订阅------巧用海外区 Apple ID + 充值卡

1. 挑战：国内信用卡直接支付被拒

现象：在 Claude 官网或终端授权时，选择订阅 Pro，填写国内中行Visa卡信息后，始终提示 Your card was declined。
原因：Claude 的支付网关对国内发行的卡片有基于BIN段的硬性拦截，与卡内余额无关。

2. 破局方案：走 Apple 内购通道

核心思路：通过海外区 Apple ID 的 App Store 余额进行支付。

3. 具体执行步骤

第一步：准备一个可用的海外区 Apple ID
- 找到并确认一个之前注册的港区账号 *********@gmail.com。
- 关键操作 ：在 iPhone 上，将此账号的"国家/地区"改为海外。更改时需确保网络环境为海外节点，以便在支付方式选项中看到 "None"，成功完成改区。
第二步：为海外区账号充值
- 打开支付宝（将城市切换至"旧金山"）。
- 搜索 "Pockyt Shop" 小程序，购买 $20 美元 的 App Store & iTunes US 礼品卡。
- 支付时，使用已绑定在 Apple Pay 中的中行卡。
- 购买成功后，邮箱（*********@gmail.com）会收到包含 Gift Card Number（16位兑换码）的邮件。
第三步：兑换礼品卡
- 在 iPhone 上，确保 App Store 已登录该美区账号。
- 点击头像 -> "兑换礼品卡或代码" ，手动输入邮件中的 16位 Gift Card Number。
- 兑换成功后，App Store 账户余额显示为 US$20.00。
第四步：通过 Claude App 完成订阅
- 在 iPhone 上（保持海外节点 VPN 开启），从 App Store 下载 Claude by Anthropic 应用。
- 打开 App，使用 *********@gmail.com 登录。
- 进入设置或点击升级 Pro，选择 US$20.00/月 的套餐。
- 系统会调用 Apple 内购，并自动从 App Store 余额中扣款，无需再次输入任何卡片信息。订阅即刻生效。

4. 付费后的收尾

恢复日常设置 ：
1. 关闭手机 "魔法器"。
2. 在 App Store 中，将"媒体与购买项目"的账号换回日常使用的中国区 Apple ID。
重要提醒：不要在 iPhone 的"设置"中登录海外区 Apple ID 的 iCloud，只用于 App Store，以免影响个人数据。

五、最终验证：在 MSYS2 中启动 Claude Code

打开 MSYS2 终端。

进入你的项目目录：

复制代码

cd /c/users/fishy/clionprojects/untitled00

启动 Claude Code：
复制代码
```
claude
```

首次授权 ：

终端会显示登录方式选择界面：

复制代码

Select login method:

❯ 1. Claude account with subscription · Pro, Max, Team, or Enterprise
  2. Anthropic Console account · API usage billing
  3. 3rd-party platform · Amazon Bedrock, Microsoft Foundry, or Vertex AI

直接回车（默认选中 1. Claude account with subscription）。
浏览器会自动打开一个授权页面，点击 "Allow" 或 "确认"。

成功！ ：

终端会出现安全提示：

复制代码

Quick safety check: Is this a project you created or one you trust? (Like your own code, a
well-known open source project, or work from your team). If not, take a moment to review what's in
 this folder first.

Claude Code'll be able to read, edit, and execute files here.

Security guide

❯ 1. Yes, I trust this folder
  2. No, exit

Enter to confirm · Esc to cancel

选择 1. Yes, I trust this folder（直接回车）。
看到 > 提示符，大功告成！现在可以用中文和它交流你的项目了。

六、经验总结与概念速查

概念	简单解释	在这次旅程中的作用
WSL	Windows Subsystem for Linux，在Windows上运行的"迷你Linux"。	一个更彻底的备选方案。如果不在原生Windows环境折腾，装个WSL并在其中安装Claude Code，可以避免很多环境兼容性问题。
API Key	代表你身份的"密码令牌"，用于向Anthropic服务器按使用量付费。	是登录选项中 `2. Anthropic Console account` 的核心。如果我们当初选择这个，就不需要每月付20美元，而是用多少花多少，但需要搞定API Key的申请和中转网络。
PATH	环境变量，告诉操作系统去哪里寻找可执行程序。	整个安装过程中反复遇到的问题核心。无论是Windows的cmd、PowerShell，还是MSYS2的bash，都需要确保 `node` 和 `claude` 命令所在的目录在PATH里。

七、写在最后

这份复盘不仅记录了一次成功的部署，更是一次对 Windows 开发环境、跨平台工具链、以及海外服务支付策略的深度探索。从最初错误的安装脚本，到补全 Git 和 Node.js，再到打通 MSYS2 的 PATH，最后巧用美区 Apple ID 完成支付------每一步都是一次学习。

Next Step:

安装 Claude Code CLI 工具（在你的 MSYS2 终端中）
在 CLion 中启用 MCP 服务器
配置 Claude Code 与 CLion 的连接
设置环境变量（API 密钥等）

在 Surface Pro X (ARM64) 上成功部署 Claude Code 的完整复盘

一、前言：为什么这条路不好走？

二、第一阶段：安装脚本的陷阱与核心依赖的补全

1. 初次尝试：下载错误的 install_claude.ps1

2. 手工下载正确的 bootstrap.ps1

3. 执行 bootstrap.ps1 失败，暴露依赖缺失

4. 补全核心依赖：安装 Git 和 Node.js

5. 用 npm 重新安装 Claude Code（这才是正解）

三、第二阶段：打通 MSYS2 终端与 Windows 世界的 PATH

1. 问题：在 MSYS2 中找不到 claude 和 node

2. 解决方案：修改 MSYS2 的 .bashrc 文件

四、第三阶段：攻克付费订阅------巧用海外区 Apple ID + 充值卡

1. 挑战：国内信用卡直接支付被拒

2. 破局方案：走 Apple 内购通道

3. 具体执行步骤

4. 付费后的收尾

五、最终验证：在 MSYS2 中启动 Claude Code

六、经验总结与概念速查

七、写在最后

1. 初次尝试：下载错误的 `install_claude.ps1`

2. 手工下载正确的 `bootstrap.ps1`

3. 执行 `bootstrap.ps1` 失败，暴露依赖缺失

1. 问题：在 MSYS2 中找不到 `claude` 和 `node`

2. 解决方案：修改 MSYS2 的 `.bashrc` 文件