麒麟电脑跑通 Claude Code 踩坑记录

在国产环境中，很多终端默认使用银河麒麟桌面操作系统。对不少开发和测试人员来说，最现实的问题不是“Claude Code 强不强”，而是：它能不能在麒麟电脑上真正装起来、跑起来、用起来。

这次我用麒麟电脑做了一次实际测试。设备环境如下：

• 操作系统：银河麒麟桌面操作系统 V10（SP1）

• 内核版本：Linux 4.19.71-23-kr990

• 模型接入条件：已配置移动的 coding plan

最终结果是：可以跑通。

从成功启动后的界面来看，Claude Code 已正常打开，模型位置显示为 cm-code-latest，说明客户端、认证参数和模型接口已经完成连通。

图 1：Claude Code 在银河麒麟桌面操作系统 V10（SP1）中的运行界面（网站版已移除微信外链图片，避免出现“未经允许不可引用”的防盗链提示）。

不过，整个过程并不是“安装即成功”，中间主要踩了两个比较典型的坑。

一、问题一：Node.js 版本过低，npm 全局安装权限不足

Claude Code 对 Node.js 运行环境有要求，Node.js 版本需要不低于 18.0.0。而在银河麒麟这类办公系统中，默认软件源提供的版本通常偏旧，直接通过系统默认方式安装，很容易卡在版本门槛上。

另一个常见问题是：npm 全局安装权限不足。很多人第一反应会使用 sudo npm install -g 强行安装，但这种做法并不推荐，因为它非常容易带来以下问题：

• 用户目录和系统目录权限混乱

• 后续升级或卸载异常

• nvm 与系统 node 环境相互冲突

二、问题二：首次启动时的地区验证与配置文件

即使安装完成，Claude Code 也未必能直接进入正常可用状态。第二个主要问题出现在首次启动阶段的地区验证 / 初始化校验。

1. 跳过 onboarding 校验

echo '{ "hasCompletedOnboarding": true }' > ~/.claude.json

这一步的作用，是让程序认为本机已经完成初始化引导。

2. 创建配置目录

mkdir -p ~/.claude

3. 写入环境配置

接着写入配置文件，把认证参数、模型地址和模型名配置进去：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API Key",
    "ANTHROPIC_BASE_URL": "https://zhenze-huhehaote.cmecloud.cn/api/coding",
    "ANTHROPIC_MODEL": "cm-code-latest"
  }
}

几个关键参数的含义如下：

• ANTHROPIC_AUTH_TOKEN：接口鉴权所需的 API Key

• ANTHROPIC_BASE_URL：实际调用的服务地址

• ANTHROPIC_MODEL：指定模型，这里使用的是 cm-code-latest

这一步处理完成后，客户端才能真正接入到可用模型，而不是停留在“装好了但用不了”的状态。

三、最终验证结果

全部配置完成后，Claude Code 已能够正常启动。界面上可以明确看到：

• 应用窗口正常打开

• 当前模型显示为 cm-code-latest

• 已具备基本对话与使用能力

这说明至少在当前测试环境下，银河麒麟桌面操作系统 V10（SP1）上运行 Claude Code 是可行的。

四、经验总结

对于已经具备移动 coding plan 或相关模型接入能力的用户来说，在银河麒麟电脑上体验 Claude Code 并不是一件做不到的事。真正需要注意的，是避开系统默认安装路径里的几个坑，尤其是：

• Node.js 版本问题

• npm 权限问题

• 首次启动校验与配置问题

把这些环节处理好后，Claude Code 就能在麒麟电脑上真正跑起来。