Postman Plugin for Claude Code và Apidog CLI: Agent của bạn nên dùng công cụ nào?

Plugin Postman cho Claude Code so với Apidog CLI: thiết lập, những gì agent của bạn có thể làm, đo lường của token claims và giá cả — so sánh dựa trên tài liệu chính thức từ mỗi nhà cung cấp.

Ashley Innocent

Ashley Innocent

16 tháng 11 2026

Postman Plugin for Claude Code và Apidog CLI: Agent của bạn nên dùng công cụ nào?

Apidog cho doanh nghiệp

Triển khai tại chỗ

SSO & RBAC

Tuân thủ SOC 2

Khám phá Apidog Enterprise

Plugin Postman cho Claude Code và Apidog CLI giải quyết cùng một vấn đề: chúng cung cấp cho agent lập trình của bạn bộ công cụ API thực sự để nó không còn phải đoán endpoint. Chọn plugin Postman nếu đội của bạn đã làm việc trong các Postman workspace và muốn Context Graph hoặc Secret Scanner tham gia vào quy trình. Chọn Apidog CLI nếu bạn muốn một CLI sẵn sàng cho agent hoạt động trên nhiều agent, xác thực mọi thao tác ghi trước khi gửi lên server, và gói miễn phí cho đội tối đa 4 người.

Plugin Postman cho Claude Code là gì?

Plugin Postman cho Claude Code là một tập hợp các skill giúp Claude Code chạy Postman CLI thực sự ở từng giai đoạn của công việc API: khám phá, thiết kế, mock, kiểm thử, tài liệu và kiểm soát. Nó được phân phối qua marketplace plugin chính thức của Anthropic, và skill api-engineer sẽ điều hướng mỗi yêu cầu đến một skill chuyên biệt.

Theo hướng dẫn thực hành của Postman, đăng ngày 9 tháng 11 năm 2026, bạn cài đặt nó bằng hai lệnh:

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install postman@claude-plugins-official

Skill bootstrap sẽ cài đặt Postman CLI lần đầu tiên khi Claude cần. Bạn cần Claude Code, Node.js 18 trở lên và một tài khoản Postman; hướng dẫn cho biết gói miễn phí là đủ dùng, và các lệnh cục bộ như lint, mock hay chạy collection không cần đăng nhập.

Danh sách skill khá đa dạng:

Skill Chức năng
bootstrap Tìm CLI, xác thực, liên kết repo với workspace
api-discovery Tìm kiếm workspace, khám phá API công khai qua Orbit, truy vấn Context Graph
api-mocking Tạo và chạy mock từ spec hoặc collection
api-testing Chạy request và collection với các assertion pm.test
api-documentation Tạo tài liệu thân thiện với agent
ai-readiness Chấm điểm mức độ thân thiện của spec với agent
ci-integration Thêm các cổng lint, test và readiness vào CI

Một hook SessionStart nhắc Claude ngay từ mỗi lần khởi động, ngắn gọn và rõ ràng, để đưa công việc API qua api-engineer, giúp agent không quên bộ công cụ giữa phiên làm việc.

Plugin Postman điều hướng công việc của agent như thế nào

Plugin ưu tiên CLI cục bộ. Bài hướng dẫn xử lý credential bị rò rỉ của Postman (ngày 10 tháng 11 năm 2026) nêu rõ: plugin gửi request đến Postman CLI bất cứ khi nào CLI có thể hoàn thành, và chỉ chuyển sang Postman MCP Server hosted tại mcp.postman.com cho những tác vụ CLI không hỗ trợ. Ở các phiên bản được kiểm thử, đó là Secret Scanner, audit log và quyền của collection.

Diagram of how the Postman plugin for Claude Code routes work: Claude Code calls the plugin's api-engineer skill, which sends tasks to the local Postman CLI first and falls back to the Postman MCP Server, both acting on the Postman workspace

