跳到正文
docai.cc

DOCAI · 课程 · L2 · 18 分钟 · 快速上手

Claude Code 配合 Z Code 使用指南

把「选一段就地改」和「开对话处理整份文件」分开:用内联建议做局部润色,用面板做结构重排与批量处理,并给出三种任务的分工表。

Claude Code 小白 · 认识 Claude Code

你将学会

  • 能判断一次修改该用内联还是用对话
  • 装好第二个插件并确认入口可用
  • 用提示词约束局部改动,避免它顺手改全文

两个工具,其实是两种改稿姿势

你在编辑器里处理一份报告,会遇到两类需求。一类是「这一段读着别扭」,另一类是「整篇结构不对,重新排一遍」。前者几分钟能解决,后者要来回讨论好几轮。

把这两类混在一个窗口里做,代价很明显:为了改一句话,你要把整篇文档贴进对话,再在一堆回复里找出那一句。改完还得自己复制回去,中间任何一步出错,原文就可能被覆盖。

所以分工的原则只有一句:改一段就用内联,改一篇就用对话。

另一个工具就是为前半句准备的。Z Code 是一款装在编辑器里的 AI 插件,核心动作是:选中一段文字,就地给出改写建议,不用把整篇文档搬进对话窗口。它不是 Claude Code 的替代品,而是补上「就地改」这一块。至于连接方式,是否直连、需不需要额外配网络,取决于你装的版本和账号所在区域,装好先做一次连接测试再下结论。

装法和上一节一样:打开扩展市场,搜名字,认准发布者,装完重启。成功之后侧边栏会多一个图标,或者多出一组快捷键入口。不同版本的入口位置不完全一致,以装完后的实际界面为准。搜不到时先确认名字有没有拼错,再考虑该插件是否已改名或下架;找不到原插件时,同类插件里带「选中文字就地改写」的入口,用法逻辑是一样的。

两个插件同时开着并不冲突,它们各自有自己的面板。真正的冲突在于你自己:同一个任务两边都发一遍,改出来的版本就对不上了。选定一边做,另一边别动。

这里最容易误会的一点:它并不是「更便宜的 Claude Code」。它擅长的是你眼前这段文字,不是整个项目。让它承担跨文件整理,它没有那个视野;反过来,用主面板改一句话,又绕了远路。

内联编辑怎么用才不跑偏

操作很轻:选中一段文字,按调用键,在弹出的输入框里写要求,接受或拒绝建议。

调用键在不同系统和版本里可能是 Ctrl + I 或 Cmd + I,以插件当前说明为准。第一次装完先试一次,确认按下去有反应,再拿它处理正式文件。

关键在于要求怎么写。选中了哪一段,就把范围锁死在那一段:

只改选中的这一段。把「进行了」「开展了」这类动词换成更直接的写法,意思和数字都不变,长度控制在原段落的九成左右。

三个约束各自有用:只改选中,防止它顺手改相邻段落;换掉空话,是具体动作;长度限制,避免越改越长。

反过来,只写「帮我优化一下」,它很可能给你一段意思类似但事实被改动的文字,你还得逐句核对。

补全:只负责形状

补全是同一套逻辑的轻量版:输入过程中它给续写建议,按接受键采纳。适合的场景高度固定:同一套模板的重复段落、清单里的下一条、格式一致的表格行。

不适合的场景也很明确:涉及数字、日期、人名、条款的内容。建议看起来顺畅,但你不知道这个数字从哪来。补全只负责形状,内容必须自己填。

养成一个习惯:接受补全后立刻读一遍。补全的代价是「看起来对」,而看起来对恰恰最容易骗过眼睛。

分工表

任务 用哪个 原因
改一段语气、换几个词 内联 范围小,改完当场能看
给整份文档重排章节 对话 要通读结构,需要多轮确认
一次处理一整个文件夹 对话 内联一次只能处理选中内容
补全重复的模板段落 补全 形状固定,逐句写太慢
换一个模型试效果 设置 属于工具配置,不用开任务

实际场景:一份季度总结,第三节写得太散,选中重写,用内联;整篇要按「结论—数据—计划」重排,回面板里说清楚;下周的周报和本周格式一样,用补全把骨架拉出来。

一次完整的练习

准备一个空白文件,写三段自我介绍,每段三四行。

第一步,选中第一段,调出内联输入,要求「压到两行以内,保留事实」;接受后对比长度和原意。

第二步,打开对话面板,让它读整个文件,把三段合并成一段并保留所有事实,先给出方案不要直接写。

第三步,看它的方案,改一处要求,再让它执行;执行完回到编辑器对比差异。

做完这三步,你手上就有了两种改法的实际手感,比记快捷键有用。

什么时候干脆不用它

只改一个错别字、调一次缩进,自己动手更快。工具的价值在「需要理解和重写」的地方,不在机械替换。判断标准很简单:如果一句话能说清改哪里、怎么改,而你自己两秒能改完,就别多开一个窗口。

下一步是把背后的模型换掉:为什么很多人用国内的 GLM 和通义千问,以及选哪个更合适,见接入国内大模型怎么选。

自测

先自己回答,再展开对照;答不上来就回到对应小节。
  1. 01什么样的话适合用内联改,什么样的话必须开对话?看答案

    只涉及你选中那一段的措辞、语气、句式,用内联;要动全文结构、跨文件处理或需要多轮追问的,用对话。

  2. 02内联改完发现不对,第一反应是什么?看答案

    拒绝或撤销,别在已有的错误文本上继续让它改。先回到原句,再把要求说得更具体。

查看 Markdown

涉及的概念

在知识树上