Hiểu agent.
Giao việc tốt hơn.

Agent (tác tử) là chương trình dùng mô hình để chọn bước tiếp theo và gọi công cụ. Anh giao mục tiêu, dữ liệu được dùng và giới hạn hành động. Muốn biết việc đã xong, cần một kết quả có thể kiểm tra.

flowchart TD
 A["Anh Hiếu giao mục tiêu"] --> B["Agent lập bước làm"]
 B --> C["Công cụ đọc và kiểm tra ERP"]
 C --> B
 B --> D["Kết quả và bằng chứng"]

Workflow (luồng công việc) sắp sẵn thứ tự và điều kiện chuyển bước. Cách này hợp với quy trình có trách nhiệm và điểm duyệt rõ. Chỉ đặt bước AI ở nơi cần đọc hiểu hoặc đề xuất.

flowchart LR
 A["Tạo phiếu"] --> B["AI soạn câu hỏi"] --> C["Người có quyền duyệt"] --> D["ERP ghi nhận"]

Multi-agent (nhiều tác tử phối hợp) chia một mục tiêu thành các phần có đầu ra riêng. Người điều phối phải kiểm tra và ghép kết quả. Chia nhỏ chỉ có lợi khi chi phí phối hợp thấp hơn lợi ích thu được.

flowchart TD
 A["Điều phối"] --> B["Rà nghiệp vụ"]
 A --> C["Rà dữ liệu"]
 B --> D["Đối chiếu và tổng hợp"]
 C --> D

Sub-agent (tác tử phụ) nhận một nhiệm vụ hẹp và làm trong ngữ cảnh riêng. Báo cáo ngắn gửi về giúp phiên chính bớt ngập kết quả tìm kiếm. Mỗi tác tử vẫn dùng tài nguyên và cần quyền phù hợp.

Agent SDK (bộ công cụ phát triển tác tử) đưa vòng lặp và công cụ của Claude Code vào ứng dụng Python hoặc TypeScript. Tiến trình chạy ở môi trường anh vận hành. Anh cần bố trí nơi chạy, thông tin xác thực và quyền truy cập.

Bắt đầu bằng một agent chỉ đọc để dễ quan sát. Cài gói trong môi trường Python riêng và dùng cách xác thực được tài liệu SDK hỗ trợ. Mẫu dưới giới hạn công cụ sẵn có bằng tools và chặn công cụ ngoài danh sách duyệt bằng dontAsk.

# Terminal: trong thư mục thử, đã cấu hình xác thực SDK
python3 -m venv .venv
source .venv/bin/activate
pip install claude-agent-sdk
# Lưu phần Python dưới vào agent.py rồi chạy: python agent.py
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
async def main():
    opts = ClaudeAgentOptions(tools=["Read", "Glob", "Grep"],
        allowed_tools=["Read", "Glob", "Grep"], permission_mode="dontAsk",
        max_turns=3)
    async for message in query(prompt="Đọc CLAUDE.md, tóm tắt 3 quy tắc ERP", options=opts):
        print(message)
asyncio.run(main())

Kiểm tra đã làm được: Thấy thông điệp trả về; agent đọc tệp hoặc báo thiếu tệp, không tự tạo CLAUDE.md.

Code harness (bộ khung vận hành agent) nối mô hình với công cụ và trạng thái phiên. Nó lo thực thi lời gọi, đưa kết quả lại và xử lý quyền. Chất lượng làm việc phụ thuộc cả bộ khung, dữ liệu và cách nghiệm thu.

Hook (điểm móc tự động) chạy khi một sự kiện của Claude Code xảy ra. PreToolUse chạy trước công cụ và có thể từ chối; PostToolUse chạy sau khi công cụ thành công. Kiểm tra sau không thể ngăn tác động đã xảy ra.

flowchart TD
 A["Claude đề nghị công cụ"] --> B["PreToolUse"]
 B --> C{"Cho qua kiểm tra quyền?"}
 C -->|Có| D["Chạy công cụ"]
 C -->|Không| E["Báo lý do chặn"]
 D --> F["PostToolUse khi thành công"]

Hook dạng command nhận thông tin sự kiện bằng JSON qua đầu vào chuẩn. Mẫu này chỉ ghi tên sự kiện ra đầu ra lỗi, không ghi nội dung phiếu. Ghép khóa hooks vào settings hiện có rồi dùng /hooks để kiểm tra.

// Phần JSON cần ghép vào .claude/settings.json, bỏ dòng chú thích này
{"hooks": {
  "PreToolUse": [{"matcher":"Read","hooks":[{"type":"command","command":"echo 'Trước khi đọc tệp' >&2"}]}],
  "PostToolUse": [{"matcher":"Read","hooks":[{"type":"command","command":"echo 'Đã đọc tệp' >&2"}]}]
}}
# Trong Claude Code:
/hooks
# Yêu cầu: Đọc CLAUDE.md và tóm tắt.

Kiểm tra đã làm được: /hooks liệt kê hai sự kiện; log hook cho thấy thứ tự trước và sau khi Read thành công.

Claude Managed Agents (agent do Anthropic quản lý) cung cấp harness và hạ tầng phiên chạy qua API, hiện ở beta theo nguồn đã mở. Agent là cấu hình dùng lại, còn session là một lần làm việc. Có thể dùng quy trình hướng dẫn chính thức dưới đây thay vì tự đoán cấu trúc API.

# Trong Claude Code có skill claude-api theo tài liệu hiện tại:
/claude-api managed-agents-onboard
# Brief khi được hỏi:
Tạo agent thử nghiệm đọc danh sách đơn hàng giả lập.
Chỉ tổng hợp đơn thiếu ngày giao; không kết nối ERP thật.
# Nếu chưa thấy skill, dùng trang quickstart trong Nguồn.

Kiểm tra đã làm được: Nhận cấu hình agent, environment và chương trình session; kiểm tra sự kiện trả về trong phiên thử.

Agentic loop (vòng lặp tác tử) lặp qua suy xét, hành động và quan sát. Kết quả công cụ giúp agent quyết định làm tiếp hay kết thúc. Đặt giới hạn lượt và thời gian để lỗi không kéo dài vô hạn.

flowchart LR
 A["Nhận mục tiêu"] --> B["Chọn bước"]
 B --> C["Gọi công cụ"] --> D["Đọc kết quả"]
 D --> B
 B --> E["Đủ tiêu chí: dừng"]

Tool call (lời gọi công cụ) là yêu cầu có tên và đầu vào cụ thể. Với công cụ phía khách trong Messages API, ứng dụng thực thi rồi gửi tool_result gắn đúng tool_use_id. Không coi văn bản đề nghị gọi công cụ là việc đã được thực hiện.