Ba ví dụ từ các bài viết của Postman:

  1. Ứng phó sự cố mà không cần mở ứng dụng. Agent đã định vị một bearer token bị rò rỉ, tìm thấy 32 nơi sử dụng downstream nhờ Context Graph, chuyển token vào vault secret, chạy lại collection và chỉ đóng các phát hiện sau khi con người xác nhận đã thu hồi. Tác giả phát hành token mới từ phía dịch vụ.
  2. Chia sẻ mô phỏng giữa các phiên agent. Bài viết về mô phỏng (ngày 12 tháng 11 năm 2026) đã chạy hai phiên Claude Code trên cùng một workspace. Agent A công bố bốn mô phỏng, bao gồm trường hợp thanh toán bị từ chối 402 và timeout thanh toán 8 giây. Agent B kéo chúng về bằng postman simulation list và postman simulation run <simulation-id> --port 4000, và trường hợp timeout đã bộc lộ một lỗi thực sự: timeout 3 giây phía client của checkout kích hoạt trước, khiến trạng thái giao dịch không rõ ràng.
  3. Context Graph cho các câu hỏi về tác động. postman context-graph ask "..." --wait trả lời câu hỏi “điều gì có thể hỏng nếu chúng ta thay đổi API này?” dựa trên bản đồ được tạo từ dữ liệu Postman, GitHub và New Relic.

Postman nêu rõ những điều kiện kèm theo. Secret Scanner và audit log cần gói Enterprise, và quét các workspace nội bộ cũng cần add-on Advanced Security Administration. Mock không tự tải lại khi thay đổi. Một số lệnh CLI gửi kết quả chạy và dữ liệu phân tích về Postman theo mặc định; hướng dẫn chỉ đến --no-report-events để từ chối.

Apidog CLI cho agent lập trình là gì?

Apidog CLI là công cụ dòng lệnh cho phép bất kỳ agent lập trình nào thiết kế, mock, kiểm thử và viết tài liệu API trong một dự án Apidog. Nó không gắn với một agent cụ thể: bạn cài một lần, thêm skill Apidog vào agent bạn đang dùng (Claude Code, Codex, Cursor và các agent khác), và agent sẽ điều khiển cùng các lệnh apidog.

Phiên bản 2.2.12 bao phủ endpoint, schema, mock, môi trường, test case, scenario, suite, import, export, trang tài liệu và branch. Hai thiết kế khiến nó thân thiện với agent:

Apidog phát hành tính năng này sau khi xây dựng một MCP server trước đó. Đội ngũ đã giải thích lý do trong bài We Built 126 MCP Tools, và so sánh nội bộ giữa MCP với CLI kết hợp skill cho thấy khoảng giảm 30% lượt gọi công cụ và 25% token trên các tác vụ thông thường.

Plugin Postman vs Apidog CLI: so sánh trực tiếp

Dưới đây là cách hai công cụ so sánh ở những điểm agent của bạn chạm tới, dựa trên các bài viết của Postman và apidog --help tính đến ngày 16 tháng 11 năm 2026:

Plugin Postman cho Claude Code Apidog CLI + skill
Cài đặt 2 lệnh claude plugin; CLI tự cài npm install -g apidog-cli@latest + cài skill
Agent Claude Code (plugin marketplace) Bất kỳ agent nào chạy được lệnh shell
Đường thực thi Postman CLI trước, MCP Server hosted làm phương án dự phòng Chỉ dùng CLI
An toàn payload Các skill hướng dẫn agent Cổng cli-schema validate trước mọi lần ghi JSON
Mocking postman mock generate/run, mô phỏng dùng chung Các expectation của apidog mock trong dự án
Kiểm thử Collection với pm.test, collection run Test case, scenario, suite qua apidog run
Phân tích tác động Truy vấn Context Graph Không phải tính năng tích hợp sẵn
Quy trình bảo mật Secret Scanner, vault (Enterprise cho scanner và audit log) CLI không bao phủ
Thanh chắn an toàn cho agent Hướng dẫn khuyến cáo agent không bao giờ chạy workspace push AI branch với merge được con người duyệt
Gói miễn phí Gói Free chỉ dành cho cá nhân Gói Free hỗ trợ tối đa 4 người dùng

Postman đi sâu hơn về ánh xạ phụ thuộc và ứng phó sự cố. Apidog rộng hơn về hỗ trợ agent và chặn mọi thao tác ghi bằng xác thực.

Cái nào tiết kiệm token hơn?

Chưa ai công bố kết quả đối đầu trực tiếp, và mỗi con số nổi bật đo lường một điều khác nhau.

Benchmark Context Graph của Postman (ngày 4 tháng 11 năm 2026) báo cáo giảm 43% token đầu vào và 42% thời gian xử lý. Mô hình là GPT 6.1 Terra, không phải Claude Code, trên 17 câu hỏi về một tổ chức GitHub gồm 802 repository. Mỗi phép so sánh chỉ chạy một lần, chi phí truy vấn graph bị loại trừ, và thời gian end-to-end bao gồm thời gian chờ graph cải thiện 26%. Nó đo lường Context Graph trên tác vụ tìm kiếm mã nguồn, không phải plugin trong công việc API hằng ngày.

