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.

Ba ví dụ từ các bài viết của Postman:
- Ứ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ụ.
- 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 listvà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. - Context Graph cho các câu hỏi về tác động.
postman context-graph ask "..." --waittrả 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:
- Xác thực trước khi ghi. Mỗi lệnh nhận JSON đều yêu cầu agent chạy
apidog cli-schema get <key>để biết cấu trúc payload vàapidog cli-schema validate <key> --file <path>trước khi ghi. Payload sai sẽ bị chặn ngay tại máy thay vì gây lỗi server và phải thử lại. - AI branch.
apidog branch create --type ai --from <sourceBranchName>cấp cho agent một branch riêng. Phần trợ giúp cho biết các thay đổi trên AI branch không được ghi回 tự động; agent sẽ hỏi bạn trước khi merge.
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:
- Postman. Theo trang định giá Postman, Free và Solo là các gói dành cho cá nhân. Solo giá $9 mỗi tháng tính theo năm, Team là $19 mỗi người dùng mỗi tháng tính theo năm ($23 nếu tính theo tháng), và Enterprise cần liên hệ bán hàng. Truy vấn Context Graph bao gồm 1.000 lần mỗi tháng ở gói Free và 5.000 ở các gói trả phí, sau đó $0,01 mỗi truy vấn. Quy trình Secret Scanner của plugin cần gói Enterprise.
- Apidog. Gói Free hỗ trợ tối đa 4 người dùng.
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.

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:
- API, collection và spec của bạn đã nằm trong các Postman workspace.
- Bạn muốn truy vấn tác động bằng Context Graph trước khi thay đổi một API dùng chung.
- Bạn đang dùng Enterprise và muốn Secret Scanner cùng audit log nằm trong vòng làm việc của agent.
Chọn Apidog CLI nếu:
- Đội của bạn dùng nhiều hơn một agent lập trình, hoặc có thể đổi agent.
- Bạn muốn mọi thao tác ghi của agent được xác thực tại máy trước khi đến server.
- Bạn muốn các chỉnh sửa của agent được cô lập trên AI branch cho đến khi con người merge.
- Đội của bạn có hai đến bốn người và cần dự án dùng chung trên gói miễn phí.
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.
