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

格数致用2026-08-18 13:11

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

📅 更新时间：2026年8月

🖥️ 适用系统：银河麒麟桌面操作系统 V10 SP1（2203/2303 版本验证通过）

📌 说明：Claude Code 支持通过环境变量配置自定义 API 端点。DeepSeek 平台提供了 Anthropic 兼容的 API 接口，本文以该接口为例演示接入步骤。

目录

  1. 前言
  2. 系统环境确认
  3. [安装 Node.js](#安装 Node.js)
  4. [配置 npm 国内镜像](#配置 npm 国内镜像)
  5. [安装 Claude Code CLI](#安装 Claude Code CLI)
  6. [安装 VSCode](#安装 VSCode)
  7. [安装 VSCode Claude Code 扩展](#安装 VSCode Claude Code 扩展)
  8. [注册 DeepSeek 并获取 API Key](#注册 DeepSeek 并获取 API Key)
  9. 配置文件详解与正确写法
  10. 验证配置是否成功
  11. 常见问题

前言

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），执行：

bash 复制代码 
uname -m
  • 显示 x86_64 → 后续下载 x64 版 Node.js
  • 显示 aarch64（飞腾 FT-D2000、鲲鹏 920 等国产 CPU）→ 后续下载 arm64 版 Node.js

1.2 确认包管理器类型

bash 复制代码 
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 安装基础依赖

bash 复制代码 
sudo apt update
sudo apt install -y wget xz-utils

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

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

x86_64（Intel/AMD 平台）：

bash 复制代码 
cd ~
wget https://npmmirror.com/mirrors/node/v22.14.0/node-v22.14.0-linux-x64.tar.xz

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

bash 复制代码 
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 解压并安装到用户目录

bash 复制代码 
tar -xJf node-v22.14.0-linux-x64.tar.xz
mv node-v22.14.0-linux-x64 ~/node

2.4 配置 PATH 环境变量

bash 复制代码 
echo 'export PATH=$HOME/node/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

2.5 验证 Node.js 安装成功

bash 复制代码 
node -v
npm -v

正常输出：

复制代码 
v22.14.0
10.9.0

3. 配置 npm 国内镜像

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

bash 复制代码 
npm config set registry https://registry.npmmirror.com

4. 安装 Claude Code CLI

bash 复制代码 
npm install -g @anthropic-ai/claude-code

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

复制代码 
added 9 packages in 15s

4.1 验证安装

bash 复制代码 
claude --version

正常输出：

复制代码 
2.1.229 (Claude Code)

5. 安装 VSCode

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

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

  1. 点击桌面左下角 开始菜单
  2. 搜索 "软件商店" 或 "App Store"
  3. 搜索框输入 "Visual Studio Code"
  4. 点击 安装

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

  1. 访问 https://code.visualstudio.com/
  2. 下载 Linux .deb 版本
  3. 拷贝到银河麒麟系统（U盘或局域网共享）
  4. 在下载目录执行：
bash 复制代码 
sudo apt install -y ./code_latest_amd64.deb

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

6. 安装 VSCode Claude Code 扩展

6.1 打开 VSCode

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

6.2 安装 Claude Code 扩展

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

6.3 重启 VSCode

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

7. 注册 DeepSeek 并获取 API Key

7.1 注册 DeepSeek Platform 账号

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

7.2 创建 API Key

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

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

7.3 充值

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

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

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

8.1 配置文件路径

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

复制代码 
~/.claude/settings.json

8.2 创建配置文件

打开终端，执行：

bash 复制代码 
mkdir -p ~/.claude
nano ~/.claude/settings.json

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

8.3 写入完整配置内容

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

json 复制代码 
{
  "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 后缀

json 复制代码 
"ANTHROPIC_BASE_URL": "https://api.deepseek.com"

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

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

json 复制代码 
"ANTHROPIC_MODEL": "deepseek-chat"

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

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

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

9. 验证配置是否成功

9.1 重启 VSCode

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

9.2 测试对话

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

9.3 关于登录提示

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

9.4 命令行测试（非必须）

bash 复制代码 
claude

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

10. 常见问题

Q1：提示 "claude: command not found"

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

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

bash 复制代码 
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：提示需要登录/登录失败

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

解决：

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

Q4：API 调用报错 "401 Unauthorized"

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

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

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

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

解决：

  1. 尝试更换 npm 镜像源：
bash 复制代码 
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code
  1. 如果 npm 镜像也不行，可在其他网络环境下下载 .tar.xz 包，拷贝到麒麟系统后离线安装。

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

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

解决：

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

Q7：想用其他国内模型

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

豆包（字节跳动）
json 复制代码 
{
  "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）
json 复制代码 
{
  "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 评论区留言交流！

相关推荐
我一定会有钱4 小时前
打造完美工作流：Git 配置”一次推送，三端同步”（Gitee/GitCode/GitHub）
开发语言·windows·vscode·搜索引擎·gitlab·github·visual studio code
宿6745 小时前
vscode文件夹
前端·vue.js·vscode
csdn_aspnet1 天前
2026 年 9 款最佳开源 AI 编码助手及常见问题解答
vscode·continue·cline·goose·ai编码·aider·opencode
任逍遥20111 天前
免费！VS Code 行为树编辑器 micBT：行为树生成、编辑、推演、调试
vscode·行为树·vscode插件·micbt
林三的日常1 天前
【无标题】
java·spring boot·vscode·调试·后端开发
Super 含1 天前
Android 包体积优化（一）：APK 到底大在哪里？从 APK 结构到体积分析
android·ide·vscode
舞动青春881 天前
vscode copilot配置kimi k3
ide·vscode·copilot
golang学习记2 天前
VS Code 2026年的正确的打开方式
vscode
仙逆GPT3 天前
ChatGPT、Codex实战：从Claude Code / Cursor迁移到Codex怎么做？/import最容易漏掉哪些配置？
cursor·codex·chatgptplus·claudecode·codex教程
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02GitHub 镜像站点032026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？04微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新05Agnes AI 免费 API 接入指南：文本、生图、生视频，一套接口全免费06历年考研数学一、数学二、数学三真题试卷及答案PDF07VSCode+CodeX扩展，无法启动08AI 编程 IDE 全景解析 2026：Agent 全面接管开发链路092026年7月AI圈大地震：GPT-5.6被政府限制、Claude入驻Slack、Anthropic自研芯片10如何新建文件夹？ 电脑新建文件夹的4种方法