sequenceDiagram
 participant M as Mô hình
 participant H as Ứng dụng
 participant T as Công cụ ERP
 M->>H: tool_use và id
 H->>T: Xác thực rồi thực thi
 T-->>H: Kết quả
 H->>M: tool_result gắn id
 M-->>H: Kết luận hoặc bước tiếp

Message (thông điệp) có role chỉ người gửi và content chứa nội dung. Content có thể gồm nhiều block như văn bản, ảnh hoặc kết quả công cụ. Hãy đọc theo loại block thay vì giả định mọi phản hồi chỉ có một chuỗi chữ.

System prompt (chỉ dẫn hệ thống) định hướng vai trò và cách xử lý. Trong yêu cầu Messages API cơ bản, đặt nó ở trường system riêng. Chỉ dẫn này giúp hành vi nhất quán nhưng không thay thế kiểm tra quyền bằng chương trình.

Response format (cấu trúc phản hồi) gồm content, stop_reason và usage cùng các thông tin nhận dạng. Lọc block text để hiển thị và xử lý block công cụ theo luồng riêng. Khi cần dữ liệu đưa vào ERP, phải xác thực cấu trúc trước khi ghi.

max_tokens (số token đầu ra tối đa) đặt trần sinh cho một phản hồi. Đây không phải kích thước toàn bộ cửa sổ ngữ cảnh. Nếu chạm trần, câu trả lời hoặc đầu vào công cụ có thể chưa hoàn chỉnh.

stop_reason (lý do dừng) giúp ứng dụng chọn bước xử lý. end_turn thường là hết lượt; tool_use yêu cầu xử lý công cụ; max_tokens báo chạm trần đầu ra. Còn có các lý do khác như pause_turn, refusal và model_context_window_exceeded nên cần nhánh dự phòng.

Streaming (truyền từng phần) cho giao diện nhận sự kiện trong lúc phản hồi được tạo. Đoạn nhận được ban đầu chưa chắc là kết quả hoàn chỉnh. Gom đủ dữ liệu và xử lý tín hiệu kết thúc hoặc lỗi trước khi ghi thay đổi.

Image reasoning (đọc hiểu hình ảnh) giúp đối chiếu giao diện với yêu cầu. Claude có thể nhận ảnh nhưng chữ nhỏ, vùng bị che và ảnh mờ vẫn gây sai. Yêu cầu chỉ rõ vùng quan sát và đối chiếu với dữ liệu văn bản khi có.

Chọn một ảnh đã che dữ liệu khách hàng. Trong Claude Code, đưa ảnh bằng cách đính kèm được giao diện hỗ trợ hoặc chỉ rõ đường dẫn tệp cục bộ. Tách yêu cầu quan sát khỏi yêu cầu sửa để kiểm tra mô hình có đọc đúng không.

# Lưu ảnh thử tại screenshots/bgst-390.png
# Dán vào Claude Code:
Đọc ảnh screenshots/bgst-390.png bằng công cụ đọc ảnh.
Nêu 3 chi tiết nhìn thấy và vị trí nút duyệt.
Chỗ chữ không đọc được phải ghi không đọc được.
Chưa sửa mã; đề xuất cách kiểm tra trên màn hình 390px.

Kiểm tra đã làm được: Có mô tả kiểm được bằng mắt và các vùng không chắc; chưa có tệp mã bị sửa.

Prompt caching (lưu đệm tiền tố đầu vào) tái dùng phần đầu prompt đã xử lý, không phải lưu sẵn câu trả lời. Nội dung phần đầu cần khớp để có cache hit. Giữ quy trình ổn định phía trước và đặt dữ liệu từng phiếu phía sau.

Third-party provider (nhà cung cấp nền tảng khác) có cơ chế đăng nhập và định danh model riêng. Không dùng API key Anthropic như thể nó là quyền IAM của AWS. Tính năng, đường truyền và thanh toán phải kiểm tra theo đúng nền tảng đang dùng.

Batch API (API xử lý theo lô) nhận nhiều yêu cầu độc lập và chạy bất đồng bộ. Mỗi yêu cầu nên có custom_id để ghép kết quả, vì thứ tự trả về không được dùng làm khóa. Mẫu tạo một lô nhỏ rồi anh dùng ID nhận được để kiểm tra trạng thái.

# Python: đã cài anthropic và nạp ANTHROPIC_API_KEY từ môi trường
# CLAUDE_MODEL_ID là ID model tài khoản hỗ trợ, cần đặt trước khi chạy
import os, anthropic
client = anthropic.Anthropic()
batch = client.messages.batches.create(requests=[{
    "custom_id": "BGST-DEMO-01",
    "params": {"model": os.environ["CLAUDE_MODEL_ID"], "max_tokens": 300,
        "messages": [{"role":"user","content":"Phân loại: phiếu thiếu người duyệt"}]}
}])
print(batch.id)
# Chạy lại sau, thay ID_LO bằng giá trị đã in:
# print(client.messages.batches.retrieve("ID_LO").processing_status)
# Khi ended: duyệt client.messages.batches.results("ID_LO")

Kiểm tra đã làm được: Nhận mã lô; khi trạng thái ended thì đọc từng kết quả theo custom_id và kiểm tra lỗi từng mục.

Real-time (xử lý tương tác ngay) phù hợp lúc người dùng đang đợi. Batch phù hợp báo cáo cuối ngày và không hứa trả tức thì. Tài liệu giá đã mở nêu giảm 50% chi phí token cho Message Batches API; không áp dụng suy diễn sang mọi sản phẩm agent.

JSON (định dạng dữ liệu có khóa và giá trị) giúp máy đọc thông tin rõ ràng. Mỗi hệ thống vẫn cần quy định kiểu và trường bắt buộc. JSON đúng cú pháp chưa chứng minh dữ liệu đúng nghiệp vụ.

Version control (quản lý phiên bản) ghi lịch sử thay đổi mã và tài liệu. Commit là một mốc có mô tả để người khác xem và so sánh. Trước khi giao agent sửa, hãy biết nhánh đang làm và những thay đổi chưa lưu mốc.

Version control service (dịch vụ lưu kho mã) như GitHub cung cấp nơi chia sẻ và rà thay đổi. Git là công cụ quản lý phiên bản; tài khoản dịch vụ là một lớp riêng. Quyền đọc kho không đồng nghĩa quyền nhập bản sửa vào nhánh chính.

Code review (rà soát thay đổi mã) xem bản sửa có giải quyết đúng việc và gây tác dụng phụ không. Anh có thể đọc mô tả hành vi trước và sau dù không hiểu từng dòng mã. Hỏi bằng chứng kiểm tra nghiệp vụ để tránh chỉ nhìn mã chạy được.

/simplify là lệnh rà các cơ hội làm mã gọn và áp dụng sửa theo tài liệu hiện tại. Đừng coi nó là bảo chứng đúng nghiệp vụ hoặc thay cho code review. Chạy kiểm tra hành vi sau khi dọn vì cấu trúc mã đã đổi.

