恭喜你成功安装了 Amp。本手册将帮助你充分利用它的功能。

简介

什么是 Amp？

Amp 是由 Sourcegraph 构建的一款 Agentic 编程工具。它可以在 VS Code（以及兼容的分支如 Cursor、Windsurf 和 VSCodium）中运行，也可以作为 命令行工具 使用。它还支持多人协作 —— 你可以共享对话线程，与团队协作开发。

设计原则

  1. Amp 对 token 使用（也就是成本）没有限制。我们唯一的目标是让它对你有价值，而不是控制成本。
  2. 没有模型选择器，总是使用最强模型。你无需选择模型，我们会为你选最优的。我们不提供一堆复选框，而是全力发挥最佳模型的全部能力。
  3. 我们假设你就是想获得模型的全部原始能力。换句话说，使用 Amp 就像是直接在和模型对话，Amp 只是你与模型之间的“外壳”。
  4. 为变化而生。那些紧贴当前模型能力构建的产品将在几个月内被淘汰。

快速开始

前往 ampcode.com 登录，并按照提示在 VS Code（或兼容的分支如 Cursor、Windsurf 和 VSCodium）中安装 Amp 插件，同时安装 CLI。

使用 Amp

如何撰写 Prompt

Amp 目前大多数任务使用 Claude Sonnet 4 模型。为了获得最佳效果，请遵循以下提示：

  • 明确说明你的需求，不要让模型猜。
  • 在 Amp 中发送消息需要按下 Cmd/Ctrl + Enter，而不仅仅是 Enter，这是为了提醒你认真提交请求。
  • 把大型任务拆成多个子任务，每个用一个线程处理。
  • 使用项目中的 AGENT.md 文件指导 Amp 如何运行测试和构建步骤，避免执行不当操作。

以下是我们与 Amp 一起使用的 Prompt 示例：

  • “查看 src/my/file.ext，把它改为每 200ms 只发送一次请求。在现有的测试文件中添加测试。”
  • “运行 <build command> 并修复所有错误”
  • “访问 <local development server url> 查看这个 UI 组件，然后将其修改为更简约的样式，并通过截图频繁检查效果。”
  • “在我打开的文件上运行 git blame，找出谁添加了那个新标题”
  • “运行 git diff 查看其他人写的代码，认真审查并指出可能遗漏的边缘情况”
  • “运行 git diff 查看当前更改，删除调试语句”
  • “使用 git log 找出添加这段代码的 commit，查看整个提交内容，然后帮我修改这个功能”
  • “用图示解释 AutoScroller 类与 ViewUpdater 类之间的关系”
  • “使用 psql 连接本地数据库，把 image uploads 表中所有上传内容的所有者改为我（bob@example.com）”

你也可以看看 Thorsten Ball 写的 How I Use Amp。

如果你是团队用户，可以使用 Amp 的 线程共享功能 互相学习。

AGENT.md

项目根目录下的 AGENT.md 文件能告诉 Amp 项目的代码结构、开发流程和编码规范。如果没有文件，Amp 会主动帮你生成一个。

计划支持：支持子目录中的 AGENT.md 文件，以及更细粒度的 agent 指导。

上传图片

Amp 支持上传图片，便于你与 AI 分享截图、图表和视觉参考。这对调试 UI 问题或理解界面布局非常有帮助。

上传方式如下：

  • 复制并粘贴到输入框中
  • 拖动文件到输入框时按住 Shift 键

引用文件

你可以在 Prompt 中直接通过输入 @ 来模糊搜索并引用文件，这样可以避免模型搜索整个代码库，提高响应速度。

快捷键

Amp 根据操作系统和编辑器不同使用不同快捷键。

操作系统：macOS、Windows、Linux 编辑器：VS Code、Cursor、Windsurf

