银河麒麟 V10 SP1 桌面操作系统 + VSCode + Claude Code 接入 DeepSeek-V4 全流程教程（2026年最新）

典则数学启蒙

301人浏览 · 2026-08-17 10:32:44

典则数学启蒙 · 2026-08-17 10:32:44 发布

银河麒麟 V10 SP1 桌面操作系统 + VSCode + Claude Code 配置 DeepSeek 模型全流程教程

📅 更新时间：2026年8月
🖥️ 适用系统：银河麒麟桌面操作系统 V10 SP1（2203/2303 版本验证通过）
📌 说明：Claude Code 支持通过环境变量配置自定义 API 端点。DeepSeek 平台提供了 Anthropic 兼容的 API 接口，本文以该接口为例演示接入步骤。

前言

Claude Code 是 Anthropic 推出的 AI 编程助手，支持通过环境变量（env）配置自定义的 API 端点与模型。

DeepSeek 平台提供了 Anthropic 兼容的 API 接口，可在 Claude Code 的配置文件中指定后调用其模型。这种方式不需要 Anthropic 官方账号，适合在国内网络环境下使用 DeepSeek 提供的模型服务。

银河麒麟 V10 SP1 桌面版基于 Debian Linux，使用 apt 包管理器，安装 Node.js 和 Claude Code 的流程与 Ubuntu 基本一致。

1. 系统环境确认

1.1 确认 CPU 架构

打开终端（Ctrl+Alt+T），执行：

uname -m

显示 x86_64 → 后续下载 x64 版 Node.js
显示 aarch64（飞腾 FT-D2000、鲲鹏 920 等国产 CPU）→ 后续下载 arm64 版 Node.js

在这里插入图片描述

1.2 确认包管理器类型

which dpkg && echo "Debian系" || echo "非Debian"
which apt && echo "使用apt"

银河麒麟 V10 SP1 桌面版应输出 Debian系 + 使用apt，后续所有软件安装统一使用 apt 命令。

在这里插入图片描述

2. 安装 Node.js

⚠️ 银河麒麟系统自带的 Node.js 版本通常为 10.x 或更低，Claude Code 要求 Node.js 18 及以上，必须安装新版。

2.1 安装基础依赖

sudo apt update
sudo apt install -y wget xz-utils

💡 如果提示 sudo: command not found（普通用户权限不足），请联系系统管理员获取 sudo 权限，或使用管理员账号操作。

2.2 下载 Node.js（根据架构二选一）

x86_64（Intel/AMD 平台）：

cd ~
wget https://npmmirror.com/mirrors/node/v22.14.0/node-v22.14.0-linux-x64.tar.xz

aarch64（飞腾/鲲鹏等国产 CPU）：

cd ~
wget https://npmmirror.com/mirrors/node/v22.14.0/node-v22.14.0-linux-arm64.tar.xz

💡 使用国内 npmmirror 镜像下载，访问速度快。如需确认最新版，可访问 https://npmmirror.com/mirrors/node/ 查看，当前 LTS 版本为 v22.x。

2.3 解压并安装到用户目录

tar -xJf node-v22.14.0-linux-x64.tar.xz
mv node-v22.14.0-linux-x64 ~/node

2.4 配置 PATH 环境变量

echo 'export PATH=$HOME/node/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

2.5 验证 Node.js 安装成功

node -v
npm -v

正常输出：

v22.14.0
10.9.0

在这里插入图片描述

3. 配置 npm 国内镜像

⚠️ 直接访问 npm 官方源速度较慢，建议配置国内镜像。

npm config set registry https://registry.npmmirror.com

4. 安装 Claude Code CLI

npm install -g @anthropic-ai/claude-code

安装过程约 10~30 秒，看到类似以下输出即为成功：

added 9 packages in 15s

4.1 验证安装

claude --version

正常输出：

2.1.229 (Claude Code)

在这里插入图片描述

5. 安装 VSCode

银河麒麟系统有以下两种安装方式，二选一：

方式一：麒麟软件商店（推荐，最简单）

点击桌面左下角 开始菜单
搜索 “软件商店” 或 “App Store”
搜索框输入 “Visual Studio Code”
点击安装

方式二：官网下载 .deb 包手动安装

访问 https://code.visualstudio.com/
下载 Linux .deb 版本
拷贝到银河麒麟系统（U盘或局域网共享）
在下载目录执行：