Surface (giao diện sử dụng) có thể là terminal, IDE, desktop hoặc web. Chúng phục vụ cách làm việc khác nhau và không nhất thiết có cùng môi trường tệp. Trước khi giao việc, xác nhận phiên đang chạy ở đâu và đọc được dữ liệu nào.

Content boundary (ranh giới nội dung) phân biệt yêu cầu của anh với dữ liệu được đọc. Tài liệu, email và kết quả công cụ có thể chứa câu giống mệnh lệnh nhưng vẫn là dữ liệu. Mọi hành động ảnh hưởng hệ thống cần đi qua quyền và kiểm tra đầu vào.

Session hygiene (giữ phiên gọn và đúng việc) bắt đầu bằng mục tiêu ngắn, dữ liệu cần thiết và điểm bàn giao rõ. Việc mới khác hẳn nên dùng phiên mới. Ghi kết luận bền vững vào tài liệu thích hợp để không phải dựa vào trí nhớ cuộc chat.

Plugin (gói mở rộng) gom skills, agents, hooks hoặc MCP servers để cài chung. Kiểm tra nguồn và nội dung trước khi dùng vì một thành phần có thể chạy chương trình. Tên plugin không tự chứng minh gói phù hợp quy trình công ty.

CLAUDE.md là tệp chỉ dẫn dài hạn do nhóm viết cho Claude Code. Đặt kiến thức ổn định như cách chạy kiểm tra và quy tắc nghiệp vụ cốt lõi vào đây. Viết ngắn, có thể kiểm chứng và tránh nhét bí mật hoặc toàn bộ tài liệu vào một tệp.

Settings scope (phạm vi cấu hình) quyết định thay đổi áp dụng cho cá nhân, dự án hay tổ chức. ~/.claude/settings.json là cấu hình người dùng; .claude/settings.json chia sẻ cho dự án; .claude/settings.local.json dành riêng cá nhân trong dự án. Cấu hình managed do tổ chức quản lý có vai trò áp chính sách.

Với một khóa đơn thông thường, thứ tự ưu tiên từ cao xuống là managed, --settings, project local, project và user. Danh sách như permission rules có cách gộp riêng nên không suy diễn như khóa đơn. Dùng /status và tài liệu của từng khóa để xác nhận cấu hình đã nạp.

Model version pinning (ghim định danh model cụ thể) giúp giảm thay đổi ngoài ý muốn khi đánh giá hệ thống. Chọn ID còn được hỗ trợ trên nền tảng đang dùng và ghi nó cùng phiên bản ứng dụng. Alias tiện cho cập nhật nhưng cần đánh giá lại khi hành vi thay đổi.

Prompt version (phiên bản chỉ dẫn) giúp giải thích vì sao cùng dữ liệu mà cách trả lời đổi. Lưu prompt như tệp có lịch sử và gắn phiên bản với báo cáo thử nghiệm. Đánh giá bằng cùng bộ tình huống trước khi đưa vào dùng chung.

Rules (các quy tắc theo chủ đề hoặc đường dẫn) giúp tách hướng dẫn khỏi CLAUDE.md chính. Tệp Markdown trong .claude/rules có thể nhắm vào nhóm tệp bằng frontmatter paths. Chỉ đưa quy tắc thật sự liên quan để tránh làm mọi nhiệm vụ đều mang cùng gánh nặng.

Tạo một quy tắc nhỏ trong bản sao dự án. Đường dẫn dưới đây là ví dụ cần đổi theo cây mã thực tế. Đọc một tệp khớp đường dẫn rồi hỏi Claude nêu quy tắc áp dụng.

---
paths:
  - "src/approvals/**"
---
Giữ kiểm tra quyền duyệt ở máy chủ.
Mỗi thay đổi phải nêu trường hợp có quyền và không có quyền.

Sau khi lưu, trong Claude Code: Đọc src/approvals/ và nêu quy tắc áp dụng.

Kiểm tra đã làm được: Khi đọc vùng mã khớp paths, Claude nêu đúng hai yêu cầu; nếu không, kiểm lại đường dẫn và /memory.

Agent Skill (gói hướng dẫn chuyên việc) gồm SKILL.md và có thể kèm tài nguyên hoặc script. Claude có thể dùng khi phù hợp, hoặc anh gọi bằng /tên-skill. Mô tả cần nói rõ dùng lúc nào và đầu ra là gì.

Tạo một thư mục skill có tên dễ nhớ và một SKILL.md. Mẫu này chỉ soạn nội dung để anh xem, không tự gửi đi. Sau khi Claude nhận skill, gọi nó bằng lệnh để kiểm tra đầu ra.

---
name: phieu-hoi
description: Soạn nháp phiếu hỏi BGST khi yêu cầu còn thiếu quyết định nghiệp vụ.
disable-model-invocation: true
---
Từ yêu cầu, nêu bối cảnh, quyết định cần chốt và 2 phương án.
Chỉ soạn nháp; nêu người cần trả lời nếu đã biết.

Sau khi lưu, trong Claude Code: /phieu-hoi Chưa rõ ai duyệt đơn vượt hạn mức.

Kiểm tra đã làm được: Nhận bản nháp có bối cảnh, quyết định và hai phương án; không có hành động gửi phiếu.

/resume mở bộ chọn để quay lại một phiên đã lưu. Tên phiên rõ giúp tìm đúng công việc, nhưng vẫn phải đọc trạng thái tệp hiện tại. Một cuộc chat cũ không bảo đảm mã trên đĩa vẫn giữ nguyên.

Đặt tên phiên trước khi nghỉ để dễ nhận ra. Dùng /resume trong Claude Code hoặc --resume khi khởi động từ terminal. Khi trở lại, yêu cầu đối chiếu những gì đã xong và còn thiếu.

# Trong phiên hiện tại:
/rename bgst-duyet-thu
# Sau khi thoát, chạy từ terminal ở đúng thư mục:
claude --resume "bgst-duyet-thu"
# Hoặc trong Claude Code:
/resume

Kiểm tra đã làm được: Bộ chọn hoặc tên phiên đưa anh về đúng nội dung cũ; kiểm lại các tệp đã thay đổi trên đĩa.

Fork session (tách nhánh phiên) sao chép lịch sử để thử hướng khác. Cờ --fork-session kết hợp --continue hoặc --resume tạo phiên có ID mới. Nó không tự tạo nhánh Git hay cách ly những tệp cùng nằm trong một thư mục.

Dùng cờ CLI để hành vi tách phiên được rõ ràng. Giữ yêu cầu thử chỉ phân tích nhằm tránh đụng tệp của phiên gốc. Phân biệt với /fork của bản Claude Code hiện tại có thể tạo phiên nền và /branch dùng để chuyển sang nhánh hội thoại.

