Augment Code
面向软件开发团队的 AI 智能体开发平台。
Augment Code 提供 IDE 插件、Auggie CLI 与 Cosmos 云端代理。终端可围绕项目分析和修改代码，Cosmos 则把环境、代理模板、工具能力和事件触发组合成持续工作流。
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
- 使用条件
- 非交互能力及云端访问取决于配置与协议
如何使用 Augment Code
- 准备终端环境
按官方要求安装 Node 20 或更新版本，并使用兼容的 zsh、bash 或 fish 等 shell。
- 安装并登录 Auggie
按官方 npm 安装说明安装 @augmentcode/auggie，使用 auggie login 完成账户登录。
- 进入目标项目启动
切换到项目目录再运行 auggie，使索引和工具工作在预期工程范围内。
- 限定任务并核对产物
描述单一问题、允许改动和验证命令，检查工具执行及差异；自动化需求另行确认 --print 权益。
在终端修复一个错误
适合：熟悉项目测试命令的工程师
- 准备输入
- 小范围错误、项目目录和验收命令
- 操作方法
- 编辑建议：安装并登录 Auggie，在正确目录启动交互会话，先解释相关代码，再限定修改与验证范围。
- 预期交付物
- 代码差异与执行输出
- 人工检查
- 检查自动索引的目录、实际修改和测试结果，避免只凭结束回复验收。
搭建 PR 事件审查
适合：能管理仓库集成的团队
- 准备输入
- 目标仓库、审查规则和云端运行环境
- 操作方法
- 编辑建议：先定义 Environment 与审查 Expert，再接入 PR 触发；用测试仓库检查事件和输出是否对应。
- 预期交付物
- 可追踪的云端审查会话
- 人工检查
- 检查环境变量、仓库范围和共享可见性，再扩大自动触发范围。
把结果接入脚本
适合：有 CI 权限的工程师
- 准备输入
- 已授权的仓库、固定任务与输出格式
- 操作方法
- 编辑建议：确认协议允许非交互模式后使用 --print，小范围测试输出和退出行为，再考虑 --quiet 简化结果。
- 预期交付物
- 供后续脚本读取的检查输出
- 人工检查
- 无人交互流程应有明确失败判定，不把安静输出当作任务成功。
界面与参考图片
开始前需要了解
索引范围影响任务结果
CLI 自动索引当前项目，关联仓库缺失时可能遗漏系统依赖。应先确认可用上下文再委派跨仓库任务。
非交互模式可能受协议限制
官方注明企业协议未包含时可禁用非交互功能。能够使用交互终端不等于已经可以接入 CI。
云端环境需单独配置权限
Cosmos 在云端沙箱虚拟机运行，环境、工具能力与文件可见性可共享或私有，应按实际使用范围配置。
CLI 需要 Node 20+；非交互自动化可能受企业协议限制。
账号权限、费用与可用功能请以官方入口的当前说明为准。重要结果应先检查，再用于实际工作。
常见问题
Augment 只有编辑器插件吗？
不是。当前文档同时列出 IDE 插件、Auggie CLI 和 Cosmos 云端自动化。
Auggie 最低需要什么环境？
官方要求 Node 20 或更新版本与兼容 shell，并登录 Augment 账户。
Expert 和 Environment 有什么区别？
Expert 定义代理的行为和能力，Environment 定义运行镜像、仓库与环境变量，Session 则记录一次工作。
可以直接放进 CI 吗？
CLI 提供 --print，但企业协议可能限制非交互能力；先确认权益、凭据及失败处理再接入。