命令 快捷键
新建线程 Ctrl + L
切换 Agent 可见性 Ctrl + I
前往下一个线程 Ctrl + Shift + ]
返回上一个线程 Ctrl + Shift + [

线程（Threads）

线程是你与 agent 的对话，包含消息、上下文和工具调用。你的线程会同步到 ampcode.com。如果你在团队中，线程默认共享给团队成员，就像 Git 分支一样。

在提交代码审核时附上 Amp 线程链接可以提供更多上下文信息。阅读和搜索团队线程也能帮助你了解项目动态和他人的使用方式。

隐私与权限

线程的可见性有三种：公开（任何人可访问）、团队共享（团队成员可见）或私有（仅自己可见）。

  • 团队用户的线程默认共享给团队成员。
  • 非团队用户的线程默认是私有的。
  • 可随时通过线程顶部的分享菜单修改可见性。

上下文管理

随着你与 Amp 的对话推进，线程会积累上下文直到模型的 context window 达到上限。Amp 会提示你使用量，并在接近限制时发出警告。

你可以悬停在上下文指示器上，选择：

  • Compact Thread（压缩线程）：总结当前对话，减少上下文使用量
  • New Thread with Summary（新线程 + 总结）：以总结开头的新线程，继续对话

文件更改追踪

Amp 会追踪 agent 修改过的文件，便于你查看和撤销更改：

  • 悬停在输入框上方的文件变动指示器，查看被修改的文件及其变动程度
  • 可撤销单个文件或全部文件的修改

如果你编辑了某条消息，Amp 会自动撤销该消息之后 agent 所做的改动。

Amp Tab

Amp Tab 是一款嵌入式代码补全引擎，能够预测你的下一个操作，减少手动编写代码的时间。

它使用一个专门训练的模型，基于你最近的更改、语言服务器的诊断信息，以及语义上下文预测你接下来要做的事。

Amp Tab 可在光标附近或文档其他地方提供单行或多行代码编辑建议。

启用方式

在 VS Code 设置中添加以下内容：

  1. {
  2.     "amp.tab.enabled": true
  3. }

使用方式

  • 在编辑器中开始输入，Amp Tab 会自动给出相关建议。
  • 按 Tab 键接受并应用建议。
  • 再次按 Tab 可以跳转到更远的建议位置。
  • 如果不想采用建议，继续输入或按 Esc 键。

Amp Tab 当前作为研究预览向所有用户免费开放。

团队（Teams）

团队提供协作工作空间，方便组织内部共享知识。可在 设置页面 创建团队。加入团队需要现有成员的邀请。

共享

团队线程默认对所有成员可见，方便互相学习与协作。

用量管理

团队可以集中结算用量，方便组织内部成本管理。团队成员会优先使用个人账户中的免费额度，之后才会使用团队付费额度。

排行榜

每个团队有一个排行榜，展示成员在线程中的活跃度和贡献情况，鼓励参与和协作。

工具（Tools）

工具是模型用来辅助完成任务的手段。建议使用一组精选工具，并根据模型特点调整 Prompt 以获得最佳效果。

内置工具

Amp 提供了一组专为编程设计的内置工具，具体可在 Amp 扩展设置中查看。

自定义工具（MCP）

你可以通过 MCP (Model Context Protocol) 服务器为 Amp 添加自定义工具。

在配置文件中添加 amp.mcpServers 即可配置 MCP 服务器。VS Code 中也可以通过设置面板添加 MCP Server。

使用建议：

  • 使用提供少量高质量工具的 MCP 服务
  • 禁用不使用的 MCP 工具，可在设置中点击工具名，或将其加入配置文件中的 amp.tools.disable

MCP 服务器配置示例

本地 Stdio MCP 服务器：

  1. "amp.mcpServers": {
  2.     "playwright": {
  3.         "command": "npx",
  4.         "args": ["-y", "@playwright/mcp@latest", "--headless", "--isolated"]
  5.     },
  6.     "postgres": {
  7.         "command": "npx",
  8.         "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/amp"],
  9.         "env": {
  10.             "PGDATABASE": "mydb"
  11.         }
  12.     }
  13. }

远程 HTTPS/SSE MCP 服务器：

  1. "amp.mcpServers": {
  2.     "semgrep": {
  3.         "url": "https://mcp.semgrep.ai/sse"
  4.     }
  5. }

JetBrains 支持

你可以通过 MCP 将 Amp CLI 或 VS Code 扩展连接到 JetBrains IDE，从而获取 JetBrains 的诊断信息，帮助 Amp 更好地处理编译错误等。

使用步骤：

  1. 安装 JetBrains MCP Server 插件，并启动 IDE
  2. 将 npx -y @jetbrains/mcp-proxy 添加为 MCP 服务器
  1. "amp.mcpServers": {
  2.     "jetbrains": {
  3.         "command": "npx",
  4.         "args": ["-y", "@jetbrains/mcp-proxy"]
  5.     }
  6. }

命令白名单

Amp 内置了一个安全系统，用于控制终端命令的执行权限。

默认允许一些只读和安全命令（如 ls、cat、git status）直接运行。常见的构建命令如 go test、cargo build、pnpm run build 也在预批准列表中。其他命令需手动授权。

你可以将特定命令加入 "amp.commands.allowlist" 来免除授权提示：

  1. "amp.commands.allowlist": [
  2.     "pnpm exec tsc --build",
  3.     "pnpm -C web check",
  4.     "pnpm -C server test"
  5. ]

支持通配符（如 npm run * --test）。

配置

Amp 可通过 VS Code 的 .vscode/settings.json 和 CLI 的配置文件进行设置，所有配置项以 amp. 开头。

CLI 配置文件路径

不同系统的 CLI 配置文件路径如下：

Windows: C:\Users\USERNAME\AppData\Roaming\amp\settings.json

macOS / Linux: ~/.config/amp/settings.json

公司网络代理配置

使用 CLI 时如需代理或自定义证书，可设置以下 Node.js 环境变量：

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

核心配置项

（略，已列在英文原文中，中文使用时直接查字段即可）

账户信息

安全性

详见 Amp 安全文档。

支持与社区

加入 Amp Discord 与开发团队及其他用户交流经验。

账单问题请联系：amp-billing-help@sourcegraph.com

价格说明

计费方式

注册后，大多数用户会获得 \$10 美元的免费额度。可按需购买更多额度，团队和个人都适用。未使用的额度在账户一年内无活动后过期。

费用依据 LLM 使用量和某些额外服务（如 Web 搜索）产生的成本直接计算，无加价。

企业版本

企业版比个人和团队版本贵 50%，包含 SSO（Okta、SAML 等）和文本输入零数据保留政策。更多详情见 安全文档。

开启企业版需一次性支付 \$1,000 美元，获得同等额度的使用权，并将团队升级至 Enterprise。

购买 \$5,000+ 可提供发票付款；购买 \$25,000+ 可享受批量折扣。联系 amp-devs@sourcegraph.com 了解详情。