agent-toolkit-for-aws: cho AI agent làm việc với AWS — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về aws/agent-toolkit-for-aws — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: agent-toolkit-for-aws: cho AI agent làm việc với AWS — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Agent Toolkit for AWS là bộ công cụ chính thức do AWS hỗ trợ, gồm plugin, skill, quy tắc và AWS MCP Server để AI coding agent làm việc với AWS đúng cách. Bạn dùng nó để nhờ agent chọn dịch vụ, viết CDK/CloudFormation, triển khai, xem chi phí hay tra tài liệu AWS. Với Claude Code, cài chỉ cần một lệnh /plugin install, khá dễ nếu bạn đã có tài khoản AWS.
Agent Toolkit for AWS là bộ công cụ chính thức do AWS hỗ trợ, giúp các AI coding agent (Claude Code, Codex, Cursor, Devin, Kiro, fx) xây dựng, triển khai và quản lý ứng dụng trên AWS. Bên trong có plugin, skill (gói hướng dẫn cho agent), file quy tắc và một AWS MCP Server để agent gọi thẳng vào AWS.
Vấn đề nó giải quyết khá quen thuộc. Bạn nhờ AI viết hạ tầng AWS, nhưng AI hay chọn sai dịch vụ, dùng cú pháp cũ hoặc làm theo tài liệu đã lỗi thời. Toolkit này đưa cho agent đúng kiến thức, đúng công cụ và có cả "hàng rào" kiểm soát quyền. Nên nó hợp với lập trình viên mới, chủ startup, nhóm kỹ thuật nhỏ, và cả người làm vận hành muốn nhờ AI hỗ trợ việc trên AWS.
Điểm đáng giá nhất là phần kiểm soát. Theo README, bạn có thể viết chính sách IAM chỉ áp dụng cho agent (ví dụ cho agent chỉ được đọc, dù tài khoản của bạn có quyền ghi), đồng thời theo dõi mọi yêu cầu qua CloudWatch và CloudTrail. Repo hiện có khoảng 3.478 sao và 457 fork, giấy phép Apache-2.0, và vẫn được cập nhật trong 3 tháng gần đây. Bạn có thể xem video ngắn bên dưới để thấy nó chạy thế nào.
aws/agent-toolkit-for-aws
Bộ plugin, skill và MCP server chính thức của AWS giúp AI coding agent như Claude Code, Codex, Cursor xây dựng và triển khai ứng dụng trên AWS.
I.Agent Toolkit for AWS làm được gì
Toolkit gồm bốn phần chính. Hiểu rõ từng phần sẽ giúp bạn biết mình cần cài cái nào.
A.Plugin: cài một lần, có đủ cả bộ
Plugin gộp cấu hình AWS MCP Server và các skill vào một lần cài. README liệt kê năm plugin:
- aws-corekỹ năng cốt lõi, gồm chọn dịch vụ, CDK/CloudFormation, serverless, container, lưu trữ, giám sát, chi phí (billing), dùng SDK và triển khai. README ghi rõ đây là chỗ "bắt đầu".
- aws-agentsxây AI agent trên AWS với Amazon Bedrock và AgentCore.
- aws-data-analyticsdata lake, phân tích và ETL với S3 Tables, AWS Glue, Athena.
- aws-agents-for-devsecopsđiều tra sự cố, review code, chạy UAT trước khi phát hành, quét lỗ hổng và chạy kiểm thử xâm nhập, dùng AWS DevOps Agent và AWS Security Agent.
- aws-startup-advisornhư có một kiến trúc sư giải pháp cho startup ngay trong trợ lý lập trình. Nó gợi ý kiến trúc nhỏ nhất hợp với giai đoạn, credit và đội ngũ của bạn. Nó cũng giúp chuyển từ Azure, Google Cloud, Heroku sang AWS, chuyển lời gọi mô hình sang Amazon Bedrock và trả lời câu hỏi về credit AWS Activate.
B.Skill: hướng dẫn nạp khi cần
Skill là các gói chỉ dẫn và tài liệu tham khảo cho từng tác vụ AWS cụ thể. Agent chỉ nạp phần liên quan đến việc đang làm, nên không bị nhồi quá nhiều thông tin. Mỗi skill là một thư mục có file SKILL.md, đôi khi kèm thư mục references/.
C.Rules: file quy tắc cho dự án
Đây là các file cấu hình mức dự án, dặn agent nên dùng AWS MCP Server, tìm skill có sẵn và tra tài liệu trước khi hành động. Bạn xem trong thư mục rules/ của repo.
D.AWS MCP Server: cổng để agent gọi AWS
Đây là server được AWS quản lý, theo README gồm:
- Truy cập API của hơn 300 dịch vụ AWS qua một endpoint đã xác thực.
- Chạy script Python trong môi trường cô lập (sandbox) cho các thao tác nhiều bước.
- Tìm và đọc tài liệu AWS mới nhất mà không cần xác thực.
- Kiểm soát cho doanh nghiệp: số liệu CloudWatch, khóa điều kiện IAM riêng cho agent, nhật ký CloudTrail.
README cũng nói bộ này là phiên bản kế nhiệm của các MCP server, skill, plugin trong AWS Labs. AWS Labs vẫn chạy và nhận đóng góp, nhưng AWS khuyên dùng Agent Toolkit.
II.Cần chuẩn bị gì
Tư liệu chỉ nêu những điều sau, nên mình không thêm gì ngoài đó:
- Một AI coding agent thuộc nhóm được hỗ trợ: Claude Code, Codex, Cursor, Devin, Kiro, fx. Agent khác vẫn dùng được nhưng phải tự cấu hình MCP Server.
- Tài khoản AWS có credentials cấu hình sẵn trên máy. Bạn cần nó để gọi API và chạy script. Riêng tìm tài liệu và khám phá skill thì không cần.
- uv nếu bạn đi theo đường Kiro, fx hoặc agent khác (lệnh
uvxnằm trong uv). - Node.js để chạy lệnh
npxkhi cài skill. README dùngnpxnhưng không ghi phiên bản cụ thể. - Với Devin: phải đăng nhập bằng
devin auth logintrước. - README không ghi yêu cầu về hệ điều hành, phiên bản Python hay phần cứng. Nếu cần biết thêm, xem user guide của AWS mà README dẫn tới.
Agent có thể gọi API AWS thật bằng credentials của bạn. Hãy bắt đầu với tài khoản thử nghiệm hoặc quyền chỉ đọc, và xem kỹ những gì agent định làm trước khi cho phép nó tạo hay xóa tài nguyên. Tài nguyên AWS tạo ra có thể phát sinh chi phí.
III.Cài đặt từng bước
Cách cài phụ thuộc vào agent bạn dùng. Mình hướng dẫn kỹ Claude Code (phổ biến nhất), rồi tóm tắt các agent khác.
- Chuẩn bịCó sẵn agent và tài khoản AWS đã cấu hình credentials trên máy
- Cập nhật marketplaceLàm mới danh sách plugin nếu Claude Code báo không tìm thấy
- Cài plugin aws-coreChạy một lệnh /plugin install trong Claude Code
- Cài thêm plugin khácChọn aws-agents, aws-data-analytics... tùy nhu cầu
- Hoặc cài cho agent khácDùng Codex, Cursor, Devin, Kiro, fx hoặc npx skills
A.Chuẩn bị Claude Code và tài khoản AWS
Bạn cần Claude Code đã chạy được và credentials AWS đã cài trên máy. Mọi lệnh bắt đầu bằng dấu / bên dưới gõ trong khung chat của Claude Code, không gõ vào terminal thường. Đây là chỗ người mới hay nhầm.
B.Cài plugin aws-core
Plugin nằm trên marketplace chính thức claude-plugins-official, và Claude Code đã thêm sẵn marketplace này. Bạn chỉ cần chạy:
/plugin install aws-core@claude-plugins-officialLệnh này cài plugin lõi, gồm cấu hình AWS MCP Server và các skill về CDK, serverless, container, chi phí, triển khai.
Nếu báo Plugin not found, làm mới danh sách rồi chạy lại lệnh trên:
/plugin marketplace update claude-plugins-officialC.Cài thêm plugin theo nhu cầu
Xây AI agent với Bedrock và AgentCore:
/plugin install aws-agents@claude-plugins-officialLàm data lake, phân tích, ETL:
/plugin install aws-data-analytics@claude-plugins-officialCho DevSecOps (điều tra sự cố, quét lỗ hổng, kiểm thử xâm nhập), README ghi cách cài từ kho của repo, rồi chạy bước setup:
/plugin marketplace add aws/agent-toolkit-for-aws
/plugin install aws-agents-for-devsecops
/reload-plugins
# Or from Claude's official marketplace:
/plugin install aws-agents-for-devsecops@claude-plugins-official
/reload-plugins
# Setup:
/aws-agents-for-devsecops:setupCho startup (kiến trúc, chi phí, di chuyển sang AWS), cài từ marketplace của chính repo:
/plugin marketplace add aws/agent-toolkit-for-aws
/plugin install aws-startup-advisor@agent-toolkit-for-aws
/reload-pluginsLệnh /reload-plugins giúp Claude Code nạp plugin mới mà không phải mở lại.
D.Cài cho các agent khác
AWS CLI: README cho phép dùng toolkit ngay từ terminal:
aws configure agent-toolkitChi tiết nằm trong hướng dẫn tích hợp AWS CLI trên trang tài liệu của AWS.
Codex: chạy trong terminal, rồi mở Codex, gõ /plugins để chọn cài aws-core:
codex plugin marketplace add aws/agent-toolkit-for-awsCursor: vào Settings → Plugins → Team Marketplaces → Add Marketplace → Import from Repo, nhập aws/agent-toolkit-for-aws. Sau đó mở bảng Plugins và cài aws-core.
Devin: cần đăng nhập devin auth login trước, rồi chạy:
devin plugins install aws/agent-toolkit-for-aws#plugins/aws-coreThêm --local nếu chỉ muốn cài trên máy này. Muốn plugin khác thì thay aws-core bằng tên plugin đó.
Kiro: gồm hai phần độc lập. Phần 1 là thêm AWS MCP Server vào file .kiro/settings/mcp.json:
{
"mcpServers": {
"aws": {
"command": "uvx",
"args": [
"mcp-proxy-for-aws-cli@latest",
"https://aws-mcp.us-east-1.api.aws/mcp",
"--metadata",
"AWS_REGION=us-west-2"
]
}
}
}Phần 2 là cài skill:
npx skills add aws/agent-toolkit-for-aws/skillsSkill được lưu vào ~/.kiro/skills/ (toàn máy) hoặc .kiro/skills/ (theo dự án). Hai phần này độc lập: skill không cần MCP Server, và MCP Server không cung cấp skill cài cục bộ.
fx: thêm MCP Server bằng một lệnh:
fx mcp add aws uvx mcp-proxy-for-aws-cli@latest https://aws-mcp.us-east-1.api.aws/mcp --metadata AWS_REGION=us-west-2Rồi cài skill (thêm -g nếu muốn cài toàn máy):
npx skills add aws/agent-toolkit-for-aws/skills -a fxNếu một phiên fx đang mở và bạn vừa sửa file cấu hình, gõ /mcp reload để nạp lại.
Agent khác: làm theo hướng dẫn "getting started" của AWS MCP Server trên trang tài liệu AWS, rồi cài skill bằng:
npx skills add aws/agent-toolkit-for-aws/skillsIV.Kiểm tra đã chạy được chưa
README không nêu một lệnh "kiểm tra" riêng, nên mình chỉ gợi ý cách kiểm tra dựa trên những gì nó mô tả:
- Claude Codesau khi cài và
/reload-plugins, plugin phải xuất hiện trong danh sách plugin của bạn. Lệnh/plugin installkhông báo lỗi là dấu hiệu tốt. - Codexgõ
/pluginsthấy aws-core trong danh sách để cài. - Cursorbảng Plugins hiển thị các plugin sau khi import repo.
- Kiro, fxthư mục skill (
.kiro/skills/hoặc.fx/skills/) có các thư mục skill. Với fx, gõ/skillshoặc$để xem danh sách. - Thử bằng một câu hỏihỏi agent một câu cần tài liệu AWS mới, ví dụ "Tìm trong tài liệu AWS cách dùng S3 Tables". Tra tài liệu không cần credentials nên đây là phép thử nhẹ nhất.
V.Dùng vào việc thật
README không đưa ra kịch bản mẫu, nên các tình huống dưới đây là cách mình áp dụng đúng phạm vi plugin mô tả. Câu lệnh là prompt gõ cho agent, không phải lệnh cố định của repo.
A.Chủ startup cần dựng hệ thống đầu tiên
Bạn là founder nhỏ, có đội 2 dev, chưa rõ nên dùng dịch vụ AWS nào. Cài aws-startup-advisor, rồi nhờ agent:
Mình có 2 dev, chạy một web app và một API. Hãy đề xuất kiến trúc AWS nhỏ nhất, rẻ nhất hợp với giai đoạn này, rồi giải thích vì sao chọn từng dịch vụ.Theo mô tả của plugin, nó đề xuất kiến trúc gọn theo giai đoạn, credit và đội ngũ của bạn, rồi có thể dựng khung sẵn cho bạn. Bạn cũng có thể hỏi về điều kiện nhận credit AWS Activate.
Việc khó nhất với AWS không phải gõ lệnh, mà là biết nên dùng dịch vụ nào. Để agent có kiến thức đúng thì nó chọn đỡ sai hơn nhiều.
Ông T
B.Lập trình viên triển khai ứng dụng serverless
Bạn đã viết xong một hàm xử lý đơn hàng và muốn đưa lên AWS. Với aws-core (CDK/CloudFormation, serverless, triển khai), nhờ agent:
Viết hạ tầng CDK cho một API serverless nhận đơn hàng và lưu vào cơ sở dữ liệu. Giải thích từng tài nguyên trước khi triển khai.Agent nạp skill liên quan, tra tài liệu hiện hành qua MCP Server, rồi viết mã hạ tầng. Bạn đọc kỹ rồi mới đồng ý cho nó triển khai.
C.Nhân viên vận hành xem chi phí và giám sát
Cuối tháng bạn muốn hiểu vì sao hóa đơn AWS tăng. Plugin aws-core có skill về billing và observability. Nhờ agent:
Giúp mình xem các nhóm chi phí AWS đang tăng và gợi ý chỗ nên kiểm tra trước. Chỉ đọc, không thay đổi gì.Nếu quản trị viên dùng khóa điều kiện IAM dành cho agent, họ có thể giới hạn agent ở quyền chỉ đọc. Khi đó dù bạn lỡ nhờ nó thay đổi gì, nó cũng không làm được.
D.Nhóm kỹ thuật điều tra sự cố và quét bảo mật
Hệ thống chậm bất thường vào tối thứ Sáu, hoặc bạn cần rà code trước khi phát hành. Cài aws-agents-for-devsecops, chạy /aws-agents-for-devsecops:setup, rồi nhờ điều tra sự cố, review code, chạy UAT hoặc quét lỗ hổng. Plugin này dựa trên AWS DevOps Agent và AWS Security Agent, nên bạn nên đọc tài liệu của hai dịch vụ đó để biết điều kiện sử dụng. README không nói rõ chi phí.
VI.Lỗi hay gặp và cách xử lý
A.Báo "Plugin not found" khi cài trong Claude Code
Đây là lỗi chính README đã lường trước. Chạy /plugin marketplace update claude-plugins-official để làm mới danh sách, rồi cài lại. Với plugin cài từ kho của repo, nhớ chạy /plugin marketplace add aws/agent-toolkit-for-aws trước.
B.Gõ lệnh /plugin vào terminal thường
Các lệnh bắt đầu bằng / là lệnh của Claude Code, không phải lệnh hệ điều hành. Hãy mở Claude Code rồi gõ vào khung chat. Ngược lại, các lệnh như npx, codex, devin, fx thì gõ trong terminal.
C.Agent không gọi được API AWS
Thường do credentials AWS chưa cấu hình trên máy. README nói rõ cần tài khoản AWS có credentials cục bộ để gọi API và chạy script. Hãy kiểm tra lại cấu hình credentials, và xem user guide của AWS nếu vẫn lỗi.
D.Kiro hoặc fx không chạy được uvx
Cả hai cách cài MCP Server ở trên đều dùng uvx. README yêu cầu cài uv trước. Cài uv theo hướng dẫn trên trang chính thức của nó, mở lại terminal rồi thử lại.
E.Sửa file cấu hình nhưng agent chưa nhận
Với fx, nếu phiên đang mở khi bạn sửa ~/.fx/mcp.json, gõ /mcp reload. Với Claude Code, dùng /reload-plugins. Chưa được thì thử đóng và mở lại agent.
VII.Có nên dùng không
Điểm mạnh. Đây là bộ công cụ chính thức do AWS hỗ trợ, nên kiến thức theo sát tài liệu hiện hành. Phần kiểm soát khá tốt: khóa điều kiện IAM riêng cho agent, CloudWatch và CloudTrail giúp theo dõi từng yêu cầu. Cài đặt trên Claude Code, Codex, Cursor, Devin chỉ vài thao tác. Có thể bắt đầu từ aws-core, sau đó thêm plugin khác khi cần. Giấy phép Apache-2.0.
Giới hạn. Bạn vẫn cần tài khoản AWS và hiểu ít nhiều về quyền truy cập, chi phí. Plugin chỉ có cho Claude Code, Codex, Cursor và Devin. Agent khác phải tự cấu hình MCP Server và cài skill riêng. README không nêu yêu cầu hệ điều hành hay phiên bản phần mềm cụ thể, và không giải thích chi phí của các dịch vụ đi kèm như AWS DevOps Agent hay AWS Security Agent.
Khi nên chọn cách khác. Nếu bạn chưa dùng AWS và không định dùng, repo này không có ích. Nếu bạn đã dùng các MCP server trong AWS Labs và chạy ổn, chúng vẫn hoạt động, nhưng AWS khuyên chuyển dần sang Agent Toolkit. Nếu chỉ cần tra tài liệu AWS thôi, bạn không cần tài khoản AWS cho phần này, nên có thể thử trước rồi mới quyết định cài thêm.
Câu hỏi thường gặp
Agent Toolkit for AWS có miễn phí không?
Bản thân repo có giấy phép Apache-2.0 và bạn tải về dùng được. Tuy nhiên README không nói về chi phí của các dịch vụ AWS mà agent gọi tới. Tài nguyên bạn tạo trên AWS có thể tính phí, nên hãy xem bảng giá của từng dịch vụ.
Dùng được với những AI agent nào?
README nêu Claude Code, Codex, Cursor, Devin, Kiro và fx. Plugin hiện có cho Claude Code, Codex, Cursor và Devin. Với agent khác, bạn cấu hình AWS MCP Server rồi cài skill bằng npx.
Cần tài khoản AWS không?
Cần nếu bạn muốn agent gọi API AWS hoặc chạy script, và credentials phải được cấu hình trên máy. Riêng việc tra tài liệu AWS và tìm skill thì không cần tài khoản.
Có cần GPU hay máy cấu hình mạnh không?
README không nêu yêu cầu phần cứng. Toolkit làm việc qua agent và MCP Server do AWS quản lý, nên chưa có thông tin nào cho thấy cần GPU.
Chạy trên Windows được không?
README không ghi yêu cầu hệ điều hành. Các lệnh cài đặt là lệnh của agent, npx, uvx nên phụ thuộc vào việc agent và các công cụ đó chạy trên máy bạn. Bạn nên xem user guide của AWS để chắc chắn.
Làm sao giới hạn để agent không làm bậy trên tài khoản AWS?
README nói AWS MCP Server hỗ trợ khóa điều kiện IAM phân biệt hành động của agent với của con người. Nhờ đó có thể viết chính sách chỉ cho agent đọc dù vai trò IAM của bạn có quyền ghi. CloudWatch và CloudTrail ghi lại mọi yêu cầu để bạn theo dõi.
Khác gì các MCP server trong AWS Labs?
README nói Agent Toolkit là bộ kế nhiệm và được AWS khuyên dùng. Nó có khóa điều kiện IAM cho agent, CloudWatch và CloudTrail cho mọi yêu cầu, cùng các skill đã qua đánh giá toàn trình. Công cụ AWS Labs vẫn chạy và nhận đóng góp.