Số liệu của Apidog so sánh MCP server riêng của nó với CLI kết hợp skill trên các tác vụ như thêm một test case. Đó là lựa chọn kiến trúc trong nội bộ một sản phẩm, không phải Apidog so với Postman.

Cả hai nhà cung cấp đều chuyển từ “nạp mọi công cụ vào ngữ cảnh” sang một CLI mà agent gọi khi cần, và chính mô hình này mới là thứ tiết kiệm token. Hãy chạy cả hai trên API của bạn với một prompt cố định và so sánh số token của mỗi phiên.

Giá cả: mỗi công cụ tốn bao nhiêu cho đội của bạn

Giá cả, kiểm tra ngày 16 tháng 11 năm 2026:

Với đội hai đến bốn lập trình viên chia sẻ cùng một dự án API trên gói miễn phí, sự khác biệt này quyết định lựa chọn. Với doanh nghiệp đã dùng Postman Enterprise, plugin bổ sung quyền truy cập agent vào các công cụ bạn đã trả tiền.

Để Claude Code điều khiển Apidog CLI

Đừng tự tay xây test case trong khi agent ngồi không ở pane bên cạnh. Cài CLI một lần và đưa cho nó một prompt.

Diagram of the Apidog CLI agent loop: an agent prompt loads the Apidog skill, the agent validates its payload with apidog cli-schema validate, creates the case with apidog test-case create, runs it with apidog run, and agentHints in the output suggest the next step

Cài đặt chỉ cần ba lệnh:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick Claude Code when prompted

apidog skill install cũng cài đặt hoặc cập nhật skill. Hoặc bảo agent của bạn đọc hướng dẫn cài đặt và tự thiết lập.

Sau đó đưa cho Claude Code một prompt, dùng cùng Orders API như hướng dẫn của Postman để bạn có thể chạy cả hai công cụ trên một spec:

Import ./openapi.yaml into Apidog project <projectId>. Then create a test case
for POST /orders that asserts a 201 status and an "id" field in the response,
run it against environment <envId>, and summarize any failures.

Agent đọc skill, rồi chạy các lệnh như sau:

apidog import --project <projectId> --format openapi --file ./openapi.yaml
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

Payload sai sẽ bị chặn ngay tại cli-schema validate. Thêm --upload-report và kết quả chạy sẽ xuất hiện trong ứng dụng Apidog cho cả đội. Cùng lệnh apidog run với -r junit có thể đưa vào pipeline; xem Apidog CLI trong CI/CD và hướng dẫn thiết lập Claude Code đầy đủ.

Agent của bạn nên dùng cái nào?

Chọn plugin Postman cho Claude Code nếu:

Chọn Apidog CLI nếu:

Riêng về CI runner, xem Apidog CLI vs Postman CLI và đánh giá Postman Claude Skills của chúng tôi.

Câu hỏi thường gặp

Plugin Postman cho Claude Code có miễn phí không? Plugin được cài từ marketplace chính thức của Anthropic, và hướng dẫn của Postman cho biết gói miễn phí đủ dùng cho quy trình cốt lõi. Secret Scanner và audit log cần Enterprise, và truy vấn Context Graph vượt quá 1.000 lần mỗi tháng ở gói Free tốn $0,01 mỗi truy vấn.

Plugin Postman dùng MCP hay CLI? Cả hai. Nó điều hướng công việc đến Postman CLI bất cứ khi nào CLI có thể hoàn thành, và chuyển sang Postman MCP Server hosted cho các tác vụ CLI không bao phủ, như Secret Scanner và audit log.

Apidog CLI có hoạt động với Claude Code không? Có. Cài CLI, thêm skill Apidog bằng npx -y skills add https://apidog.com hoặc apidog skill install, và Claude Code sẽ chạy các lệnh apidog theo prompt của bạn. Cách thiết lập tương tự hoạt động trong Codex, Cursor và các agent khác.

Có thể chuyển Postman collection sang Apidog bằng CLI không? Có. apidog import --project <projectId> --format postman --file <path> nhập một Postman collection đã xuất vào dự án Apidog.

Con số tiết kiệm 43% token có phải nói về plugin Claude Code không? Không. Con số 43% của Postman đến từ một benchmark Context Graph chạy với GPT 6.1 Terra trên 17 câu hỏi tìm kiếm mã nguồn, mỗi câu chỉ chạy một lần. Nó không đo lường plugin Claude Code trên các tác vụ API hằng ngày.

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API