agent-toolkit-for-aws 登录鉴权：配置 AWS 凭证并验证
Agent Toolkit for AWS 是 AWS 提供的 AI 编程代理工具包，可让 Claude Code、Codex、Cursor 等工具调用 AWS 资源管理能力。本文按“安装工具包—建立 AWS 会话—绑定项目配置—验证权限”的路径，完成登录鉴权。截至 2026-10-06，AWS Builder Center 已把“使用 AI 工具中的 AWS 凭证”纳入新注册体验，当前 AWS CLI 集成入口是 aws configure agent-toolkit，下面按这个入口给出可执行步骤。
先准备 AWS 账号和 CLI
这里的鉴权，指的是让 AI 编程工具使用你的 AWS 身份访问云资源，而不是把 AWS Access Key 直接粘贴到聊天窗口。AWS Builder Center 的说明明确建议使用项目提供的浏览器登录流程和临时凭证，不要把访问密钥交给代理。
先准备三项条件：
- 准备 AWS 账号或项目访问权限，并确认你能在 AWS 控制台看到目标项目、账号和区域。登录页面要求选择 AWS 会话时，选择与目标项目对应的会话。
- 安装 AWS CLI，并在终端运行
aws --version，确认命令可用。 - 准备 Claude Code、Codex 或 Cursor 中的一种。项目提供的说明覆盖 Claude Code、Codex、Cursor、Devin、Kiro 和 fx，但不同代理的安装入口不同。
如果你的电脑还没有 AWS CLI，先从 AWS CLI 官方文档安装；安装完成后回到终端确认版本。不要先配置一套长期 Access Key，再试图让工具使用浏览器登录，因为这样容易把“工具能否连接 AWS”和“代理是否拥有资源权限”混成一件事。
用 AWS CLI 初始化 Agent Toolkit
打开终端，执行官方 README 给出的命令：
aws configure agent-toolkit这个命令会启动 Agent Toolkit 的配置流程。随后按照终端提示选择或确认 AWS 登录会话，并输入项目配置文件的名称。建议使用能直接说明用途的名字，例如：
contact-form-dev这里的“配置文件”可以理解为 AWS CLI 用来区分不同项目认证信息的一组命名配置。不同项目使用不同的配置文件，代理才能知道本次部署应操作哪个 AWS 项目。
配置完成后，重新启动你的 AI 编程工具。这一步不能省略：部分工具只在启动时读取初始化结果。继续使用旧会话时，终端看起来已经配置成功，代理却可能仍找不到新配置。
Claude Code、Codex 和 Cursor 的安装位置
Claude Code
Agent Toolkit for AWS 的插件可以通过 Anthropic 官方插件市场安装。AWS 仓库 README 给出的 aws-core 安装命令如下：
/plugin install aws-core@claude-plugins-officialaws-core 覆盖 AWS 服务选择、CDK/CloudFormation、Serverless、容器、存储、可观测性、计费、SDK 使用和部署等能力。若安装时出现：
Plugin not found先更新本地市场索引：
/plugin marketplace update claude-plugins-official然后重新执行安装命令。
需要 AWS 代理和 Amazon Bedrock、AgentCore 能力时，README 提供的命令是：
/plugin install aws-agents@claude-plugins-official安装完成后，在 Claude Code 中执行：
/reload-plugins这两个动作不是同一件事：安装负责把插件加入环境，/reload-plugins 负责让当前会话重新加载插件。只安装、不重新加载，常会出现插件已安装但当前对话找不到对应能力的情况。
Codex
在终端执行：
codex plugin marketplace add aws/agent-toolkit-for-aws然后启动 Codex，在 Codex 内运行：
/plugins在插件列表中浏览并安装 aws-core。这里的顺序是“先添加 marketplace，再用插件浏览器安装”，不能只添加仓库地址后直接期待 aws-core 自动出现。
Cursor
在 Cursor 中进入：
Settings → Plugins → Team Marketplaces → Add Marketplace → Import from Repo在导入仓库的位置填入：
aws/agent-toolkit-for-awsCursor 会根据仓库中的 .cursor-plugin/marketplace.json 索引插件。导入后再打开 Plugins 页面，选择需要的插件。
这三条路径解决的是“把工具包放进代理”，并不等于 AWS 登录已经完成。下一步仍要在项目会话中建立 AWS 凭证关联。
让代理使用项目对应的 AWS 会话
AWS 文档给出的多项目用法是为不同项目建立不同配置文件，然后用 --profile 登录对应项目。例如：
aws login --profile MyFirstProjectProfile如果另一个项目叫 Bookstore，对应配置文件是 BookstoreProfile：
aws login --profile BookstoreProfile执行这些命令时，会话选择页面必须选择 AWS 凭证对应的 AWS 会话。文档的关键要求是：选择与项目相匹配的会话，不能在 MyFirstProject 的操作中误选 Bookstore 会话。
在 AI 编码工具里，首次配置时，AWS Builder Center 建议进入 AWS Settings 中的项目，选择“Create and manage cloud infrastructure”，再选择“Use your AWS credentials with AI coding tools”。复制页面提供的 agent prompt，粘贴到代理中并按提示完成设置。
这一步是代理与 AWS 项目之间的连接环节。若你是在已有项目中工作，至少要让代理确认它使用的配置名称与项目一致。配置文件名称可以自行命名，但后续所有登录命令必须使用完全相同的名称。
验证鉴权是否真正生效
不要只看命令有没有返回成功。让代理执行下面这句提示：
Use Agent Toolkit for AWS to inspect my connection. Report the active account, Region, and profile without printing credentials.成功时，应能明确报告以下信息：
- 当前 AWS 账号；
- 当前 Region（区域）；
- 当前 AWS profile（配置文件）；
- Agent Toolkit 已连接或可正常调用。
报告中不应出现 Access Key、Secret Key 或 session token。AWS Builder Center 的验证建议还包括：部署前先确认项目、账号、区域和凭证配置，避免代理在错误账号中创建资源。
如果代理能报告账号、区域和 profile，但部署仍返回权限不足，问题通常不在登录流程，而在 IAM 权限：登录证明“你是谁”，IAM 决定“允许你做什么”。此时应回到项目的 AWS 权限配置，确认代理使用的身份拥有目标资源所需的操作权限，再重新验证。
最容易卡住的三个位置
插件找不到。 Claude Code 报出 Plugin not found 时，执行 /plugin marketplace update claude-plugins-official，再重新安装目标插件。Codex 则确认已经运行过 codex plugin marketplace add aws/agent-toolkit-for-aws，随后在 /plugins 中安装。
代理读不到新配置。 aws configure agent-toolkit 完成后，重启代理。没有重启时，代理可能仍使用启动时读取的旧会话。
账号或项目选错。 使用 aws login --profile MyFirstProjectProfile 这类命令后，在会话选择页选择对应项目；项目名称和 profile 不是一回事。验证时让代理报告账号、区域和 profile，若结果与目标项目不一致，先切换正确会话，不要直接部署。
参考资料
- AWS Agent Toolkit for AWS 官方仓库：查看 AWS CLI、Claude Code、Codex 和 Cursor 的官方安装命令。
- AWS Builder Center：AWS Lambda for beginners：查看项目凭证配置、代理 prompt 和连接验证方式。
- AWS 账户管理参考文档：查看多项目 profile 与
aws login --profile的对应关系。 - GitHub 文档：了解 GitHub 仓库、插件市场及仓库导入相关背景。
参考来源
评论区
登录后可评论。