# Terminal, tại thư mục dự án:
claude --resume "bgst-duyet-thu" --fork-session
# Trong phiên mới:
Đề xuất phương án khác; chỉ phân tích, chưa sửa tệp.
/rename bgst-phuong-an-b

Kiểm tra đã làm được: Phiên mới có tên riêng và giữ lịch sử trước khi tách; phiên gốc vẫn chọn được bằng /resume.

/context cho thấy mức sử dụng ngữ cảnh và các thành phần chiếm chỗ. Đây là công cụ chẩn đoán để anh biết có cần tóm tắt hoặc giảm log không. Không suy từ một ô màu ra chi phí chính xác của cả dự án.

/rename đặt tên dễ tìm cho phiên; /rewind quay về một checkpoint của hội thoại hoặc tệp được theo dõi. Chọn rõ muốn khôi phục mã, cuộc chat hay cả hai. Nó không thu hồi email, giao dịch ERP hoặc mọi thay đổi do lệnh shell tạo ra.

Thử với một tệp nháp trong thư mục riêng. Yêu cầu Claude dùng công cụ sửa tệp để có thay đổi được theo dõi. Mở rewind và tự chọn đúng hành động khôi phục.

# Trong Claude Code của thư mục thử:
/rename thu-rewind-bgst
# Gửi: Tạo tệp nhap-bgst.txt chứa dòng "Bản đầu".
# Gửi tiếp: Dùng công cụ sửa tệp đổi thành "Bản hai".
/rewind
# Chọn mốc trước lần đổi, rồi chọn khôi phục mã.

Kiểm tra đã làm được: Tệp nháp trở về nội dung mốc được chọn; kiểm tra bằng cách đọc tệp, không chỉ dựa vào thông báo.

/status mở thông tin phiên như phiên bản, model và tài khoản. Phần nguồn settings giúp biết Claude đã nạp cấu hình từ đâu. Xem trạng thái trước khi tìm lỗi để tránh sửa cấu hình không được dùng.

/security-review tìm rủi ro bảo mật trong thay đổi của nhánh so với nhánh mặc định ở origin. Lệnh cần origin phù hợp và không phải chứng nhận hệ thống an toàn tuyệt đối. Phát hiện cần được xác minh và chuyển thành kiểm tra có thể tái hiện.

Một sub-agent có chỉ dẫn, danh sách công cụ và ngữ cảnh riêng. Dùng mô tả nhiệm vụ cụ thể để Claude biết khi nào giao việc. Quyền ở mức hệ thống vẫn cần được kiểm soát, kể cả khi tác tử mang tên kiểm toán.

Định nghĩa tác tử trong .claude/agents bằng Markdown có frontmatter. Mẫu giới hạn công cụ đọc và tìm kiếm để phù hợp rà soát. Mở phiên mới nếu cấu hình chưa được nhận rồi gọi bằng tên.

---
name: ra-duyet
description: Rà mã kiểm tra quyền duyệt phiếu BGST, chỉ đọc.
tools: Read, Glob, Grep
---
Tìm điểm kiểm quyền phía máy chủ.
Trả về tệp, bằng chứng và tình huống còn thiếu.
Không sửa mã và không gửi yêu cầu thay đổi ERP.

Sau khi lưu, trong Claude Code: Dùng sub-agent ra-duyet rà luồng duyệt phiếu.

Kiểm tra đã làm được: Nhận báo cáo có vị trí mã và tình huống kiểm tra; không có tệp bị sửa bởi tác tử này.

Auto memory (ghi chú tự động) là thông tin Claude ghi lại qua quá trình làm việc. Nó khác CLAUDE.md do nhóm chủ động viết và cần được xem lại vì có thể lỗi thời. Đừng giao cho ghi chú tự động vai trò quyết định quyền duyệt.

Dùng /memory để xem và quản lý phần bộ nhớ đang áp dụng. Chọn một sở thích vô hại, nhờ Claude ghi nhớ rồi kiểm tra tệp thực sự được lưu. Tránh yêu cầu nhớ token truy cập hoặc dữ liệu khách hàng.

# Trong Claude Code:
/memory
# Yêu cầu:
Ghi nhớ sở thích của tôi: báo cáo bằng tiếng Việt,
nêu bằng chứng kiểm tra và việc còn thiếu.
Cho biết tệp ghi chú nào đã được cập nhật.
# Mở lại /memory để xem nội dung.

Kiểm tra đã làm được: Tìm được ghi chú đã lưu hoặc thông báo tính năng bị tắt; kiểm lại nội dung trước khi dùng lâu dài.

Session (phiên làm việc) giữ lịch sử để agent tiếp tục một nhiệm vụ. Tên phiên, nhánh mã và tài liệu bàn giao nên cùng chỉ vào một việc. Phiên được lưu không có nghĩa mọi tác động ngoài hệ thống đều được ghi nhận đầy đủ.

Headless task (việc chạy không tương tác) thường dùng claude -p để nhận yêu cầu và xuất kết quả. Nó có thể nằm trong chương trình hoặc bộ lập lịch do anh vận hành. Bản thân -p không phải lời hứa tự chạy nền mãi hoặc tự xử lý mọi yêu cầu duyệt.

Chọn một báo cáo chỉ đọc để thử với -p. Đầu ra JSON giúp chương trình sau đọc trạng thái và kết quả. Danh sách tools giới hạn công cụ sẵn có; dontAsk từ chối lời gọi cần duyệt chưa được cho phép.

# Terminal, thư mục thử đã có CLAUDE.md:
claude -p "Đọc CLAUDE.md; tóm tắt 3 quy tắc ERP"   --tools "Read,Glob,Grep" --allowedTools "Read,Glob,Grep"   --permission-mode dontAsk --max-turns 3   --output-format json > bao-cao-thu.json

Kiểm tra đã làm được: Tiến trình kết thúc và có tệp JSON; xem trạng thái lỗi nếu thiếu xác thực, thiếu tệp hoặc hết lượt.

Auto mode (chế độ xét hành động tự động) dùng bộ phân loại riêng để giảm các câu hỏi duyệt thường gặp. Tính khả dụng phụ thuộc phiên bản, model, giao diện và chính sách tổ chức. Nó không thay cho quyền nghiệp vụ trong ERP và không phải bypassPermissions.

Chỉ định mode cho một phiên thử bằng cờ CLI để tránh nhầm cấu hình. Kiểm tra trạng thái thực tế vì môi trường có thể không cho dùng auto. Các quy tắc ask và deny vẫn có tác dụng theo tài liệu quyền.

# Terminal, tại bản sao thử:
claude --permission-mode auto
# Trong phiên:
/status
# Yêu cầu: Đọc CLAUDE.md và liệt kê việc cần kiểm tra, chưa sửa mã.
# Không đặt defaultMode:auto trong settings dự án;
# tài liệu hiện tại không nhận giá trị đó từ project/local.

