🚀 为什么选择 Amp

Amp 是面向终端和编辑器的前沿编程代理，基于以下四大原则构建：

核心特性

• 🎯
  多模型架构 — Opus 4.5、GPT-5.1 以及快速模型，各取所长
• 💡
  固执己见 — 你始终在使用 Amp 的精华部分，不好用的功能会被砍掉
• 🧵
  线程管理 — 保存和分享你与 Amp 的交互，就像版本控制一样
• 🔌
  IDE 集成 — 支持 VS Code、Cursor、JetBrains、Neovim 等编辑器

📦 开始安装

命令行安装 (推荐)

适用于 macOS、Linux 和 WSL，支持自动更新：

curl -fsSL https://ampcode.com/install.sh | bash

运行交互模式（首次运行会提示登录）：

amp

也可以通过 npm 安装：

npm install -g @sourcegraph/amp

编辑器扩展

📖 使用指南

代理模式

Amp 提供两种模式：

在 CLI 中按 Ctrl+O 打开命令面板，输入 mode 切换模式。

提示技巧

• 明确表达 — 用 "做 X" 而不是 "你能做 X 吗？"
• 保持简短聚焦 — 大任务拆分成多个线程，每个线程专注一个子任务
• 提供已知信息 — 告诉代理查看哪些文件、运行什么命令
• 明确不写代码 — 如果只想研究和规划，说 "只做计划，不要写代码"
• 及时放弃噪音线程 — 失败尝试积累太多时，开启新线程更好

示例提示词

# 修复构建错误
运行 `pnpm run build` 并修复所有错误

# 查看本地开发
查看 `http://localhost:3000` 的 UI 组件，让它看起来更简洁

# Git 操作
运行 git blame 查看这个文件，找出谁添加了那个新标题

# 并行转换
用 3 个子代理把这 5 个 CSS 文件转换成 Tailwind

# 只做规划
研究如何添加实时聊天功能，但不要写代码

📋 AGENTS.md 配置

Amp 从 AGENTS.md 文件读取代码库结构、构建/测试命令和编码规范。

文件引用

在 AGENTS.md 中使用 @ 引用其他文件：

参见 @doc/style.md 和 @specs/**/*.md

提交时参考 @doc/git-commit-instructions.md

条件应用 (Globs)

使用 YAML front matter 的 globs 字段，让规则只在特定文件类型时生效：

---
globs:
  - '**/*.ts'
  - '**/*.tsx'
---

遵循以下 TypeScript 规范：
- 永远不使用 `any` 类型
- 优先使用 interface 而非 type
- ...

🔄 线程交接 (Handoff)

Amp 在保持线程小而聚焦时效果最好。使用命令面板中的 handoff 命令，将当前线程的相关文件和上下文交接到新线程。

交接示例

# 扩展功能
现在也为团队实现这个功能，不只是个人用户

# 执行计划
执行创建计划的第一阶段

# 全局修复
检查代码库的其余部分，找到需要同样修复的地方

🛠️ 工具系统

工具是底层模型完成任务的手段。运行 amp tools list 查看所有可用工具。

子代理 (Subagents)

Amp 可以通过 Task 工具生成子代理，用于独立执行复杂任务。每个子代理有自己的上下文窗口和工具访问权限。

注意：子代理独立工作，无法互相通信，你无法在任务中途指导它们。主代理只接收最终摘要。

Oracle (神谕)

Amp 可以访问一个强大的"第二意见"模型（目前使用 GPT-5），更适合复杂推理或分析任务，但速度稍慢、成本稍高。

使用示例

# 代码审查
使用 oracle 审查最后一次提交的更改

# 寻求更好方案
问问 oracle 有没有更好的解决方案

# 调试复杂问题
这些文件有 bug... 帮我修复，尽可能多用 oracle

Librarian (图书管理员)

Librarian 可以搜索远程代码库，包括 GitHub 上的所有公开代码和你的私有仓库。适用于跨仓库研究或查阅框架/库源码。

MCP 服务器

通过 MCP (Model Context Protocol) 添加额外工具。在配置文件的 amp.mcpServers 中配置：

"amp.mcpServers": {
  "playwright": {
    "command": "npx",
    "args": ["-y", "@playwright/mcp@latest", "--headless"]
  },
  "semgrep": {
    "url": "https://mcp.semgrep.ai/mcp"
  },
  "linear": {
    "command": "npx",
    "args": ["mcp-remote", "https://mcp.linear.app/sse"]
  }
}

提示：工具太多会降低模型性能。选择暴露少量高质量工具的 MCP 服务器，禁用不使用的工具。

🔐 权限管理

在配置文件的 amp.permissions 中配置工具使用权限：

"amp.permissions": [
  // git commit 前询问
  {
    "tool": "Bash",
    "matches": { "cmd": "*git commit*" },
    "action": "ask"
  },
  // 拒绝 python 命令
  {
    "tool": "Bash",
    "matches": { "cmd": ["*python *", "*python3 *"] },
    "action": "reject"
  },
  // 允许所有 playwright MCP 工具
  { "tool": "mcp__playwright_*", "action": "allow" },
  // 其他 MCP 工具需询问
  { "tool": "mcp__*", "action": "ask" }
]

可用动作：allow (允许)、reject (拒绝)、ask (询问)、delegate (委托给外部程序)

💻 CLI 命令行

基本用法

# 交互模式
amp

# 管道输入
echo "提交所有更改" | amp

# 执行模式 (-x)
amp -x "这个文件夹里哪些是 markdown 文件？"

# 允许所有操作
amp --dangerously-allow-all -x "用 sed 替换 README 中的 2024 为 2025"

Shell 模式

以 $ 开头直接执行 shell 命令，命令和输出会包含在上下文中：

$ git status
$ ls -la

使用 $$ 进入隐身模式，命令执行但不加入上下文。

JSON 流输出

使用 --stream-json 获取结构化输出：

amp --execute "3 + 5 = ?" --stream-json

常用快捷键

⚙️ 配置选项

配置文件位置

常用设置

代理和证书

在企业网络中使用时，设置以下环境变量：

export HTTP_PROXY=your-proxy-url
export HTTPS_PROXY=your-proxy-url
export NODE_EXTRA_CA_CERTS=/path/to/certificates.pem

💰 定价方案

⌨️ 键盘快捷键 (VS Code)

macOS

Windows / Linux

🆘 获取帮助

• Twitter: @AmpCode
• 邮箱: amp-devs@ampcode.com
• 社区: Build Crew

支持的平台

macOS、Linux、Windows (推荐 WSL)。JetBrains 集成支持所有 IDE (2025.1+)。