sudo apt install -y ./code_latest_amd64.deb

💡 .deb 包文件名可能因版本号不同，Tab 补全确认即可。

6. 安装 VSCode Claude Code 扩展

6.1 打开 VSCode

从开始菜单启动 VSCode（注意不是 root 用户启动）。

6.2 安装 Claude Code 扩展

按 Ctrl+Shift+X 打开扩展面板
在搜索框中输入：Claude Code
找到由 Anthropic 发布的官方插件（认准蓝色 Claude 标志）
点击安装

在这里插入图片描述

6.3 重启 VSCode

安装完成后，VSCode 左侧活动栏会出现 Claude 图标（抽象的 Claude 标志）。

在这里插入图片描述

7. 注册 DeepSeek 并获取 API Key

7.1 注册 DeepSeek Platform 账号

访问 https://platform.deepseek.com
点击 注册/登录（支持手机号、邮箱）
完成实名认证（平台合规要求）

7.2 创建 API Key

登录后，左侧导航栏点击 API Keys
点击 创建 API Key
填写一个名称（如 claude-code），点击创建
立刻复制 Key 保存到本地（只显示一次！）

⚠️ Key 格式为 sk-xxxxxxxxxxxxxxxx，妥善保管，不要泄露给他人。

7.3 充值

DeepSeek API 按用量计费，充值入口在用户中心，充值门槛较低（最低 1 元起），适合个人学习和日常开发使用。

在这里插入图片描述

8. 配置文件详解与正确写法

⚠️ 这是最关键的一步！配置写错一个字符就会导致 Claude Code 无法正常工作。

8.1 配置文件路径

Claude Code 的配置文件位于用户目录下：

~/.claude/settings.json

8.2 创建配置文件

打开终端，执行：

mkdir -p ~/.claude
nano ~/.claude/settings.json

💡 也可用 vi、gedit 等编辑器，图形界面下双击文件也可编辑。

8.3 写入完整配置内容

将以下内容完整粘贴到编辑器中：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeekAPIKey",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

保存退出（nano：Ctrl+O 回车，Ctrl+X）。

8.4 替换你的 API Key

把 "sk-你的DeepSeekAPIKey" 替换为在 DeepSeek Platform 获取的真实 Key。

8.5 配置项说明

配置项	正确值	说明
`ANTHROPIC_BASE_URL`	`https://api.deepseek.com/anthropic`	DeepSeek 的 Anthropic 兼容端点，必须带 `/anthropic` 后缀（根路径是 OpenAI 协议，不兼容）
`ANTHROPIC_AUTH_TOKEN`	你的 DeepSeek API Key	从 DeepSeek Platform 获取
`ANTHROPIC_MODEL`	`deepseek-v4-pro[1m]`	DeepSeek V4 主模型，1M 上下文
`ANTHROPIC_DEFAULT_OPUS_MODEL`	`deepseek-v4-pro[1m]`	Claude Code 内部调用对应模型时映射到此
`ANTHROPIC_DEFAULT_SONNET_MODEL`	`deepseek-v4-pro[1m]`	Claude Code 内部调用对应模型时映射到此
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	`deepseek-v4-flash`	Claude Code 内部调用对应模型时映射到此
`CLAUDE_CODE_SUBAGENT_MODEL`	`deepseek-v4-flash`	子任务使用的模型
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	`1`	禁用非必要后台流量（官方遥测）

💡 说明：DeepSeek 自 2026 年起将旧模型名 deepseek-chat、deepseek-reasoner 下线，统一使用新模型名。若使用其他平台，请替换为对应平台要求的模型名。

8.6 常见错误写法（务必避免）

❌ 错误1：BASE_URL 缺少 /anthropic 后缀

"ANTHROPIC_BASE_URL": "https://api.deepseek.com"

DeepSeek 的根路径是 OpenAI 协议，Claude Code 使用 Anthropic 协议访问会报错。必须带 /anthropic 后缀。

❌ 错误2：使用了已下线的旧模型名

"ANTHROPIC_MODEL": "deepseek-chat"

deepseek-chat 和 deepseek-reasoner 已下线，必须改用 deepseek-v4-pro[1m]。

❌ 错误3：只配置了部分模型映射

如果只配了 ANTHROPIC_MODEL，Claude Code 内部调用其他子模型时会找不到，导致部分功能报错。必须配置全部模型映射。

