银河麒麟 V10 SP1 桌面操作系统 VSCode Claude Code 配置 DeepSeek 模型全流程教程 更新时间2026年8月️ 适用系统银河麒麟桌面操作系统 V10 SP12203/2303 版本验证通过 说明Claude Code 支持通过环境变量配置自定义 API 端点。DeepSeek 平台提供了 Anthropic 兼容的 API 接口本文以该接口为例演示接入步骤。目录前言系统环境确认安装 Node.js配置 npm 国内镜像安装 Claude Code CLI安装 VSCode安装 VSCode Claude Code 扩展注册 DeepSeek 并获取 API Key配置文件详解与正确写法验证配置是否成功常见问题前言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 架构打开终端CtrlAltT执行uname-m显示x86_64→ 后续下载x64版 Node.js显示aarch64飞腾 FT-D2000、鲲鹏 920 等国产 CPU→ 后续下载arm64版 Node.js1.2 确认包管理器类型whichdpkgechoDebian系||echo非Debianwhichaptecho使用apt银河麒麟 V10 SP1 桌面版应输出Debian系 使用apt后续所有软件安装统一使用apt命令。2. 安装 Node.js⚠️ 银河麒麟系统自带的 Node.js 版本通常为 10.x 或更低Claude Code 要求Node.js 18 及以上必须安装新版。2.1 安装基础依赖sudoaptupdatesudoaptinstall-ywgetxz-utils 如果提示sudo: command not found普通用户权限不足请联系系统管理员获取 sudo 权限或使用管理员账号操作。2.2 下载 Node.js根据架构二选一x86_64Intel/AMD 平台cd~wgethttps://npmmirror.com/mirrors/node/v22.14.0/node-v22.14.0-linux-x64.tar.xzaarch64飞腾/鲲鹏等国产 CPUcd~wgethttps://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-xJfnode-v22.14.0-linux-x64.tar.xzmvnode-v22.14.0-linux-x64 ~/node2.4 配置 PATH 环境变量echoexport PATH$HOME/node/bin:$PATH~/.bashrcsource~/.bashrc2.5 验证 Node.js 安装成功node-vnpm-v正常输出v22.14.0 10.9.03. 配置 npm 国内镜像⚠️ 直接访问 npm 官方源速度较慢建议配置国内镜像。npmconfigsetregistry https://registry.npmmirror.com4. 安装 Claude Code CLInpminstall-ganthropic-ai/claude-code安装过程约 10~30 秒看到类似以下输出即为成功added 9 packages in 15s4.1 验证安装claude--version正常输出2.1.229 (Claude Code)5. 安装 VSCode银河麒麟系统有以下两种安装方式二选一方式一麒麟软件商店推荐最简单点击桌面左下角开始菜单搜索“软件商店”或“App Store”搜索框输入“Visual Studio Code”点击安装方式二官网下载 .deb 包手动安装访问 https://code.visualstudio.com/下载Linux .deb版本拷贝到银河麒麟系统U盘或局域网共享在下载目录执行sudoaptinstall-y./code_latest_amd64.deb.deb包文件名可能因版本号不同Tab 补全确认即可。6. 安装 VSCode Claude Code 扩展6.1 打开 VSCode从开始菜单启动 VSCode注意不是 root 用户启动。6.2 安装 Claude Code 扩展按CtrlShiftX打开扩展面板在搜索框中输入Claude Code找到由Anthropic发布的官方插件认准蓝色 Claude 标志点击安装6.3 重启 VSCode安装完成后VSCode 左侧活动栏会出现Claude 图标抽象的 Claude 标志。7. 注册 DeepSeek 并获取 API Key7.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.json8.2 创建配置文件打开终端执行mkdir-p~/.claudenano~/.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}}保存退出nanoCtrlO 回车CtrlX。8.4 替换你的 API Key把sk-你的DeepSeekAPIKey替换为在 DeepSeek Platform 获取的真实 Key。8.5 配置项说明配置项正确值说明ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicDeepSeek 的 Anthropic 兼容端点必须带/anthropic后缀根路径是 OpenAI 协议不兼容ANTHROPIC_AUTH_TOKEN你的 DeepSeek API Key从 DeepSeek Platform 获取ANTHROPIC_MODELdeepseek-v4-pro[1m]DeepSeek V4 主模型1M 上下文ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m]Claude Code 内部调用对应模型时映射到此ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m]Claude Code 内部调用对应模型时映射到此ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flashClaude Code 内部调用对应模型时映射到此CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash子任务使用的模型CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1禁用非必要后台流量官方遥测 说明DeepSeek 自 2026 年起将旧模型名deepseek-chat、deepseek-reasoner下线统一使用新模型名。若使用其他平台请替换为对应平台要求的模型名。8.6 常见错误写法务必避免❌错误1BASE_URL 缺少/anthropic后缀ANTHROPIC_BASE_URL:https://api.deepseek.comDeepSeek 的根路径是 OpenAI 协议Claude Code 使用 Anthropic 协议访问会报错。必须带/anthropic后缀。❌错误2使用了已下线的旧模型名ANTHROPIC_MODEL:deepseek-chatdeepseek-chat和deepseek-reasoner已下线必须改用deepseek-v4-pro[1m]。❌错误3只配置了部分模型映射如果只配了ANTHROPIC_MODELClaude 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未执行。解决在终端执行以下命令exportPATH$HOME/node/bin:$PATHnode-v# 验证 node 可用如果 node 能运行检查npm list -g anthropic-ai/claude-code输出将 bin 目录手动加入 PATH。Q2Claude 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.jsonQ4API 调用报错 “401 Unauthorized”原因API Key 填错或 Key 已失效。解决重新到 https://platform.deepseek.com/api_keys 检查 Key 是否正确确认账户余额充足。Q5wget 下载失败网络问题原因当前网络环境无法访问 npmmirror。解决尝试更换 npm 镜像源npmconfigsetregistry https://registry.npmmirror.comnpminstall-ganthropic-ai/claude-code如果 npm 镜像也不行可在其他网络环境下下载.tar.xz包拷贝到麒麟系统后离线安装。Q6sudo 命令不可用普通用户权限不足原因银河麒麟系统开启了 Kysec 安全框架普通用户无 sudo 权限。解决联系系统管理员获取 sudo 权限或使用有管理员权限的账号登录操作Node.js 和 Claude Code 可以安装到用户目录本文已按此设计CLI 安装无需 sudoQ7想用其他国内模型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.xnpmmirror 国内镜像用户目录安装✅ 配置 npm 国内镜像npmmirror✅ 安装 Claude Code CLInpm 全局安装✅ 安装 VSCode麒麟软件商店或 .deb 包✅ 安装 VSCode Claude Code 官方扩展✅ 注册 DeepSeek Platform 并获取 API Key✅ 正确配置settings.jsonAnthropic 兼容端点 新模型名✅ 验证配置是否生效✅ 常见问题排查按照以上步骤操作即可在银河麒麟 V10 桌面操作系统环境下通过 VSCode 使用 Claude Code 并接入 DeepSeek 模型进行 AI 辅助编程。 如果觉得有帮助欢迎在 CSDN 评论区留言交流