1. 银河麒麟 V10 SP1 上跑 AI 编码卡在哪一步银河麒麟 V10 SP1 桌面系统基于 Debian 系apt 包管理日常办公和开发都能撑起来。但真要在上面把 AI 编码工作流跑通很多人第一步就卡住了系统自带的 Node.js 版本太低Claude Code CLI 装不上好不容易装上VSCode 扩展又提示模型不可用再往下走配置文件里 Base URL 少写一个后缀直接 401。这篇教程就是把这些坑一个个填平。我会从系统环境确认开始一路走到终端验证请求成功中间给出可直接复制的 settings.json 片段和验证命令。适合谁看在国产操作系统上做开发、想用 Claude Code 接入 DeepSeek-V4 的工程师或者刚接触银河麒麟、想搭一套 AI 辅助编码环境的同学。核心检索词先摆出来银河麒麟 V10 SP1 桌面系统下通过 VSCode 和 Claude Code 接入 DeepSeek-V4需要确认 CPU 架构、装 Node.js 22.x、配 npm 镜像、装 Claude Code CLI、装 VSCode 扩展、写对 settings.json 里的 Base URL 和模型映射最后用终端命令验证请求是否成功。这一套流程走完你就能在麒麟系统上让 AI 帮你写代码、改 bug、生成测试用例。我试过在 x86_64 和 aarch64 两种架构的麒麟机器上各跑一遍流程基本一致差异只在 Node.js 安装包的选择。下面按实际操作顺序展开每一步都给命令和预期输出你跟着敲就行。2. 前置准备Node.js 22.x 与 Claude Code CLI 安装银河麒麟 V10 SP1 自带的 Node.js 通常是 10.x 甚至更低而 Claude Code 要求 Node.js 18 及以上。所以第一步不是装 Claude Code而是先把 Node.js 换掉。这里用 npmmirror 国内镜像下载速度比官方源快很多。先确认 CPU 架构这决定你下载 x64 还是 arm64 的包uname -m输出x86_64就下 x64 版输出aarch64飞腾、鲲鹏等国产 CPU就下 arm64 版。接着确认包管理器which dpkg echo Debian系 || echo 非Debian which apt echo 使用apt银河麒麟 V10 SP1 桌面版应该输出 Debian系 使用apt后续统一用 apt。安装基础依赖sudo apt update sudo apt install -y wget xz-utils如果提示sudo: command not found说明当前用户权限不足需要联系管理员获取 sudo 权限或者用管理员账号操作。Node.js 和 Claude Code 可以装到用户目录CLI 部分不需要 sudo。下载 Node.js 22.x按架构二选一# x86_64 cd ~ wget https://npmmirror.com/mirrors/node/v22.14.0/node-v22.14.0-linux-x64.tar.xz # aarch64 cd ~ wget https://npmmirror.com/mirrors/node/v22.14.0/node-v22.14.0-linux-arm64.tar.xz解压并安装到用户目录tar -xJf node-v22.14.0-linux-x64.tar.xz mv node-v22.14.0-linux-x64 ~/node echo export PATH$HOME/node/bin:$PATH ~/.bashrc source ~/.bashrc验证node -v npm -v正常输出v22.14.0和10.9.0。如果 node 命令找不到检查~/.bashrc里的 PATH 是否写对再执行一次source ~/.bashrc。配 npm 国内镜像npm config set registry https://registry.npmmirror.com安装 Claude Code CLInpm install -g anthropic-ai/claude-code看到added 9 packages in 15s类似输出即成功。验证claude --version输出2.1.229 (Claude Code)这样的版本号就对了。到这一步CLI 环境就绪接下来装 VSCode 和扩展。3. 可复制配置settings.json 与 Base URL 写法VSCode 在银河麒麟上有两种装法。最简单的是打开开始菜单里的软件商店搜索 Visual Studio Code 直接安装。如果商店里没有就去官网下载 Linux .deb 包拷贝到麒麟系统后执行sudo apt install -y ./code_latest_amd64.deb装完启动 VSCode按CtrlShiftX打开扩展面板搜索Claude Code找到 Anthropic 发布的官方插件点安装。装完左侧活动栏会出现 Claude 图标。接下来是最关键的一步配置文件。Claude Code 读取用户目录下的~/.claude/settings.json。先创建目录和文件mkdir -p ~/.claude nano ~/.claude/settings.json把下面这段完整粘贴进去注意替换sk-你的APIKey为真实 Key{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的APIKey, 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 下CtrlO回车CtrlX。这里解释几个关键项。ANTHROPIC_BASE_URL填 TaoToken 的 API 地址https://taotoken.net/api这是 Anthropic 兼容端点Claude Code 通过它转发请求。ANTHROPIC_AUTH_TOKEN填你在 TaoToken 控制台创建的 Key。模型映射这块ANTHROPIC_MODEL是主模型ANTHROPIC_DEFAULT_OPUS_MODEL和ANTHROPIC_DEFAULT_SONNET_MODEL是 Claude Code 内部调用对应档位时的映射ANTHROPIC_DEFAULT_HAIKU_MODEL和CLAUDE_CODE_SUBAGENT_MODEL用于轻量任务和子代理。全部配齐避免部分功能报错。如果你用 Codex 或 Cline MCP配置逻辑类似核心三件套是 Base URL、Key、Model ID。Codex 的auth.json里对应字段是OPENAI_BASE_URL和OPENAI_API_KEYModel ID 填deepseek-v4-pro[1m]。Cline MCP 则在设置里选 Anthropic 兼容模式填同样的 Base URL 和 Key。常见错误写法要避开。第一Base URL 写成https://taotoken.net不带/api会报协议不匹配。第二模型名用已下线的deepseek-chat会提示模型不可用。第三只配ANTHROPIC_MODEL不配其他映射子任务会找不到模型。4. 验证请求终端命令与预期返回配置写完先完全关闭 VSCode 再重新打开让新配置生效。然后打开任意文件夹点左侧 Claude 图标在对话框输入你好。如果正常回复说明配置成功。如果提示登录 Anthropic 账号直接跳过继续用已配置的 API 端点即可。更可靠的验证方式是用终端。先确认配置文件内容cat ~/.claude/settings.json检查 Base URL 和 Key 是否正确。然后直接用 curl 测试端点连通性curl -X POST https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: sk-你的APIKey \ -H anthropic-version: 2023-06-01 \ -d { model: deepseek-v4-pro[1m], max_tokens: 64, messages: [{role: user, content: 回复 OK}] }预期返回是一段 JSON包含content字段里面是模型回复的文本。如果返回401 Unauthorized说明 Key 不对或已失效。如果返回model not found说明模型名写错。如果连接超时检查网络是否能访问taotoken.net。再跑一次 CLI 验证claude看到欢迎界面后输入hi能正常回复即配置成功。CLI 和 VSCode 扩展走的是同一套配置CLI 通了扩展基本没问题。如果你在 VSCode 里遇到Theres an issue with the selected model多半是模型名或 Base URL 写错。回到~/.claude/settings.json逐项核对然后完全重启 VSCode。注意是用户目录~/.claude/不是根目录/root/.claude/除非你用 root 账号操作。5. 常见报错排查401、local proxy failed、reading choices实际跑下来报错集中在几个地方。下面按真实错误信息对照排查。401 UnauthorizedKey 填错、Key 失效、或账户余额不足。去 TaoToken 控制台重新生成 Key确认账户有可用额度。检查settings.json里ANTHROPIC_AUTH_TOKEN是否有多余空格或换行。local proxy failed通常是 Base URL 写错或网络不通。确认ANTHROPIC_BASE_URL是https://taotoken.net/api不带尾部斜杠。用curl -I https://taotoken.net/api测试连通性如果超时检查系统网络设置。reading choices 报错这个错误常见于响应格式解析失败多半是模型名不匹配或端点协议不对。确认ANTHROPIC_MODEL填的是deepseek-v4-pro[1m]不是deepseek-chat。确认 Base URL 带/api路径。OAuth 相关报错Claude Code 启动时可能尝试 OAuth 登录如果配置了自定义端点直接跳过登录即可。如果跳过不了检查CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC是否设为1。claude: command not foundnpm 全局安装路径没进 PATH。执行export PATH$HOME/node/bin:$PATH再source ~/.bashrc。用npm list -g anthropic-ai/claude-code确认安装位置把对应 bin 目录加入 PATH。wget 下载失败网络无法访问 npmmirror。换镜像源或离线下载 .tar.xz 包拷贝到麒麟系统安装。sudo 不可用银河麒麟开启 Kysec 安全框架普通用户无 sudo 权限。联系管理员或把 Node.js 和 Claude Code 装到用户目录本文流程已按此设计CLI 安装不需要 sudo。排查时记住一个原则先确认配置文件内容再确认网络连通性最后确认 Key 和模型名。三步走完大部分问题都能定位。6. 跑通之后模型对话、Coding Plan 与接入文档配置跑通后你可以直接在 VSCode 里让 Claude Code 帮你写代码、重构、生成测试。如果想先验证模型效果可以打开模型对话页面直接测试 DeepSeek-V4 的回复质量确认模型可用后再接入工作流。长期做编码或 Agent 开发的话Coding Plan 更适合高频调用场景按量计费比单次充值灵活。接入过程中遇到配置问题接入文档里有完整的参数说明和示例对照检查 Base URL、Key、Model ID 三件套。如果你在麒麟系统上跑通了建议把~/.claude/settings.json备份一份换机器或重装系统时直接复用。模型名和 Base URL 可能会更新定期回控制台确认最新配置。终端验证命令curl那一段可以存成脚本每次改完配置跑一次比在 VSCode 里试错快得多。