9. 验证配置是否成功

9.1 重启 VSCode

必须完全关闭 VSCode，然后重新打开，使新配置生效。

9.2 测试对话

在 VSCode 中打开任意文件夹（文件 → 打开文件夹）
点击左侧 Claude 图标
在对话框中输入：你好
如果正常回复，说明配置成功 ✅

在这里插入图片描述

9.3 关于登录提示

VSCode 插件启动后若提示登录 Anthropic 账号，可直接选择跳过，继续通过已配置的 API 端点使用即可。

9.4 命令行测试（非必须）

claude

看到欢迎界面后输入 hi，能正常回复即配置成功。

在这里插入图片描述

10. 常见问题

Q1：提示 “claude: command not found”

原因：npm 全局安装路径未加入 PATH，或 source ~/.bashrc 未执行。

解决：在终端执行以下命令：

export PATH=$HOME/node/bin:$PATH
node -v  # 验证 node 可用

如果 node 能运行，检查 npm list -g @anthropic-ai/claude-code 输出，将 bin 目录手动加入 PATH。

Q2：Claude Code 提示 “There’s an issue with the selected model”

原因：模型名写错（使用了已下线的 deepseek-chat）或 BASE_URL 写错（缺少 /anthropic 后缀）。

解决：重新检查 ~/.claude/settings.json，确保第 8 步的配置完全正确，然后完全重启 VSCode。

Q3：提示需要登录/登录失败

原因：配置未生效，或配置文件路径不对。

解决：

确认文件在 ~/.claude/settings.json（注意是用户目录 ~，不是根目录 /）
确认 VSCode 已完全关闭并重启
在终端验证配置文件内容：

cat ~/.claude/settings.json

Q4：API 调用报错 “401 Unauthorized”

原因：API Key 填错或 Key 已失效。

解决：重新到 https://platform.deepseek.com/api_keys 检查 Key 是否正确，确认账户余额充足。

Q5：wget 下载失败（网络问题）

原因：当前网络环境无法访问 npmmirror。

解决：

尝试更换 npm 镜像源：

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

如果 npm 镜像也不行，可在其他网络环境下下载 .tar.xz 包，拷贝到麒麟系统后离线安装。

Q6：sudo 命令不可用（普通用户权限不足）

原因：银河麒麟系统开启了 Kysec 安全框架，普通用户无 sudo 权限。

解决：

联系系统管理员获取 sudo 权限
或使用有管理员权限的账号登录操作
Node.js 和 Claude Code 可以安装到用户目录（本文已按此设计，CLI 安装无需 sudo）

Q7：想用其他国内模型

DeepSeek 兼容接口的用法同样适用于其他提供 Anthropic 兼容 API 的平台，只需替换配置文件中的 URL 与模型名即可。

豆包（字节跳动）

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",
    "ANTHROPIC_AUTH_TOKEN": "你的豆包API Key",
    "ANTHROPIC_MODEL": "doubao-seed-2.0-code",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "doubao-seed-2.0-code",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "doubao-seed-2.0-code",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "doubao-seed-2.0-code",
    "CLAUDE_CODE_SUBAGENT_MODEL": "doubao-seed-2.0-code"
  }
}

硅基流动（SiliconFlow）

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.siliconflow.cn/v1",
    "ANTHROPIC_AUTH_TOKEN": "你的硅基流动API Key",
    "ANTHROPIC_MODEL": "deepseek-ai/DeepSeek-V3",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-V3",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-ai/DeepSeek-V3",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-ai/DeepSeek-V3",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-ai/DeepSeek-V3"
  }
}

使用建议

Claude Code 工作模式选择

模式	说明	适用场景
Manual	每次修改前需确认	✅ 推荐默认，安全可控
Edit automatically	自动修改代码	批量重构时用
Plan	先分析计划，确认后再执行	复杂任务
Auto	安全操作自动执行，有风险时询问	效率优先

Effort 滑块

控制 AI 思考深度：

Low：快速响应，适合简单修改
Medium：适中（默认推荐）
High：深度分析，适合复杂重构

总结

本文完整覆盖了以下内容：