Kiểm tra đã làm được: Thấy mode thực tế của phiên; nếu auto không khả dụng, giữ mode được hỗ trợ và đọc lý do trong tài liệu.

Top-level CLAUDE.md (tệp chỉ dẫn ở gốc dự án) là điểm vào cho kiến thức dùng chung. Nó nên trả lời dự án làm gì, tìm nghiệp vụ ở đâu và xác minh bằng cách nào. Hướng dẫn từng vùng mã có thể đặt gần vùng đó để giữ tệp gốc ngắn.

Tách thông tin theo mục đích để anh dễ sửa và rà soát. Cây dưới là cách tổ chức mẫu, không phải bằng chứng hệ thống công ty đang có các tệp ấy. Sau khi tạo, dùng /memory, /hooks và /status để đối chiếu phần đã nạp.

CLAUDE.md                       # Mục tiêu, cách kiểm tra, đường dẫn tài liệu
.claude/settings.json            # Cấu hình dùng chung
.claude/rules/approvals.md        # Quy tắc theo vùng mã
.claude/skills/phieu-hoi/SKILL.md # Cách soạn nháp
.claude/agents/ra-duyet.md        # Tác tử chuyên rà quyền
# Yêu cầu Claude: tạo các tệp mẫu trên trong thư mục thử,
# hỏi lại đường dẫn mã chưa biết; chưa kết nối ERP thật.

Kiểm tra đã làm được: Có bộ tệp đọc được, vai trò không trùng lặp và không chứa khóa truy cập.

Debug (chẩn đoán chi tiết) bổ sung dấu vết về hoạt động của chương trình. Dùng nó để tìm nơi lỗi xảy ra rồi đối chiếu giả thuyết. Log có thể chứa thông tin nhạy cảm nên chỉ chia sẻ phần đã lọc.

Tái hiện một việc nhỏ giúp đọc log dễ hơn. Cờ --debug được dùng khi khởi động Claude Code; xem --help của bản cài để biết tùy chọn bổ sung. Kết hợp /status để biết cấu hình đang nạp từ đâu.

# Terminal, thư mục thử:
claude --debug
# Trong Claude Code:
/status
/hooks
# Yêu cầu: Đọc CLAUDE.md.
# Kiểm tra tên sự kiện, matcher Read và lỗi JSON;
# không chia sẻ log thô có bí mật.

Kiểm tra đã làm được: Xác định được hook có được nạp không và lời gọi có khớp matcher không; ghi rõ bằng chứng thay cho phỏng đoán.

Token (đơn vị văn bản mô hình xử lý) không tương đương một từ tiếng Việt. Đầu vào, đầu ra và dữ liệu công cụ đều góp vào lượng cần xử lý. Muốn ước lượng sát, dùng bộ đếm của nền tảng thay vì đếm khoảng trắng.

Context window (cửa sổ ngữ cảnh) là giới hạn thông tin mô hình có thể xét trong một lượt. Nó chứa cả chỉ dẫn, hội thoại, công cụ và phần đầu ra liên quan theo quy tắc model. Giới hạn cụ thể phụ thuộc model và nền tảng, nên không gán một con số cho mọi Claude.

Sampling (lấy mẫu lựa chọn token) là một phần cách mô hình sinh câu trả lời. Các tham số hỗ trợ thay đổi theo model và thinking mode. Đừng sao chép temperature hay top_p từ ví dụ cũ sang mọi model mà chưa kiểm tra.

Non-determinism (tính không hoàn toàn tất định) nghĩa là cùng yêu cầu có thể cho kết quả khác nhau. Cấu hình giảm biến động cũng không bảo đảm mọi lần giống hệt. Dùng tiêu chí và kiểm tra đầu ra để giữ chất lượng chấp nhận được.

Large language model, LLM (mô hình ngôn ngữ lớn) học các quy luật để dự đoán và tạo nội dung. Nó có thể giải thích, phân tích và đề xuất nhưng vẫn có thể đưa thông tin sai. Khi cần biết trạng thái thật của ERP, phải lấy bằng chứng từ hệ thống.

/fast bật hoặc tắt fast mode (chế độ phản hồi nhanh) trên model và tài khoản hỗ trợ. Theo tài liệu, đây là cấu hình chạy nhanh của model được hỗ trợ, có giá token cao hơn. Không coi fast là cách chuyển sang model nhỏ hoặc tự giảm chi phí.

Kiểm tra khả dụng trước khi bật vì tài khoản và nền tảng có thể giới hạn. Dùng cùng một yêu cầu nhỏ để quan sát độ trễ và mức sử dụng. Xem trang giá đã dẫn trước khi dùng lâu dài.

# Trong Claude Code, dùng model hỗ trợ:
/fast
# Bật theo lựa chọn giao diện, rồi gửi:
Nêu 3 thông tin cần có để tái hiện lỗi nút duyệt BGST.
# Sau khi thử, mở lại để tắt:
/fast

Kiểm tra đã làm được: Thấy trạng thái fast thực tế hoặc lý do không khả dụng; không suy chi phí từ tốc độ nhìn bằng mắt.

Effort (mức công sức suy xét) hướng dẫn model dành ít hay nhiều tài nguyên cho phản hồi. /effort điều chỉnh trong Claude Code; API dùng tham số theo tài liệu tương ứng. Mức cao không thay thế dữ liệu thiếu hoặc một phép kiểm tra cụ thể.

Chọn hai mức được model hiện tại hỗ trợ. Cho cùng một đề bài và đánh giá theo tiêu chí cố định. So chất lượng, độ trễ và usage thay vì chỉ nhìn độ dài câu trả lời.

# Trong Claude Code:
/effort low
# Gửi: Nêu rủi ro và 3 tình huống kiểm tra tách người tạo/người duyệt.
/effort high
# Gửi lại cùng yêu cầu, so bằng cùng tiêu chí.
/effort status

Kiểm tra đã làm được: Có hai kết quả để đối chiếu: đủ tình huống, có bằng chứng cần lấy, thời gian và lượng dùng quan sát được.

Zero-shot (không có ví dụ) chỉ đưa yêu cầu, single-shot (một ví dụ) thêm một mẫu, multi-shot (nhiều ví dụ) thêm nhiều mẫu. Ví dụ giúp thể hiện cách anh muốn phân loại hoặc trình bày. Chọn cả trường hợp khó để tránh mô hình học lệch mẫu dễ.

Mỗi vòng lặp có thể cần năng lực khác nhau nhưng đổi model cũng tăng độ phức tạp vận hành. Đánh giá một model đủ tốt trước rồi mới phân tuyến nhiệm vụ. Dùng cùng bộ tình huống để so chất lượng, thời gian và chi phí.

