用 Augment Code 插件在 VS Code 中完成代码索引与智能体改码

Augment Code 是一款以编辑器插件形式提供的 AI 编程助手，它不附带自己的开发编辑器，而是挂载到 VS Code、JetBrains 系列、GitHub、Slack 甚至 Vim 等宿主环境中使用。它要解决的问题是：让 AI 在读懂整个代码库的前提下，不只是回答问题，还能直接动手改代码。适合已经在用某个编辑器、不想为了 AI 换 IDE 的开发者，也适合项目体量较大、跨文件跨模块改动频繁的团队。如果你更想先了解这个工具的整体定位，可以查看 Augment Code 的工具条目，再回到本文按步骤操作。

下面按「准备 → 索引 → 认识界面 → 选模式 → 用快捷键 → 跑一个完整例子」的顺序展开。文中涉及的价格、免费额度、上下文长度等易变信息，请以官网当前公布的信息为准。

准备工作

开始之前，需要确认几件事，否则后面的索引和对话都无法正常进行。

• 一个可用的账号：Augment 需要登录后才能使用。新用户通常有一段免费试用期，试用结束后转为付费订阅。具体试用时长与订阅价格会调整，请以官网当前信息为准，不要按旧文章里的数字做预算。
• 一个受支持的宿主编辑器：VS Code 是最常见的入口，JetBrains 系列 IDE 同样支持，此外还有 GitHub、Slack、Vim 等形态。选择你日常写代码的那个即可，不必为了用它而换编辑器。
• 插件安装：在宿主编辑器的扩展市场里搜索 Augment 并安装，安装完成后按提示登录账号。插件是唯一的入口，没有独立的桌面客户端。
• 一个准备交给它读的项目：建议先用真实项目而不是空目录，因为后续的索引、上下文理解、跨文件改写都依赖项目里实际存在的代码。

这里有一个容易忽略的前置动作：第一次把项目拖进编辑器时，会触发 Augment 的请求，需要点击 Index Codebase 表示同意建立代码库索引。 这一步不做，AI 对项目的理解就停留在「只看到你当前打开的那一个文件」的水平，后面所有依赖全局上下文的能力都会打折。

操作步骤

第一步：安装插件并登录

在 VS Code 的扩展面板中搜索 Augment，安装后重新加载窗口。首次使用会要求登录，按界面提示完成授权即可。登录状态与账号绑定，换机器时需要重新登录。

第二步：同意建立代码库索引

把项目文件夹拖入编辑器后，Augment 会弹出请求，点击 Index Codebase。索引的作用是让工具在回答和改码之前先掌握整个代码库的结构与内容，而不是临时猜测。项目越大，这一步的价值越明显；相应地，首次索引也需要一点时间，耐心等待完成再开始提问。

第三步：认识主面板的三段布局

Augment 的主面板结构很固定，从上到下分三块：

• 顶部：设置区域，用于调整工具本身的行为。
• 中部：对话记录区域，可以查看历史对话，也可以在这里新建一个对话。
• 底部：聊天输入框，所有指令都从这里发出。

面板默认停靠在 VS Code 的左侧。如果你习惯把辅助面板放在右边，直接拖动工具栏上它的图标到右侧即可，位置会被记住。

第四步：理解三种模式，选对再开口

聊天输入框提供三种模式，能力依次递增：

模式	能做什么	适合的场景
Chat	用自然语言对话，解释代码、给出实现计划、提出修改建议，由你逐条决定是否应用	读不懂一段代码、想先听方案、需要有人解释设计意图
Agent	在 Chat 的基础上，直接在代码库中创建和修改代码，自动执行整个计划	日常开发的主力模式，需求明确、希望它一次改到位
Remote Agent	具备 Agent 的全部能力，但运行在云端，可以挂机跑	任务耗时长、想让它自己跑完再回来看结果

两者的核心差别在于谁动手。Chat 只出主意，改动由你一条条应用；Agent 会把计划和改动一起落地。普通开发场景下，直接用 Agent 模式即可，省去反复确认的往返。

