夜雨聆风你是否遇到过这样的困扰：
看到同事用 AI 工具大幅提升工作效率，自己却只能干着急
听说 Claude Code 是"全球最好的 AI 编程助手"，却因为单位电脑装的是国产麒麟系统而无法使用
尝试过在麒麟系统上安装软件，却总是遇到各种报错
如果你有以上困扰，这篇教程就是为你写的。
经过摸索，我成功在银河麒麟系统 V10（龙芯 3A6000 芯片）上安装并运行了 Claude Code。 以下是完整的操作步骤，按顺序执行即可。
温馨提示：整个过程只需要在"终端"（类似 Windows 的"命令提示符"）中输入指定命令即可。没有复杂的配置，跟着做就能成功。如果遇到问题，把终端里显示的错误信息复制给 DeepSeek，它会帮你分析原因并给出解决方案。
什么是 Claude Code？
Claude Code 是由美国 Anthropic 公司开发的 AI 编程助手，可以帮助你：
编写、修改代码
解答技术问题
自动化重复性工作
分析文档和数据
它就像一个 24 小时在线的编程专家，随时回答你的问题、帮你完成任务。
它和网页版 Claude 有什么区别？
| Claude 网页版 | Claude Code | |
|---|---|---|
| 交互方式 | 在浏览器中对话 | 在终端中对话 |
| 能力范围 | 回答问题、写作 | 直接操作你的电脑文件、运行命令 |
| 使用场景 | 日常问答 | 编程、办公自动化 |
简单来说，Claude Code 可以"动手做事"，而不仅仅是"动嘴回答"。
准备工作：了解你的电脑
认识几个关键概念
在开始之前，先了解一下你会遇到的几个术语：
1. 终端（Terminal）
相当于 Windows 的"命令提示符"（CMD）。一个黑色的窗口，你输入文字命令，电脑执行相应操作。
类比：就像电视剧里黑客用的那个充满代码的屏幕，输入指令来控制电脑。
2. Node.js
一个"JavaScript 运行环境"。可以把 Node.js 理解为"翻译官"——它能理解并执行用 JavaScript 语言写的程序。
类比：如果 Claude Code 是一道菜谱（用 JavaScript 写成），那么 Node.js 就是厨师——只有厨师才能按照菜谱做出一道道菜肴。
3. npm（Node Package Manager）
Node.js 的"应用商店"。用来下载和管理各种基于 Node.js 的工具。
类比：就像手机应用商店用来安装 App 一样，npm 用来安装各种 JavaScript 工具。
4. 软链接（Symbolic Link）
相当于 Windows 的"快捷方式"。一个文件或文件夹的"替身"，点击它可以跳转到真正的文件位置。
类比：就像在桌面创建一个文件夹的快捷方式，双击快捷方式等于双击原文件夹。
银河麒麟系统的特殊之处
银河麒麟系统是基于 Linux 内核开发的国产操作系统，和 Windows、macOS 并称为三大主流操作系统。
主要障碍：很多常用软件（如 Node.js 官方安装包）只提供 Intel/AMD芯片（x86架构）或苹果芯片（ARM 架构）的版本，而龙芯芯片使用的是自主研发的 LoongArch 架构，需要专门适配的版本。
好在龙芯开源社区已经做好了适配工作，我们可以直接使用他们编译好的版本。
1. 安装 Node.js
Node.js 是 Claude Code 运行的基础，必须先安装。
1.1 下载适配龙芯的 Node.js
打开终端，输入以下命令：
cd ~/Downloads
wget https://ftp.loongnix.cn/nodejs/LoongArch/dist/v22.16.0/node-v22.16.0-linux-loong64.tar.xz
wget https://ftp.loongnix.cn/nodejs/LoongArch/dist/v22.16.0/SHASUMS256.txt
命令解释：
cd ~/Downloads：进入"下载"文件夹wget：从网络下载文件
等几秒钟，下载完成后终端会再次出现提示符。
1.2 解压到系统目录
sudo tar -xvf node-v22.16.0-linux-loong64.tar.xz -C /opt/命令解释：
sudo：以管理员权限执行（系统会要求输入密码）tar -xvf：解压文件-C /opt/：解压到 /opt 目录（这是系统级别的目录）
解压完成后，Node.js 被安装到
/opt/node-v22.16.0-linux-loong64/
1.3 创建快捷方式（软链接）
为了让命令可以在任意位置使用，需要创建"快捷方式"：
sudoln-s /opt/node-v22.16.0-linux-loong64/bin/node /usr/local/bin/node
sudoln-s /opt/node-v22.16.0-linux-loong64/bin/npm /usr/local/bin/npm
sudoln-s /opt/node-v22.16.0-linux-loong64/bin/npx /usr/local/bin/npx
sudoln-s /opt/node-v22.16.0-linux-loong64/bin/corepack /usr/local/bin/corepack
命令解释：
ln -s：创建软链接（快捷方式）格式是
ln -s [目标文件] [快捷方式位置]
1.4 验证安装是否成功
node--version
npm--version
如果看到类似下面的输出，说明安装成功：
v22.16.0
10.9.0
2. 安装 Git
Git 是一个"版本控制工具"，可以理解为一个"超级记忆术"——它能记住你对文件的所有修改，随时可以回溯到任何一个历史版本。
2.1 安装 Git
银河麒麟系统使用 apt 作为软件管理工具（相当于应用商店）：
sudo apt update
sudo apt install git-y
命令解释：
apt update：更新软件列表（同步最新软件信息）apt install git -y：安装 Git（-y 表示自动确认）
2.2 验证安装
git--version如果版本低于 2.38，可以跳过下面这一步。
2.3 （可选）升级 Git 版本
如果系统自带的 Git 版本过低，需要从源码编译。这个过程稍微复杂，大约需要 10-15 分钟：
cd ~
wget https://github.com/git/git/archive/refs/tags/v2.43.0.tar.gz
tar -xzf v2.43.0.tar.gz
cd git-2.43.0
make configure
./configure
make
sudomake install
如果你的系统 Git 版本已经是 2.38 或更高，这一步可以跳过。
3. 安装 Claude Code
现在环境准备好了，开始安装 Claude Code。
3.1 配置 npm 用户目录
麒麟系统权限管理比较严格，为了避免权限问题，我们配置 npm 使用用户目录：
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
然后创建软链接让 claude 命令全局可用：
sudoln-s ~/.npm-global/bin/claude /usr/local/bin/claude3.2 切换到国内镜像源
由于网络原因，无法直接从国外下载。我们需要切换到国内镜像：
方案一：龙芯官方镜像（推荐）
npm config set registry https://registry.loongnix.cn:4873方案二：淘宝镜像（更通用）
npm config set registry https://registry.npmmirror.com验证是否切换成功：
npm config get registry3.3 安装 Claude Code
终于到了核心步骤！输入以下命令：
npm install -g @anthropic-ai/claude-code@2.1.112安装过程可能需要 2-5 分钟，耐心等待。
3.4 启动 Claude Code
安装完成后，在终端输入：
claude如果看到 Claude Code 的欢迎界面或提示输入信息，说明安装成功！
4. 配置国产模型（跳过官方认证）
4.1 为什么需要这一步？
Claude Code 默认使用 Anthropic 官方的 Claude 模型，但这需要特殊网络才能连接。在国内网络环境下，我们需要使用国产模型来替代。
这就像：原装配件买不到，只能用国产兼容配件。虽然不是原厂品质，但完全能满足日常使用。
4.2 配置步骤
第一步：安装 nano 编辑器
nano 是一个简单的文本编辑器，用来编辑配置文件：
sudo apt update
sudo apt install nano -y
验证安装：
nano --version第二步：创建配置目录
mkdir-p ~/.claude第三步：配置 MiniMax 模型
nano ~/.claude/settings.minimax.json在编辑器中粘贴以下内容（把 你的MiniMax_API_Key 替换成真实的 API Key）：
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "你的MiniMax_API_Key",
"ANTHROPIC_MODEL": "MiniMax-M2.7",
"ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.7",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.7",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"language": "zh-CN"
}
保存并退出：按 Ctrl+O（保存），按 Enter（确认），再按 Ctrl+X（退出）。
第四步：（可选）配置 GLM 模型
如果你也想用智谱的 GLM 模型：
nano ~/.claude/settings.glm.json粘贴以下内容（把 你的智谱API_Key 替换成真实的 API Key）：
{
"env": {
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "你的智谱API_Key",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"language": "zh-CN"
}
同样按 Ctrl+O 保存，Ctrl+X 退出。
4.3 切换使用的模型
手动复制配置文件即可切换：
切换到 MiniMax：
cp ~/.claude/settings.minimax.json ~/.claude/settings.json切换到 GLM：
cp ~/.claude/settings.glm.json ~/.claude/settings.json切换后，重启 Claude Code（退出后重新输入 claude）即可生效。
5. 关于安全保密问题
使用麒麟系统电脑的单位，通常对信息安全有较高要求。关于 Claude Code，你可以放心：
Claude Code 不上传数据
Claude Code 本身没有自动联网功能，它只是一个工具包
所有数据处理都在本地电脑完成
只有当你主动提问时，才会调用 AI 模型
国产模型同样安全
我们在麒麟系统上使用的是 MiniMax、GLM 等国产模型：
这些模型在国内有正式的商业合作
数据安全和在国内使用豆包、Kimi 等国产 AI 工具是一样的
注意事项
真正需要注意的是：不要在电脑里存储涉密文件。不管用什么 AI 工具，电脑里本身有涉密内容才是最不安全的。
6. 常见问题
| 问题 | 解决方案 |
|---|---|
| 安装时报"权限不足" | 在命令前加 sudo，或按第 3.1 节配置 npm 用户目录 |
| 网络连接失败 | 按第 3.2 节切换到国内镜像源 |
| 不知道 API Key 是什么 | MiniMax 和智谱官网都有免费申请入口，按提示操作即可 |
命令被 kysec 阻止 | 这是安全模块，无需处理，直接用手动复制配置文件的方式切换模型 |
| 终端显示乱码 | 检查系统语言设置，确保是 UTF-8 编码 |
7. 总结
恭喜你！按照以上步骤，你已经成功在麒麟系统上安装了 Claude Code。
现在你可以：
在终端输入
claude启动 AI 助手用自然语言让它帮你写代码、分析文件、解答问题
通过切换配置文件来使用不同的 AI 模型
参考资源：
龙芯开源社区：https://www.loongnix.cn/zh/proj/
MiniMax API 申请：https://platform.minimaxi.com/
智谱 AI API 申请：https://open.bigmodel.cn/
公众号“花叔”编写的《Claude code 从入门到精通》