Adaptive thinking (suy xét thích ứng) để model quyết định khi nào cần suy xét và sâu đến đâu theo cấu hình được hỗ trợ. Khả năng và mặc định khác nhau giữa các model. Kiểm tra bảng hỗ trợ trước khi gửi thinking.type hoặc effort.

Manual extended thinking (suy xét với ngân sách đặt tay) dùng thinking.type enabled và budget_tokens trên model hỗ trợ dạng cũ. Adaptive dùng cơ chế thích ứng, kết hợp effort để định hướng mức công sức. Theo tài liệu hiện tại, nhiều model mới từ chối ngân sách thinking dạng cũ; không hoán đổi hai cấu hình một cách máy móc.

Token Count API (API đếm token) cho biết lượng đầu vào trước khi gọi sinh câu trả lời. Endpoint là /v1/messages/count_tokens và nhận đầu vào theo cấu trúc hỗ trợ của API. Kết quả giúp ước lượng, còn chi phí thực tế phải đối chiếu usage và bảng giá.

Cost modeling (ước lượng chi phí) tách token đầu vào thường, ghi cache, đọc cache và đầu ra. Lấy từng lượng token nhân đơn giá tương ứng rồi cộng các phí tính năng thực sự dùng. Đừng tính chỉ từ câu trả lời hiển thị vì thinking và nhiều lượt công cụ có thể tăng lượng dùng.

Giá ghi cache và đọc cache khác nhau, nên lần đầu chưa chắc rẻ hơn gọi thường. Trang giá đã mở nêu ghi cache 5 phút bằng 1,25 lần và 1 giờ bằng 2 lần giá input cơ bản; giá đọc tùy model, có các mức 0,1, 0,05 hoặc 0,025 lần. Đối chiếu đúng dòng model, TTL và nền tảng trước khi đưa vào dự toán.

Tool output pruning (lọc gọn kết quả công cụ) giữ thông tin liên quan và bỏ phần lặp. Giữ lại lỗi, mã phiếu và bằng chứng cần kiểm tra. Không cắt mất chi tiết khiến agent tưởng kiểm tra đã thành công.

/compact tóm tắt để tiếp tục cùng việc với ngữ cảnh gọn hơn. /clear bắt đầu cuộc hội thoại mới; bộ nhớ dự án là cơ chế riêng và không tự bị xóa theo cuộc chat. Trước mỗi lựa chọn, ghi lại quyết định và bằng chứng quan trọng.

Xem /context trước khi chọn để biết vấn đề có phải ngữ cảnh dài không. Compact có thể nhận chỉ dẫn giữ trọng tâm cho bản tóm tắt. Chỉ dùng clear sau khi đã lưu kết luận cần giữ bên ngoài cuộc chat.

# Trong Claude Code:
/context
/compact Giữ mã phiếu BGST, bằng chứng lỗi, quyết định và việc còn thiếu
# Đọc lại bản tóm tắt và lưu bàn giao vào tài liệu phù hợp.
# Khi chuyển sang một nhiệm vụ hoàn toàn mới:
/clear
# Nếu cần quay lại phiên đã lưu:
/resume

Kiểm tra đã làm được: Sau compact vẫn tiếp tục đúng việc; sau clear có hội thoại mới và có thể chọn phiên cũ bằng resume.

Explicit criteria (tiêu chí nêu rõ) biến lời nhờ chung chung thành kết quả có thể nghiệm thu. Nêu người dùng, đầu vào, hành vi cần có và cách kiểm tra. Chỉ định điều chưa biết để agent tìm bằng chứng thay vì tự đoán.

Few-shot prompting (hướng dẫn bằng vài ví dụ) cho thấy đầu ra đúng trông ra sao. Dùng mẫu đủ dữ liệu, thiếu dữ liệu và dễ nhầm để làm rõ ranh giới. Thay dữ liệu thật bằng ví dụ đã ẩn thông tin nhạy cảm.

Structured JSON generation (sinh dữ liệu JSON theo cấu trúc) cần schema xác định khóa, kiểu và ràng buộc. Structured outputs của API dùng output_config.format trên model được hỗ trợ, còn chỉ yêu cầu bằng lời không bảo đảm khớp schema. Sau khi đúng cấu trúc, vẫn kiểm tra nghiệp vụ và trạng thái kết thúc.

Refinement loop (vòng cải tiến) tạo bản đầu, kiểm theo tiêu chí rồi sửa phần chưa đạt. Mỗi vòng phải chỉ ra lỗi cụ thể và cách đo đã sửa được. Đặt số vòng tối đa để tránh đổi câu chữ mãi mà không nâng chất lượng.

Dùng một yêu cầu nhỏ và ba tiêu chí nghiệm thu. Nhờ Claude tự chỉ chỗ chưa đạt rồi sửa một vòng. Anh kiểm kết quả bằng cùng tiêu chí, không chỉ xem mô hình tự chấm.

# Dán vào Claude Code:
Soạn nháp phiếu hỏi: chưa rõ có được giao trước khi thu đủ tiền.
Tiêu chí: nêu rủi ro, đưa 2 phương án, có 1 quyết định cần chốt.
Đầu tiên viết nháp. Sau đó chỉ ra tiêu chí nào chưa đạt,
sửa tối đa 2 vòng và báo phần còn chưa biết.
Không tự gửi phiếu hoặc giả định công ty đã duyệt phương án.

Kiểm tra đã làm được: Có bản nháp đạt ba tiêu chí hoặc danh sách thiếu cụ thể; không có quyết định nghiệp vụ bị tự bịa.

Prompt injection (chèn lệnh qua nội dung không đáng tin) xảy ra khi dữ liệu cố điều khiển agent làm khác yêu cầu. Đặt ranh giới nội dung, quyền tối thiểu và kiểm tra phía chương trình để giảm tác động. Không trông chờ một câu nhắc trong prompt chặn được mọi kiểu tấn công.

PII, personally identifiable information (thông tin có thể nhận dạng cá nhân) gồm những dữ liệu có thể giúp nhận ra một người. Chỉ gửi phần cần cho nhiệm vụ và dùng mã giả khi có thể. Kiểm tra cả đầu vào, log, báo cáo và tệp được chia sẻ vì rò rỉ có thể xuất hiện ở nhiều chỗ.

Permission rule (quy tắc quyền công cụ) cho phép, buộc hỏi hoặc từ chối lời gọi khớp điều kiện. Quy tắc cần cụ thể theo công cụ và tác động. Với các quy tắc khớp, deny được xét trước ask rồi allow theo tài liệu hiện tại.

Thử ở thư mục riêng để quan sát quyền mà không ảnh hưởng dự án đang làm. Mẫu chặn Bash hoàn toàn và buộc hỏi trước sửa tệp bằng Edit. Đây là giới hạn lời gọi trong Claude Code, còn quyền hệ điều hành và dịch vụ ngoài phải cấu hình riêng.

