---
title: "Claude Code 配合 Z Code 使用指南"
description: "把「选一段就地改」和「开对话处理整份文件」分开：用内联建议做局部润色，用面板做结构重排与批量处理，并给出三种任务的分工表。"
updated: 2026-11-13
canonical: https://docai.cc/learn/z-code-integration-guide/
markdown_mirror: https://docai.cc/learn/z-code-integration-guide.md
---
## 两个工具，其实是两种改稿姿势

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

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

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

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

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

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

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

## 内联编辑怎么用才不跑偏

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

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

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

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

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

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

## 补全：只负责形状

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

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

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

## 分工表

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

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

## 一次完整的练习

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

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

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

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

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

## 什么时候干脆不用它

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

下一步是把背后的模型换掉：为什么很多人用国内的 GLM 和通义千问，以及选哪个更合适，见[接入国内大模型怎么选](/learn/chinese-llm-providers-compared/)。