如何在 VS Code 安装并使用 Augment Code:扩展、登录、内联补全与 Agent 模式
安装 Augment 扩展、浏览器登录并同步仓库,再拿到第一条内联建议或用 Agent 完成一项可审查的小改动。
第一次在 VS Code 里用 Augment Code,卡住的通常不是提示词,而是扩展有没有装对、Augment 账号有没有在浏览器里登录成功,以及工作区索引有没有跑完。按官方文档从 Marketplace 安装 augment.vscode-augment,完成 Google / Microsoft / 邮箱验证码登录,再在自己的项目里触发内联补全或 Agent 模式下的可审查改动。
检索词是 如何在 VS Code 安装并使用 Augment Code。下文对照 Augment 文档 docs.augmentcode.com/setup-augment/install-visual-studio-code、登录 docs.augmentcode.com/setup-augment/sign-in、补全 docs.augmentcode.com/using-augment/completions、Agent docs.augmentcode.com/using-augment/agent,以及 Marketplace 项 augment.vscode-augment。这是 Augment 的 IDE 助手,不是本站会议产品。要约短会对齐 diff,用 wbmeet 建房即可,步骤见 如何创建与加入房间。
先核对 Augment 在 VS Code 里做什么
Augment Code 是面向大型代码库的 AI 编程平台:通过 Context Engine 索引工作区,在 Augment 面板里提供 Chat、Agent(可改多文件、跑终端、接 MCP)以及 IDE 原生集成的内联补全。VS Code 扩展 id 为 augment.vscode-augment。官方要求使用较新的 VS Code;扩展页可选预发布版,但可能不稳定。
安装扩展、登录、同步工作区
- 1
从 VS Code Marketplace 安装
打开 VS Code,
Cmd+Shift+X/Ctrl+Shift+X,搜索 Augment,确认扩展augment.vscode-augment,点击 Install。需要预发布版时,在已安装扩展上选择 Switch to Pre-Release Version。 - 2
打开 Augment 面板并 Sign In
点击活动栏 Augment 图标或官方快捷键,点 Sign In。在浏览器用 Google、Microsoft 或邮箱一次性验证码登录,首次需接受条款。成功后状态栏图标显示已登录。
- 3
同步(索引)工作区
首次在新仓库会提示 Sync your workspace。Augment 会上传受
.gitignore与.augmentignore约束的文件以建立代码库感知。可在 Workspace Context 查看进度;敏感目录写入.augmentignore。 - 4
试内联补全(若计划支持)
在源码中打字,灰色建议按
Tab接受、Esc拒绝。Augment 面板 overflow 可开关自动补全;设置含augment.completions.enableAutomaticCompletions等。非 Enterprise 账号在 2026-03-31 后可能无 Completions。
Agent 模式:跨文件改动与审查
- 1
在输入框选择 Agent 模式
Augment 面板输入框上方选 Agent(另有 Agent Auto:更自主地改文件与跑命令;第一小时建议用默认 Agent 并逐步批准终端)。用模型下拉为当前工作区选 LLM。
- 2
附加上下文并提交任务
默认含工作区与当前文件。附加文件/文件夹或图片。第一小时建议只读或小事:「说明模块入口」或「给 helper 补单测,先展示 diff」。可用 Enhance Prompt 按仓库惯例润色提示。
- 3
审查 diff、Checkpoint 与 Stop
展开步骤查看 diff、终端与 MCP 结果。用 Checkpoint 回滚;默认 Agent 跑终端前会暂停等你点播放;Stop 可中断。Quick Ask Mode 仅只读工具,适合先摸底。
# First hour · Augment Code · VS Code · 2026-09
# Extensions → Augment (augment.vscode-augment)
# Panel → Sign In → Google / Microsoft / email code
# Sync workspace · .augmentignore for secrets
# Tab completions (Enterprise after 2026-03-31 policy)
# Agent → small task → review diff · checkpoint补全、Agent 与 Chat 对照
| 能力 | 适合做什么 | 第一次注意 |
|---|---|---|
| 内联补全 | 打字续写 | 2026-03-31 后仅 Enterprise |
| Chat | 解释与规划 | 只问不改,热身用 |
| Agent | 多文件功能与测试 | 默认逐步批准终端 |
| Agent Auto | 更自主执行 | 第一小时别开 Auto |
| 索引 | 全库上下文 | .gitignore + .augmentignore |
登录后仍离线
查浏览器弹窗、条款确认与 VS Code 外链许可。Command 菜单 Sign Out 后重登。
没有灰色补全
查 overflow 与 augment.completions.* 设置;确认 Enterprise 计划(2026-03-31 后非 Enterprise 可能无 Completions)。
Agent 改太多
Checkpoint 回滚;缩小任务;Quick Ask 只读;终端步骤人工批准。
官方路径:装 augment.vscode-augment → Sign In → Sync workspace →(Enterprise)Tab 补全 → Agent 小任务并审查 diff。以 docs.augmentcode.com 与账号页为准。
- 索引会上传代码
- 开启 Augment 后工作区文件(除 ignore 规则)会同步到 Augment 云端。用 .augmentignore 排除密钥;遵守企业策略。
- Completions 与 Agent 不同
- 补全是内联建议;Agent 是多步执行。2026 年中非 Enterprise 用户应把第一小时放在 Agent/Chat 与索引。
- 教程页不是会议说明书
- 只讲 Augment 第一次。短会白板见 wbmeet 与 对照笔记。
还想核对的问题
必须用 Google 或 Microsoft 吗?
官方支持 Google、Microsoft 与邮箱一次性验证码。会跳转浏览器,完成后回到 VS Code。
个人计划还能用内联补全吗?
文档写明 2026-03-31 起非 Enterprise 不再支持 Code Completions;Enterprise 仍支持。无补全时改用 Chat/Agent。
Agent 和 Chat 怎么选?
Chat 适合问答;Agent 自动跨文件实现、跑终端、接 MCP。跨多文件新功能与自动执行任务应选 Agent。
第一个任务必须改生产代码吗?
不必。先只读问题,再用 Agent 做可回滚小改动,审查 diff 与 Checkpoint。