✅ 系统环境确认（CPU 架构 + 包管理器类型）
✅ 安装 Node.js 22.x（npmmirror 国内镜像，用户目录安装）
✅ 配置 npm 国内镜像（npmmirror）
✅ 安装 Claude Code CLI（npm 全局安装）
✅ 安装 VSCode（麒麟软件商店或 .deb 包）
✅ 安装 VSCode Claude Code 官方扩展
✅ 注册 DeepSeek Platform 并获取 API Key
✅ 正确配置 settings.json（Anthropic 兼容端点 + 新模型名）
✅ 验证配置是否生效
✅ 常见问题排查

按照以上步骤操作，即可在银河麒麟 V10 桌面操作系统环境下，通过 VSCode 使用 Claude Code 并接入 DeepSeek 模型进行 AI 辅助编程。

🎉 如果觉得有帮助，欢迎在 CSDN 评论区留言交流！

openEuler 社区

openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目，面向数字基础设施四大核心场景（服务器、云计算、边缘计算、嵌入式），全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构

更多推荐

极简进销存管理软件，可扫码入库出库，可对接电商平台，可接AI Agent，重量公式全面，可以覆盖绝大多数行业，支持中，英，日，韩，德，法，西班牙，俄等8国语言，三大操作系统平台，无年费！

openEuler 社区

鸿蒙原生应用登录方案选型指南：号码认证鸿蒙版如何实现秒级一键登录

整个核验过程在运营商网关与服务端之间通过加密通道完成，应用侧仅获取经用户授权的身份标识，不接触用户的SIM卡底层数据。更关键的是，绑定在第三方生态内的用户身份，若未来应用需要独立运营或跨生态扩展，用户迁移将面临巨大成本。鸿蒙生态的成熟，不仅意味着操作系统层面的独立，更意味着开发者需要在新的技术框架下重新评估每一个基础设施级别的选择。随着鸿蒙生态的发展，运营商纷纷完成号码认证鸿蒙原生版本的适配。在鸿

openEuler 社区

C语言总结

内存泄漏是指程序在动态分配内存后，不再使用该内存却没有释放，导致这片内存既不能被程序继续使用，也无法被操作系统回收，直到程序结束。你从系统借了一块内存，用完忘记还了，系统以为你还在用，别人也用不了，就一直空着浪费了。

openEuler 社区

所有评论(0)

查看更多评论

典则数学启蒙

@u010972645

已为社区贡献1条内容

银河麒麟 V10 SP1 桌面操作系统 + VSCode + Claude Code 接入 DeepSeek-V4 全流程教程（2026年最新）

典则数学启蒙

银河麒麟 V10 SP1 桌面操作系统 + VSCode + Claude Code 配置 DeepSeek 模型全流程教程

目录

前言

1. 系统环境确认

1.1 确认 CPU 架构

1.2 确认包管理器类型

2. 安装 Node.js

2.1 安装基础依赖

2.2 下载 Node.js（根据架构二选一）

2.3 解压并安装到用户目录

2.4 配置 PATH 环境变量

2.5 验证 Node.js 安装成功

3. 配置 npm 国内镜像

4. 安装 Claude Code CLI

4.1 验证安装

5. 安装 VSCode

方式一：麒麟软件商店（推荐，最简单）

方式二：官网下载 .deb 包手动安装

6. 安装 VSCode Claude Code 扩展

6.1 打开 VSCode

6.2 安装 Claude Code 扩展

6.3 重启 VSCode

7. 注册 DeepSeek 并获取 API Key

7.1 注册 DeepSeek Platform 账号

7.2 创建 API Key

7.3 充值

8. 配置文件详解与正确写法

8.1 配置文件路径

8.2 创建配置文件

8.3 写入完整配置内容

8.4 替换你的 API Key

8.5 配置项说明

8.6 常见错误写法（务必避免）

9. 验证配置是否成功

9.1 重启 VSCode

9.2 测试对话

9.3 关于登录提示

9.4 命令行测试（非必须）

10. 常见问题

Q1：提示 “claude: command not found”

Q2：Claude Code 提示 “There’s an issue with the selected model”

Q3：提示需要登录/登录失败

Q4：API 调用报错 “401 Unauthorized”

Q5：wget 下载失败（网络问题）

Q6：sudo 命令不可用（普通用户权限不足）

Q7：想用其他国内模型

豆包（字节跳动）

硅基流动（SiliconFlow）

使用建议

Claude Code 工作模式选择

Effort 滑块

总结

所有评论(0)

温馨提示：您尚未绑定手机号

典则数学启蒙