// Ghép vào .claude/settings.local.json của thư mục thử; bỏ chú thích
{"permissions": {
  "allow": ["Read", "Glob", "Grep"],
  "ask": ["Edit"],
  "deny": ["Bash"]
}}
# Trong Claude Code:
/permissions
# Yêu cầu thử: dùng Bash chạy pwd; sau đó đọc CLAUDE.md bằng Read.

Kiểm tra đã làm được: Bash bị từ chối theo rule, còn Read hoạt động nếu không có hạn chế khác; xem rule thực tế bằng /permissions.

Sandbox (môi trường có giới hạn truy cập) của Bash dùng cơ chế hệ điều hành để hạn chế tệp và mạng cho lệnh chạy trong đó. Nó bổ sung lớp bảo vệ bên dưới lời nhắc duyệt. Không suy rằng mọi công cụ hay mọi dịch vụ bên ngoài đều nằm trong sandbox Bash.

Trên nền tảng được hỗ trợ, mở /sandbox để xem khả dụng và bật giới hạn. Dùng bản sao thử và một phép đọc vô hại để xác nhận. Auto-allow của sandbox là lựa chọn liên quan lệnh trong sandbox, khác auto mode xét hành động bằng model.

# Trong Claude Code:
/sandbox
# Xem yêu cầu hệ điều hành và chọn chế độ phù hợp.
# Có thể ghép cấu hình thử sau vào settings:
{"sandbox":{"enabled":true,"autoAllowBashIfSandboxed":false}}
# Yêu cầu: dùng Bash chạy pwd và nêu trạng thái sandbox đã dùng.

Kiểm tra đã làm được: Xác nhận từ trạng thái/log rằng Bash có chạy trong sandbox; nếu thiếu hỗ trợ hệ điều hành, chưa coi thử nghiệm là đạt.

Hooks gắn việc tự động vào các sự kiện cụ thể thay vì chỉ nhắc model nhớ. Ngoài PreToolUse và PostToolUse, có PostToolUseFailure cho lỗi công cụ, SessionStart cho đầu phiên và Stop cho lúc agent định kết thúc. Mỗi sự kiện có đầu vào và cơ chế quyết định riêng, cần tra trước khi viết.

flowchart TD
 A["SessionStart"] --> B["Agent làm việc"]
 B --> C["PreToolUse"] --> D["Công cụ"]
 D --> E["PostToolUse khi thành công"]
 D --> F["PostToolUseFailure khi lỗi"]
 E --> B
 F --> B
 B --> G["Stop và kiểm tra bàn giao"]

Security hook (hook kiểm tra an toàn) nên chặn trước hành động theo điều kiện dễ kiểm. Mẫu dưới chặn công cụ Edit và Write nhắm tệp có tên bắt đầu bằng .env; nó không bao phủ lệnh shell hay đường khác nên cần kết hợp quyền và sandbox. Tên tool duyệt phiếu và quyền thực tế của BGST hiện chưa kiểm chứng; không đưa tên giả vào rule chạy thật.

# Tệp .claude/hooks/protect-env.py
import json, pathlib, sys
try:
    event = json.load(sys.stdin)
    name = pathlib.Path(event.get("tool_input", {}).get("file_path", "")).name
except Exception:
    print("Không đọc được đầu vào hook", file=sys.stderr)
    sys.exit(2)
if name.startswith(".env"):
    print("Chặn sửa tệp môi trường qua Edit/Write", file=sys.stderr)
    sys.exit(2)
# Ghép JSON dưới vào settings (không ghép phần Python):
{"hooks":{"PreToolUse":[{"matcher":"Edit|Write","hooks":[
  {"type":"command","command":"python3 .claude/hooks/protect-env.py"}
]}]}}
# Thử chỉ trong thư mục demo: yêu cầu tạo .env.demo bằng Write.

Kiểm tra đã làm được: Lời gọi Edit/Write bị chặn trước khi sửa .env.demo; kiểm tra tệp vẫn không đổi. Mẫu là minh họa một lớp bảo vệ, không phải bộ bảo mật hoàn chỉnh.

API key (khóa truy cập API) là bí mật xác thực, cần nạp bằng cơ chế môi trường hoặc quản lý bí mật phù hợp. Không ghi khóa thật vào prompt, mã nguồn hay tệp HTML bài học. Cách xác thực và thanh toán phụ thuộc đang dùng Claude API trực tiếp hay một nhà cung cấp khác.

Permission mode (chế độ quyền) đặt cách Claude xử lý việc cần duyệt. Các giá trị gồm default, acceptEdits, plan, auto, dontAsk và bypassPermissions với hành vi khác nhau. dontAsk từ chối các việc cần hỏi chưa được cho phép; bypassPermissions bỏ nhiều kiểm tra thông thường nên chỉ dùng với cách ly phù hợp và hiểu giới hạn còn lại.

Khởi động hai phiên thử với mode chỉ định để thấy sự khác nhau. plan phục vụ khảo sát trước khi thay đổi, còn dontAsk giúp thử chính sách không hỏi trong tác vụ tự động. Chỉ kiểm tra trên thư mục thử và đọc mode thực tế khi phiên mở.

# Terminal: khảo sát trước khi sửa
claude --permission-mode plan
# Thoát phiên thử, rồi chạy lệnh chỉ đọc:
claude -p "Đọc CLAUDE.md và nêu quy tắc duyệt"   --permission-mode dontAsk --tools "Read,Glob,Grep"   --allowedTools "Read,Glob,Grep" --max-turns 3

Kiểm tra đã làm được: Phiên plan chưa tự sửa tệp; lần chạy dontAsk chỉ thực hiện lời gọi đã được cho phép và báo lỗi rõ nếu bị chặn.

Authentication (xác thực danh tính) trả lời đang là ai; authorization (phân quyền) trả lời được làm gì. Đăng nhập thành công không chứng minh có quyền duyệt một phiếu. Quyền phải được kiểm tra tại dịch vụ nhận yêu cầu, theo đối tượng và phạm vi thực tế.

Tool choice (chính sách chọn công cụ) định hướng mô hình có thể hoặc phải gọi công cụ nào theo API hỗ trợ. Quyết định chọn công cụ không thay cho quyền thực thi của dịch vụ. Đưa ít công cụ, tên rõ và tác dụng hẹp giúp agent chọn dễ hơn.

Tool description (mô tả công cụ) nói khi nào dùng, nhận gì và trả gì. Schema mô tả cấu trúc đầu vào, còn mô tả giải thích ý nghĩa nghiệp vụ và tác dụng phụ. Đừng đặt hai công cụ gần giống tên nhưng không nói được khác nhau ở đâu.

