Augment Code
面向软件开发团队的 AI 智能体开发平台。
Augment Code 提供 IDE 插件、Auggie CLI 与 Cosmos 云端代理。终端可围绕项目分析和修改代码，Cosmos 则把环境、代理模板、工具能力和事件触发组合成持续工作流。
可以用来完成：局部修复、PR 审查及事件响应
Augment Code 能做什么
日常终端任务可从 Auggie 开始：登录后在项目目录运行，平台自动建立代码上下文。自动化任务需要另行确认非交互权限和组织配置。
Cosmos 的 Expert、Environment 与 Trigger 是不同对象：定义怎么做、在哪运行和何时启动，不能只建一个代理名称就认为完整流程已配置。
在项目目录建立上下文
Auggie 在项目目录运行时自动索引工程；相关仓库的可用上下文会影响其理解。开始任务前应确认当前目录与目标一致。
终端交互与单次执行
普通 auggie 提供持续对话界面；--print 执行一次并输出到标准输出，--quiet 可减少过程输出。非交互能力可能受企业协议限制。
组合可复用的代理和环境
Cosmos 中 Expert 保存行为与工具配置，Environment 包含虚拟机镜像、仓库和环境变量；Session 记录消息与工具调用。
按事件唤起云端工作
Cosmos 可由 GitHub、Linear、Slack、PagerDuty、定时计划或 webhook 触发。Automation 负责把事件与代理启动或唤醒规则连接起来。
- 核心用途
- 代码上下文、终端代理与云端自动化
- 可完成的工作
- 局部修复、PR 审查及事件响应
- 如何开始
- 准备 Node 20+，在项目内登录运行 Auggie
- 使用条件
- 非交互能力及云端访问取决于配置与协议
可以完成哪些工作
按你的目标查看准备资料、操作方法和交付结果。
在终端修复一个错误代码差异与执行输出
适合：熟悉项目测试命令的工程师
- 准备什么
- 小范围错误、项目目录和验收命令
- 怎么完成
- 编辑建议：安装并登录 Auggie，在正确目录启动交互会话，先解释相关代码，再限定修改与验证范围。
- 完成后得到什么
- 代码差异与执行输出
- 交付前检查
- 检查自动索引的目录、实际修改和测试结果，避免只凭结束回复验收。
搭建 PR 事件审查可追踪的云端审查会话
适合：能管理仓库集成的团队
- 准备什么
- 目标仓库、审查规则和云端运行环境
- 怎么完成
- 编辑建议：先定义 Environment 与审查 Expert，再接入 PR 触发；用测试仓库检查事件和输出是否对应。
- 完成后得到什么
- 可追踪的云端审查会话
- 交付前检查
- 检查环境变量、仓库范围和共享可见性，再扩大自动触发范围。
把结果接入脚本供后续脚本读取的检查输出
适合：有 CI 权限的工程师
- 准备什么
- 已授权的仓库、固定任务与输出格式
- 怎么完成
- 编辑建议：确认协议允许非交互模式后使用 --print，小范围测试输出和退出行为，再考虑 --quiet 简化结果。
- 完成后得到什么
- 供后续脚本读取的检查输出
- 交付前检查
- 无人交互流程应有明确失败判定，不把安静输出当作任务成功。
如何使用 Augment Code
- 准备终端环境
按官方要求安装 Node 20 或更新版本，并使用兼容的 zsh、bash 或 fish 等 shell。
- 安装并登录 Auggie
按官方 npm 安装说明安装 @augmentcode/auggie，使用 auggie login 完成账户登录。
- 进入目标项目启动
切换到项目目录再运行 auggie，使索引和工具工作在预期工程范围内。
- 限定任务并核对产物
描述单一问题、允许改动和验证命令，检查工具执行及差异；自动化需求另行确认 --print 权益。
界面与操作参考
开始前需要了解
索引范围影响任务结果
CLI 自动索引当前项目，关联仓库缺失时可能遗漏系统依赖。应先确认可用上下文再委派跨仓库任务。
非交互模式可能受协议限制
官方注明企业协议未包含时可禁用非交互功能。能够使用交互终端不等于已经可以接入 CI。
云端环境需单独配置权限
Cosmos 在云端沙箱虚拟机运行，环境、工具能力与文件可见性可共享或私有，应按实际使用范围配置。
CLI 需要 Node 20+；非交互自动化可能受企业协议限制。
账号权限、费用与可用功能请以官方入口的当前说明为准。重要结果应先检查，再用于实际工作。
常见问题
Augment 只有编辑器插件吗？
不是。当前文档同时列出 IDE 插件、Auggie CLI 和 Cosmos 云端自动化。
Auggie 最低需要什么环境？
官方要求 Node 20 或更新版本与兼容 shell，并登录 Augment 账户。
Expert 和 Environment 有什么区别？
Expert 定义代理的行为和能力，Environment 定义运行镜像、仓库与环境变量，Session 则记录一次工作。
可以直接放进 CI 吗？
CLI 提供 --print，但企业协议可能限制非交互能力；先确认权益、凭据及失败处理再接入。
从综合工具选择角度评估Augment Code
把综合工具选择需要的条件列清楚，再比较工具。阅读本页的产品用途、步骤与限制，再逐项确认下面的问题；这些是选型方法，不表示每款工具都具备同样能力。
先看交付
你需要的是可编辑文档、图片、代码，还是有出处的资料表？
再看输入
资料能否上传、格式能否读取、敏感内容能否交给所选服务？
最后试用
用小样检查实际结果，再确认费用、导出和后续修改条件。
选择一个小样任务，先检查结果与交付格式，再决定是否用于更多资料。
