MDP主数据平台1.3.0集成Claude Code：settings.json配置与验证实录

1. MDP 主数据平台 1.3.0 集成 Claude Code 到底解决什么问题MDP 主数据平台 1.3.0 这次升级里最值得单独拿出来讲的一条是它把 Claude Code 工具接进了研发链路默认集成了 superpowers、openspec、codegraph 这些技能。对每天在 MDP 里写业务代码、维护主数据模型、调开放平台接口的开发者来说这意味着你可以在平台内部直接获得 AI 编码辅助而不用在编辑器和平台之间来回切换。但真正落地时会卡在一个很实际的地方Claude Code 需要一个稳定的模型调用通道而 MDP 1.3.0 的配置入口集中在settings.json里。很多人第一次配的时候要么 Key 写错位置要么 base_url 拼错要么环境变量没生效最后表现为请求超时或者 401。这篇就围绕 MDP 1.3.0 通过 Claude Code 接入 TaoToken 统一 Key/API 通道这件事给你一份可以直接复制的settings.json配置骨架再配上连通性验证动作让你快速确认调用链路是通的。适合谁看正在用 MDP 主数据平台做二次开发的后端和前端同学尤其是刚升级到 1.3.0、想启用 Claude Code 但还没跑通请求的那批人。下面所有步骤都基于 MDP 1.3.0 的模块结构mdp-base、mdp-apps 这些重构后的命名来写配置本身不依赖具体业务模块照着填就能用。2. 接入前先把 TaoToken 的 Key 和通道准备好Claude Code 本身不生产模型能力它需要一个兼容 Anthropic 协议的 API 端点。TaoToken 提供的就是这个统一通道你只需要一个 Key就能让 Claude Code 走通模型调用。这一步不涉及 MDP 代码改动纯粹是把凭证准备好。先到官网注册并进入控制台地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注册完成后在控制台里找到 API Keys 管理页新建一个 Key。建议按项目维度建 Key比如给 MDP 单独建一个方便后面排查问题时能快速定位是哪个 Key 出的问题。创建 Key 的时候注意两点一是复制后立刻保存很多平台只展示一次二是不要把它硬编码进提交到 Git 的配置文件里。MDP 1.3.0 的工程结构里mdp-apps是应用层mdp-base是基础层配置文件通常放在应用层的资源目录下这个位置很容易被一起提交所以后面我们会用环境变量来兜底。Key 拿到后确认你要用的 API 端点。TaoToken 的 API 地址是 https://taotoken.net/api 注意这个地址不带任何查询参数配置里填的就是它。如果你用的是 Claude Code 的 Anthropic 兼容模式base_url 一般填到/api这一层具体路径由 Claude Code 自己拼接。这一步先记下来下一节直接写进settings.json。提示Key 的权限范围建议只勾选模型调用相关项不要开多余的写权限。MDP 是主数据平台涉及组织架构、数据字典这些核心数据凭证最小化是基本习惯。3. 可复制的 settings.json 配置骨架MDP 1.3.0 集成 Claude Code 后配置读取遵循 Claude Code 的标准约定核心文件就是settings.json。下面这份骨架你可以直接复制把占位符替换成自己的值即可。我把它拆成三段来看避免一次性贴一大坨导致你看不清哪行该改。第一段是模型通道配置决定 Claude Code 往哪里发请求{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: ${TAOTOKEN_API_KEY}, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }这里ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_AUTH_TOKEN用环境变量引用避免明文写 Key。ANTHROPIC_MODEL按你实际开通的模型填不确定就先留一个后面验证阶段会告诉你怎么看返回。第二段是 Claude Code 在 MDP 项目里的行为配置控制它读取哪些目录、忽略哪些文件{ permissions: { allow: [ Read, Glob, Grep ], deny: [ Read(./**/target/**), Read(./**/node_modules/**), Read(./**/.git/**) ] } }MDP 1.3.0 重构后模块变多了mdp-base和mdp-apps下面都有大量编译产物把target和node_modules排除掉能明显减少 Claude Code 扫描时的无效读取。前端那边组件库从 ant-design-vue 迁到了 antdv-next样式也从 Less 换成了 SCSS这些目录如果不想让 AI 改动可以在 deny 里继续加规则。第三段是环境变量注入把 Key 真正传进去。Linux 或 macOS 下在启动脚本里加export TAOTOKEN_API_KEYsk-你的实际KeyWindows 下用 PowerShell$env:TAOTOKEN_API_KEYsk-你的实际Key如果你是在 IDE 里启动 MDP记得把环境变量配到 IDE 的运行配置里而不是只配在系统层面否则 Claude Code 子进程可能读不到。这一步是踩坑高发区下一节验证时会专门讲怎么确认它生效了。把这三段合并成一个完整的settings.json放在 MDP 项目根目录或者 Claude Code 约定的配置目录下。合并后的结构就是env、permissions两个顶层键不要嵌套错。配置写完后不要急着跑业务代码先做连通性验证。4. 验证请求是否打通从单次调用到 MDP 内实测配置写完最怕的是“看起来对但实际不通”。验证分两层先用最小请求确认通道通再在 MDP 项目里确认 Claude Code 能正常读代码。第一层用 curl 直接打 TaoToken 的 API确认 Key 和端点没问题curl -X POST https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: ${TAOTOKEN_API_KEY} \ -H anthropic-version: 2023-06-01 \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [ {role: user, content: 回复 OK 两个字母即可} ] }如果返回里能看到content字段且文本是 OK说明 Key、端点、模型三者都对上了。如果返回 401检查x-api-key是不是环境变量没展开如果返回 404检查 base_url 是不是多写了或少写了/v1。这一步过了再进 MDP。第二层在 MDP 项目根目录启动 Claude Code让它读一个真实文件。比如让它解释mdp-base里的某个类claude 读取 mdp-base 模块下的核心配置类说明它负责什么正常情况它会返回文件路径和一段解释。如果它报“无法读取文件”多半是permissions.allow里没放行Read或者路径被 deny 规则误伤了。MDP 1.3.0 把包路径从「子模块.分类」改成了「分类.子模块」如果你在提示里写的是旧路径Claude Code 可能找不到按新结构写就行。第三层验证 MDP 业务侧是否真的用上了。MDP 1.3.0 默认集成了 superpowers、openspec、codegraph 这些技能你可以在 Claude Code 里触发一个和主数据相关的任务比如让它根据现有 DTO 生成一个带EqualsAndHashCode注解的对比方法——这个注解是 1.3.0 给业务 DTO 统一加的正好可以验证它读懂了当前代码规范。返回结果里如果正确带上了注解说明整条链路从 MDP 到 TaoToken 再到模型都是通的。注意验证阶段不要直接让它改生产配置。MDP 涉及数据权限和主数据维护先在本地或测试环境跑通确认行为符合预期再放开更多权限。5. 本篇常见报错与排查清单接入过程中高频出现的就那么几类我按现象、原因、动作整理成表方便你对照。现象可能原因排查动作401 UnauthorizedKey 未生效或写错确认环境变量已 exportecho $TAOTOKEN_API_KEY有值404 Not Foundbase_url 路径不对确认填的是https://taotoken.net/api不要手动加/v1请求超时网络或端点不可达先用 curl 单独测端点排除 MDP 侧干扰Claude Code 读不到文件permissions 未放行检查 allow 里是否有Readdeny 是否误伤路径模型名报错模型标识不匹配换成控制台里实际开通的模型名改了配置不生效配置未重载重启 Claude Code 进程确认读的是同一份 settings.json重点说两个最容易反复踩的。一个是环境变量作用域问题你在终端里 export 了但 IDE 启动 MDP 时用的是另一套环境Claude Code 子进程读不到表现就是 401。解决办法是把变量写进 IDE 的运行配置或者用.env文件配合加载。另一个是 deny 规则写太宽把mdp-apps下的源码也排除了Claude Code 就“看不见”业务代码返回结果会很泛。deny 只针对编译产物和依赖目录源码目录一定要放行。还有一个和 MDP 1.3.0 重构相关的点模块从mdp-core改名成mdp-base、mdp-platform改名成mdp-apps之后如果你在 Claude Code 的提示或配置里还写旧名字它会找不到路径。升级后第一件事就是把配置和提示里的模块名同步过来。6. 后续怎么用把通道固定下来按场景分流配置跑通之后建议把settings.json纳入版本管理但 Key 永远走环境变量这样团队里每个人用自己的 Key配置骨架共享。MDP 1.3.0 的父 POM 统一成了mdp-parent版本管理已经标准化配置这块也照同样的思路做后面升级不容易乱。如果你主要是排障和接入阶段重点看 API Keys 管理和接入文档把 Key 生命周期和端点变更盯住如果你要验证模型行为是否符合预期直接用模型对话做小样本测试比在业务代码里试错快得多如果你是长期在 MDP 里做编码和 Agent 类任务比如让 Claude Code 持续参与主数据模型的维护那 Coding Plan 更适合额度和调用方式都按长期使用设计。这三个入口按你的实际场景选不用全上。最后留一个实用习惯每次升级 MDP 版本后先跑一遍第 4 节的 curl 验证再进项目实测。通道层和业务层分开验证出问题时能立刻判断是 Key 的事还是代码的事省掉大量来回猜的时间。