Error handling (xử lý lỗi) cần phân biệt lỗi tạm thời, dữ liệu sai và thiếu quyền. Chỉ thử lại khi có lý do, có giới hạn và biết hành động có thể bị lặp không. Với thao tác ghi, cần khóa chống trùng hoặc cách đối chiếu trạng thái trước khi thử lại.

Agent tool (công cụ giao tác tử phụ) cho phép agent chính giao việc chuyên biệt. Tên và đầu vào cụ thể phụ thuộc phiên bản hoặc bộ khung, nên dùng cấu hình và tài liệu đang áp dụng. Mô tả đầu ra và quyền đọc giúp người điều phối nhận báo cáo có thể ghép.

flowchart TD
 A["Agent chính"] --> B["Giao nhiệm vụ rà quyền"]
 B --> C["Tác tử phụ dùng công cụ đọc"]
 C --> D["Báo cáo có bằng chứng"]
 D --> A

Dùng tác tử ra-duyet đã tạo ở chương vận hành. Giao nhiệm vụ bằng lời để Claude dùng cơ chế công cụ phù hợp phiên bản hiện tại. Kiểm tra đầu ra có đủ bằng chứng, không chỉ có một kết luận chung.

# Trong Claude Code có .claude/agents/ra-duyet.md:
Dùng sub-agent ra-duyet để rà luồng duyệt BGST.
Chỉ đọc mã. Trả tối đa 5 phát hiện với đường dẫn,
bằng chứng và cách kiểm tra lại. Nếu không tìm thấy mã,
nói rõ vùng đã tìm và thông tin còn thiếu.
Không sửa tệp và không gọi dịch vụ ERP thật.

Kiểm tra đã làm được: Quan sát việc giao tác tử và nhận báo cáo giới hạn đúng phạm vi; thiếu mã thì phải báo thiếu, không bịa phát hiện.

MCP, Model Context Protocol (giao thức kết nối mô hình với nguồn dữ liệu và công cụ) chuẩn hóa cách client nói chuyện với server. Claude Code là client, còn server cung cấp khả năng đã cấu hình. Kết nối thành công vẫn cần kiểm tra quyền, nguồn máy chủ và dữ liệu được trả về.

flowchart LR
 A["Claude Code: MCP client"] --> B["MCP server nội bộ"]
 B --> C["API ERP kiểm quyền"]
 B --> D["Resources: tài liệu"]
 B --> E["Prompts: mẫu yêu cầu"]

MCP resource (tài nguyên ngữ cảnh) cung cấp dữ liệu có định danh để đọc. MCP tool (công cụ) là thao tác có đầu vào và có thể chỉ đọc hoặc gây thay đổi. Tên resource hay tool không đủ kết luận an toàn; cần xem nội dung và hành vi thực tế.

Bắt đầu bằng liệt kê máy chủ đã cấu hình rồi xem khả năng thật của một máy chủ tin cậy. Dùng @ để chọn resource mà server thực sự công bố. Với tool, chỉ thử một thao tác đọc đã xác nhận thay vì đoán tên lệnh nghiệp vụ.

# Terminal:
claude mcp list
# Trong Claude Code:
/mcp
# Gõ @ rồi chọn một resource từ máy chủ đã xác thực.
# Yêu cầu: Tóm tắt resource vừa đính kèm.
# Tiếp theo: Liệt kê tool chỉ đọc có thể tra phiếu demo;
# cho biết schema và quyền cần có trước khi gọi.

Kiểm tra đã làm được: Phân biệt được dữ liệu resource đã đọc với kết quả một tool; nếu không có server thì bài dừng ở việc xác nhận chưa cấu hình.

MCP prompt (mẫu yêu cầu do server cung cấp) giúp người dùng khởi động tác vụ có khuôn. Claude Code hiện hiển thị dạng /servername:promptname và cũng hỗ trợ dạng /mcp__servername__promptname. Prompt không tự cấp quyền cho các hành động mà nó đề nghị.

Claude Platform on AWS là tích hợp do Anthropic vận hành, dùng AWS cho lớp truy cập và thanh toán; khác Amazon Bedrock. Tài liệu hướng dẫn đăng ký từ AWS Console, hoàn tất tổ chức Anthropic, ghi workspace ID rồi vào Claude Console. Vùng triển khai, quyền IAM và khả dụng thực tế của tài khoản Vận Tốc Số hiện chưa kiểm chứng; phải xác nhận trước khi kết nối ERP.

Built-in tools (công cụ tích hợp) như Read, Glob, Grep, Edit và Bash cho agent thao tác tệp và lệnh. Mỗi công cụ có phạm vi tác động khác nhau. Chỉ đưa khả năng cần dùng và kiểm quyền riêng thay vì cho mọi thứ ngay từ đầu.

Dùng --tools để chọn công cụ xuất hiện trong phiên CLI. --allowedTools cho phép lời gọi trong chính sách quyền, không có nghĩa tự loại mọi công cụ ngoài danh sách. Mẫu chỉ đọc sau giúp thấy rõ hai lớp đó.

# Terminal tại bản sao dự án:
claude -p "Tìm tệp liên quan duyệt BGST, nêu bằng chứng"   --tools "Read,Glob,Grep" --allowedTools "Read,Glob,Grep"   --permission-mode dontAsk --max-turns 4

Kiểm tra đã làm được: Có danh sách tệp hoặc báo không tìm thấy; agent không có công cụ sửa trong danh sách built-in đã chọn.

Custom tool (công cụ tự xây) nên có tên, mô tả, schema và hàm xử lý rõ ràng. Agent SDK có helper để đăng ký tool qua MCP server trong cùng tiến trình. Mã xử lý phải kiểm quyền, dữ liệu và lỗi của chính nó, không tin mọi đầu vào vì được AI sinh ra.

MCP discovery (khám phá khả năng máy chủ) giúp client biết server cung cấp tools, resources và prompts nào. Tool search có thể trì hoãn việc nạp mô tả đầy đủ cho đến khi cần. Đây là cách quản lý khả năng và ngữ cảnh, không phải quá trình cấp thêm quyền.

Quan sát máy chủ thật trước khi yêu cầu agent chọn tool. Dùng tên từ danh sách đã phát hiện và xem schema để hiểu đầu vào. Không gọi tool ghi chỉ để chứng minh kết nối hoạt động.

# Terminal:
claude mcp list
# Trong Claude Code:
/mcp
# Yêu cầu:
Tìm công cụ chỉ đọc liên quan trạng thái đơn trên server thử.
Nêu tên đầy đủ, đầu vào và điều kiện quyền.
Chưa gọi công cụ. Nếu không tìm thấy, nói rõ server
và khả năng đã kiểm tra; không tự đặt tên tool mới.

Kiểm tra đã làm được: Tên và schema đối chiếu được với /mcp; kết quả thiếu kết nối hoặc thiếu tool được báo đúng thực tế.