第五步：记住四个高频快捷键

日常使用中真正高频的操作只有几个，记住它们比记菜单路径有用得多：

• Command + L：唤起 Augment 主界面。
• Command + I：在光标处或选中区域上做局部分析与改写，适合只动一小段代码。
• Command + ;：当出现合适的批量建议时，一次性采纳这些建议。
• Tab：单行级别的建议通常直接以行内提示出现，按 Tab 接受即可，交互方式与常见的 AI 编辑器一致。

上面给出的是 macOS 下的按键。在 Windows 或 Linux 上，把 Command 换成对应的 Ctrl 键，具体以插件在你的平台上的实际绑定为准。

一个完整示例

下面用一个最小但完整的场景，把前面的步骤串起来：给现有项目加一个带 JWT 认证的用户登录功能，并在数据库里建对应的表。

1. 确认索引已完成

打开项目，确认此前已经点过 Index Codebase。如果换了一个新项目，同样会再次触发索引请求，照常同意即可。索引没完成就提问，得到的方案往往忽略项目里已有的目录结构和命名习惯。

2. 切到 Agent 模式

按 Command + L 唤起主面板，在底部输入框把模式切换为 Agent。这一步很关键：同样的需求，在 Chat 模式下只会得到一份计划，在 Agent 模式下会直接产生代码改动。

3. 用一段话把需求说清楚

在输入框里描述目标，尽量包含技术选型和边界条件，例如：

帮我实现用户登录功能，需要集成 JWT 认证，并在数据库中创建对应的表。
沿用项目现有的目录结构和错误处理方式，不要引入新的框架。

需求里写清「沿用现有结构」这类约束，能显著减少后续返工。Agent 会自主分析、规划并执行任务，过程中还可能调用 git、npm 等终端指令来推进工作，因此它给出的改动会落在真实文件上，而不是停留在聊天记录里。

4. 审阅改动

Agent 执行完毕后，逐项检查它新建和修改的文件。重点看三处：数据库表结构是否与项目现有的迁移方式一致、JWT 的签发与校验是否放在合理的位置、错误分支是否覆盖了凭证错误与过期两种情况。发现偏差时，继续在同一个对话里指出问题，让它修正，而不是自己手动改完再重新描述一遍。

5. 用局部改写收尾

如果只剩一小段逻辑不满意，不必再走一轮完整对话。把光标放到那段代码里，或选中它，按 Command + I 做局部分析与改写，改动范围会被限制在选区附近，避免牵动整个文件。

6. 接受行内建议

日常敲代码时，Augment 会在单行位置给出补全建议，按 Tab 接受。当积累了一批可采纳的建议时，按 Command + ; 批量采纳，比逐条确认快得多。

注意事项

• 没有独立编辑器：Augment 只以插件形式存在，所有能力都在宿主编辑器内发生。不要期待一个单独的 Augment 客户端。
• 索引是前提：首次拖入项目必须同意 Index Codebase。跳过这一步，跨文件、跨模块的理解能力就无从发挥。
• 费用会变：新用户有免费试用期，之后转为按月订阅。试用时长与价格请以官网当前信息为准，本文不给出具体数字。
• 模式选错会白费功夫：想让工具直接改代码却停在 Chat 模式，只会拿到一份计划；反过来，只想听方案却开了 Agent，可能在你没细看时就产生了改动。开口前先确认模式。
• 快捷键因平台而异：文中给出的是 macOS 绑定，其他平台以插件实际设置为准。
• Agent 会执行终端指令：它能调用 git、npm 等命令推进任务，这意味着改动是真实落盘的。执行后务必审阅 diff，不要默认结果一定正确。
• 上下文长度与多代码库支持：这类能力的具体数值随版本调整，请以官网当前说明为准，不要按旧文章里的参数做容量规划。

把上面的流程走顺之后，日常开发基本就是三件事的循环：用 Command + L 唤起面板描述需求，用 Agent 落地改动，用 Command + I 和 Tab 处理零散的小修改。项目越复杂，前面那次代码库索引带来的收益就越明显。