上周有个朋友问我一个问题：
"我们团队要做DITA文档，用Claude Code不就行了？为啥还要花钱买Oxygen AI Positron？"
我当时愣了一下。说实话，我一开始也想过这个问题------Claude Code能读写文件、能调用命令行、还能装各种Skill，看起来啥都能干。
但后来我在实际项目里试了一圈，发现这两个工具根本不是一个赛道的。
今天把我踩过的坑和最终的选择分享给你。
- 1 -
先说结论
Oxygen AI Positron （以下简称OAP）是专注DITA文档写作的"专业相机"，Claude Code是啥都能干的"旗舰手机"。
拍专业照片得用专业相机，但手机在日常场景更方便。
对DITA团队来说，最佳方案是：OAP为主干创作工具，Claude Code做CI自动化辅助。
- 2 -
它俩到底有什么不一样？
我列个表，你一看就明白：
| 对比维度 | OAP | Claude Code |
|---|---|---|
| 它是谁？ | Oxygen编辑器里的AI写作助手 | 能读写文件的AI编程智能体 |
| 最擅长啥？ | 写DITA/XML文档、校验标签、一键发布 | 写代码、操作Git、调用命令行工具 |
| 懂DITA吗？ | 天生就懂------知道<task>里该放什么标签 |
不懂------你得一次次告诉它DITA规则 |
| 适合谁用？ | 技术文档工程师 | 软件开发工程师 |
我打个比方：
OAP像是专门给DITA设计的相机------光圈、快门、ISO都调好了，按下去就能拍出专业照片。
Claude Code像是一部功能强大的手机------能拍照、能剪视频、能打游戏、能办公，但拍照这块毕竟不是它的主场。
看完这个表，你可能会想：那我用Claude Code写，写完再丢给Oxygen编辑器校验行不行？
理论上可以。但实际上------你会在两个工具之间来回切，切到怀疑人生。
我后来的做法是：一个工具干到底。写、改、校验、发布，全在OAP里完成。
- 3 -
我踩过的坑
刚开始我试过用Claude Code写DITA，踩了四个坑：
第一个坑：标签乱掉
文档一长，Claude Code就容易漏掉闭合标签。比如</p>忘写了，或者把标签顺序搞错。
DITA对标签顺序有严格要求------任务的步骤区，子元素必须按这个顺序出现：前置条件 → 背景 → 步骤 → 结果 → 示例 → 后续操作。
Claude Code不懂这些规则，经常放错位置。
第二个坑：乱修文档
遇到DITA报错，Claude Code有时候会直接删掉一整段内容来"消除错误"。
有一次它把客户的一个完整操作步骤删了，幸亏我发现得早。要是直接入库，后果你想想。
第三个坑：翻译毁标签
翻译带标签的句子时，Claude Code经常把XML标签弄坏。
翻译公司导进去就报错，来回返工了好几次。
第四个坑：不懂"积木式写作"
DITA文档像搭积木：一个Topic是一块积木，可以被多处引用。
Claude Code习惯写"长篇大论"的文章，经常把本来该拆成多个Topic的内容写成一整篇，或者把跨文件引用（conref）的内容直接复制粘贴过来。
写完是写完了，但后面维护的时候你会疯掉。
- 4 -
为什么DITA团队一定要用OAP？
踩完坑之后，我总结了四个理由。
理由一：DITA标签规则太严格，通用AI管不住
DITA有300多种标签，每种标签能放在哪里、能包含什么、出现顺序，都有严格规定。
OAP在写文档时会实时检查是否符合规则，错了立刻提醒。Claude Code只能"凭感觉"写，写错了也不知道。
理由二：天生懂"积木式写作"
OAP知道什么时候该开新Topic，什么时候该引用已有内容。不用你每次提醒。
理由三：Oxygen编辑器整个生态
OAP不是独立工具，它嵌在Oxygen XML Editor里面，能直接用到：
-
可视化编辑（像Word一样写文档，不用看XML代码）
-
智能补全（自动提示下一个合法标签）
-
一键发布（点一下就能生成PDF/HTML5）
-
在线评审（Content Fusion网页协作审稿）
-
Planner智能体模式（可自主规划多步任务）
-
自定义Skill录制（把重复操作录成AI动作）
-
Git Client 5.6.0深度集成（图形化分支管理、AI解读提交记录）
Claude Code在命令行里改XML，就像蒙着眼睛干活。
理由四：有Claude Code没有的文档级功能
-
能看懂整个DITA Map（文档目录树），不只盯着一个文件
-
能自动把一个太长的Topic拆分成多个
-
能检查所有跨文件引用是否正确
-
能预览不同读者看到的版本（比如管理员版vs普通用户版）
- 5 -
在DITA全流程中，谁更好用？
我画了个表，你对照自己的场景：
| 文档环节 | 更好用的工具 | 为什么？ |
|---|---|---|
| 需求梳理 | Claude Code | 通用对话能力更强，还能对接JIRA/Confluence |
| 数据转换（旧文档转DITA） | OAP | 自带Word→DITA转换引擎，一键批量处理 |
| 内容创作 | OAP | 所见即所得，自动补全标签，实时检查语法错误 |
| DITA校验与修复 | OAP | 自动检查标签对不对、引用断没断，一键修复 |
| 内容评审 | OAP | 支持像Word一样的修订模式，还可以Web评审 |
| 多语言翻译 | OAP | 直接对接翻译工具链，保留标签不乱 |
| 版本管理 | OAP | Oxygen 28.1内置Git Client，图形化管理分支 |
| 批量发布 | 各有千秋 | OAP一键发布更简单，Claude Code做CI自动发布更强 |
我建议这么用：
需求梳理 Claude Code → 产出需求清单
↓
内容创作 OAP → 产出DITA文档
↓
DITA校验 OAP → 自动修复语法错误
↓
评审修订 OAP → Web协作审稿
↓
多语言翻译 OAP → 导出XLIFF给翻译公司
↓
版本管理 OAP → Git提交/分支管理
↓
批量发布 Claude Code → CI自动发布PDF/HTML5，当然也可以使用CI工具，如Jenkins
这样分工的核心逻辑是：创作和校验用专业工具，自动化和集成用通用工具。
别想着用一个工具搞定所有事------专业的事，给专业的工具。
- 6 -
有一条红线
绝对不要用Claude Code直接改DITA的结构性内容------比如拆Topic、改引用关系、重构标签。
Claude Code改完的内容，必须先经过Oxygen编辑器的DITA校验才能入库。
别问我怎么知道的。
上个月，我用Claude Code重构了一个客户项目的topic结构，改完觉得没问题，直接提交了。
结果第二天，客户打开ditamap：一半的引用路径断了。
从那以后，我定了一条红线：Claude Code可以辅助，但入库前必须经过Oxygen编辑器的DITA校验。
你们团队现在用什么工具做DITA？
-
A. 只用Oxygen，没用过AI辅助
-
B. 在用Claude Code，踩过类似的坑
-
C. 两个都在用，分工明确
-
D. 还没开始做结构化，在调研
评论区聊聊～