{/* Trang này được tạo tự động từ SKILL.md của kỹ năng bởi website/scripts/generate-skill-docs.py. Chỉnh sửa nguồn SKILL.md, không phải trang này. */}

Mã Claude

Ủy quyền mã hóa cho Claude Code CLI (tính năng, PR).

Siêu dữ liệu kỹ năng

Nguồn	Đi kèm (được cài đặt theo mặc định)
Đường dẫn

skills/autonomous-ai-agents/Claude-code ` | | Phiên bản |

2.2.0 ` | | Tác giả | Đại lý Hermes + Teknium | | Giấy phép | MIT | | Nền tảng | Linux, macOS, Windows | | Thẻ |

Coding-Agent

, `Claude

, `Anthropic

, `Code-Review

, `Refactoring

, `PTY

, Automation | | Kỹ năng liên quan | XPROTECTX42XPROTECTX, XPROTECTX43XPROTECTX, XPROTECTX44XPROTECTX |

Tham khảo: đầy đủ SKILL.md

thông tin

Sau đây là định nghĩa kỹ năng đầy đủ mà Hermes tải khi kỹ năng này được kích hoạt. Đây là những gì tác nhân coi là hướng dẫn khi kỹ năng được kích hoạt.

Mã Claude — Hướng dẫn phối hợp của Hermes

Giao nhiệm vụ mã hóa cho Claude Code (tác nhân mã hóa tự động CLI của Anthropic) thông qua terminal Hermes. Claude Code v2.x có thể đọc tệp, viết mã, chạy lệnh shell, tạo ra các tác nhân phụ và quản lý quy trình công việc git một cách tự động.

Điều kiện tiên quyết

• Cài đặt: `npm install -g @Anthropic-ai/Claude-code

• Auth: chạy Claude một lần để đăng nhập (trình duyệt OAuth cho Pro/Max hoặc đặt `Anthropic_API_KEY

)

• Xác thực bảng điều khiển: Claude auth login --console để thanh toán khóa API
• Xác thực SSO: Claude auth login --sso dành cho doanh nghiệp
• Kiểm tra trạng thái: Claude auth status (JSON) hoặc Claude auth status --text (con người có thể đọc được)
• Kiểm tra tình trạng: Claude doctor — kiểm tra tình trạng cài đặt và cập nhật tự động
• Kiểm tra phiên bản: Claude --version (yêu cầu v2.x+)
• Cập nhật: Claude update hoặc `Claude upgrade

Hai chế độ phối hợp

Hermes tương tác với Claude Code theo hai cách cơ bản khác nhau. Chọn dựa trên nhiệm vụ.

Chế độ 1: Chế độ in (

-p

) — Không tương tác (ƯU TIÊN cho hầu hết các tác vụ)

Chế độ in chạy tác vụ một lần, trả về kết quả và thoát. Không cần PTY. Không có lời nhắc tương tác. Đây là con đường hội nhập sạch sẽ nhất.

` terminal(command="Claude -p 'Add error handling to all API calls in src/' --allowedTools 'Read,Edit' --max-turns 10", workdir="/path/to/project", timeout=120)

` ``Khi nào nên sử dụng chế độ in:

• Nhiệm vụ mã hóa một lần (sửa lỗi, thêm tính năng, tái cấu trúc)
• Tự động hóa CI/CD và viết kịch bản
• Trích xuất dữ liệu có cấu trúc với

--JSON-schema

• Xử lý đầu vào theo đường ống ( `cat file | Claude -p "analyze this"

)

• Bất kỳ nhiệm vụ nào bạn không cần trò chuyện nhiều lượt`Chế độ in bỏ qua TẤT CẢ các hộp thoại tương tác — không có lời nhắc tin cậy về không gian làm việc, không có xác nhận quyền. Điều này làm cho nó lý tưởng cho việc tự động hóa.

Chế độ 2: PTY tương tác qua tmux — Phiên nhiều lượt

Chế độ tương tác cung cấp cho bạn REPL đàm thoại đầy đủ, nơi bạn có thể gửi lời nhắc tiếp theo, sử dụng lệnh gạch chéo và xem Claude làm việc trong thời gian thực. Yêu cầu phối hợp tmux.

`

Start a tmux session

terminal(command="tmux new-session -d -s Claude-work -x 140 -y 40")

Launch Claude Code inside it

terminal(command="tmux send-keys -t Claude-work 'cd /path/to/project && Claude' Enter")

Wait for startup, then send your task

(after ~3-5 seconds for the welcome screen)

terminal(command="sleep 5 && tmux send-keys -t Claude-work 'Refactor the auth module to use JWT tokens' Enter")

Monitor progress by capturing the pane

terminal(command="sleep 15 && tmux capture-pane -t Claude-work -p -S -50")

Send follow-up tasks

terminal(command="tmux send-keys -t Claude-work 'Now add unit tests for the new JWT code' Enter")

Exit when done

terminal(command="tmux send-keys -t Claude-work '/exit' Enter")

` ``Khi nào nên sử dụng chế độ tương tác:

• Công việc lặp đi lặp lại nhiều lượt (tái cấu trúc → xem xét → sửa lỗi → chu trình kiểm tra)
• Nhiệm vụ đòi hỏi phải có sự quyết định của con người trong vòng lặp
• Phiên mã hóa thăm dò
• Khi cần sử dụng lệnh gạch chéo của Claude (

/compact

,

/review

,

/model

)

Xử lý hộp thoại PTY (TIÊU CHUẨN cho Chế độ tương tác)

Claude Code hiển thị tối đa hai hộp thoại xác nhận trong lần khởi chạy đầu tiên. Bạn PHẢI xử lý những điều này thông qua các phím gửi tmux:

Hộp thoại 1: Workspace TRust (lần đầu truy cập vào một thư mục)

`

❯ 1. Yes, I tRust this folder ← DEFAULT (just press Enter) 2. No, exit

`

Xử lý: tmux send-keys -t <session Enter — lựa chọn mặc định là chính xác.

Hộp thoại 2: Cảnh báo bỏ qua quyền (chỉ với quyền --nguy hiểm-bỏ qua)

`

❯ 1. No, exit ← DEFAULT (WRONG choice!) 2. Yes, I accept

`

Xử lý: Phải điều hướng DOWN trước, sau đó Enter:

`

tmux send-keys -t <session Down && sleep 0.3 && tmux send-keys -t <session Enter

`

Mẫu xử lý hộp thoại mạnh mẽ

`

Launch with permissions bypass

terminal(command="tmux send-keys -t Claude-work 'Claude --dangerously-skip-permissions "your task"' Enter")

Handle tRust dialog (Enter for default "Yes")

terminal(command="sleep 4 && tmux send-keys -t Claude-work Enter")

Handle permissions dialog (Down then Enter for "Yes, I accept")

terminal(command="sleep 3 && tmux send-keys -t Claude-work Down && sleep 0.3 && tmux send-keys -t Claude-work Enter")

Now wait for Claude to work

terminal(command="sleep 15 && tmux capture-pane -t Claude-work -p -S -60")

` ``Lưu ý: Sau lần chấp nhận tin cậy đầu tiên cho một thư mục, hộp thoại tin cậy sẽ không xuất hiện nữa. Chỉ hộp thoại quyền tái diễn mỗi lần bạn sử dụng

--dangerously-skip-permissions

.

Lệnh phụ CLI| Tiểu ban | Mục đích |

|----------||---------| | Claude | Bắt đầu REPL tương tác | | Claude "query" | Bắt đầu REPL với lời nhắc ban đầu | | Claude -p "query" | Chế độ in (không tương tác, thoát khi hoàn tất) | | cat file \| Claude -p "query" | Nội dung ống dưới dạng bối cảnh stdin | | Claude -c | Tiếp tục cuộc trò chuyện gần đây nhất trong thư mục này | | Claude -r "id" | Tiếp tục một phiên cụ thể theo ID hoặc tên | | Claude auth login | Đăng nhập (thêm

--console ` để thanh toán API,

--sso cho Doanh nghiệp) | | Claude auth status ` | Kiểm tra trạng thái đăng nhập (trả về JSON;

--text để con người có thể đọc được) | | Claude MCP add <name -- <cmd | Thêm máy chủ MCP | | Claude MCP list | Liệt kê các máy chủ MCP được cấu hình | | Claude MCP remove <name | Xóa máy chủ MCP | | Claude agents | Liệt kê các tác nhân được cấu hình | | Claude doctor | Chạy kiểm tra tình trạng cài đặt và tự động cập nhật | | Claude update / Claude upgrade | Cập nhật Mã Claude lên phiên bản mới nhất | | Claude remote-control | Khởi động máy chủ để điều khiển Claude từ Claude.ai hoặc ứng dụng di động | | Claude install [target] | Cài đặt bản dựng gốc (phiên bản ổn định, mới nhất hoặc cụ thể) | | Claude setup-token | Thiết lập mã thông báo xác thực tồn tại lâu dài (yêu cầu đăng ký) | | Claude plugin / Claude plugins | Quản lý plugin Mã Claude | | Claude auto-mode ` | Kiểm tra cấu hình phân loại chế độ tự động |

Chế độ in Tìm hiểu sâu

Đầu ra JSON có cấu trúc

`

terminal(command="Claude -p 'Analyze auth.py for security issues' --output-format JSON --max-turns 5", workdir="/project", timeout=120)

` ``Trả về một đối tượng JSON với:

`

{
  "type": "result",
  "subtype": "success",
  "result": "The analysis text...",
  "session_id": "75e2167f-...",
  "num_turns": 3,
  "total_cost_usd": 0.0787,
  "duration_ms": 10276,
  "stop_reason": "end_turn",
  "terminal_reason": "completed",
  "usage": { "input_tokens": 5, "output_tokens": 603, ... },
  "modelUsage": { "Claude-sonnet-4-6": { "costUSD": 0.078, "contextWindow": 200000 } }
}

`
``**Các trường chính:** 
`session_id
` để tiếp tục, 
`num_turns
` để đếm vòng lặp tổng đài viên, 
`total_cost_usd
` để theo dõi chi tiêu, 
`subtype
` để phát hiện thành công/lỗi (
`success

, 
`error_max_turns

, 
`error_budget

).

### Truyền phát đầu ra JSON
Để phát trực tuyến mã thông báo theo thời gian thực, hãy sử dụng 
`stream-JSON
` với 

`
--verbose

:

`

terminal(command="Claude -p 'Write a summary' --output-format stream-JSON --verbose --include-partial-messages", timeout=60)

`
``Trả về các sự kiện JSON được phân cách bằng dòng mới. Lọc bằng jq cho văn bản trực tiếp:

`

Claude -p "Explain X" --output-format stream-JSON --verbose --include-partial-messages | \
  jq -rj 'select(.type == "stream_event" and .event.delta.type? == "text_delta") | .event.delta.text'

`
``Các sự kiện phát trực tiếp bao gồm 
`system/API_retry
` với các trường 
`attempt

, 
`max_retries
` và 
`error
` (ví dụ: 
`rate_limit

, 
`billing_error

).

### Truyền phát hai chiều
Để truyền phát đầu vào VÀ đầu ra theo thời gian thực:

`

Claude -p "task" --input-format stream-JSON --output-format stream-JSON --replay-user-messages

`

`
--replay-user-messages
` phát lại tin nhắn của người dùng trên thiết bị xuất chuẩn để xác nhận.

### Đầu vào theo đường ống

`

# pipe a file for analysis
terminal(command="cat src/auth.py | Claude -p 'Review this code for bugs' --max-turns 1", timeout=60)

# pipe multiple files
terminal(command="cat src/*.py | Claude -p 'Find all TODO comments' --max-turns 1", timeout=60)

# pipe command output
terminal(command="git diff HEAD~3 | Claude -p 'Summarize these changes' --max-turns 1", timeout=60)

`

### Lược đồ JSON để trích xuất có cấu trúc

`

terminal(command="Claude -p 'List all functions in src/' --output-format JSON --JSON-schema '\{\"type\":\"object\",\"properties\":\{\"functions\":\{\"type\":\"array\",\"items\":\{\"type\":\"string\"}}},\"required\":[\"functions\"]}' --max-turns 5", workdir="/project", timeout=90)

`
``Phân tích 
`structured_output
` từ kết quả JSON. Claude xác thực đầu ra dựa trên lược đồ trước khi quay lại.

### Tiếp tục phiên

`

# Start a task
terminal(command="Claude -p 'Start refactoring the database layer' --output-format JSON --max-turns 10 > /tmp/session.JSON", workdir="/project", timeout=180)

# Resume with session ID
terminal(command="Claude -p 'Continue and add connection pooling' --resume $(cat /tmp/session.JSON | Python3 -c 'import JSON,sys; print(JSON.load(sys.stdin)[\"session_id\"])') --max-turns 5", workdir="/project", timeout=120)

# Or resume the most recent session in the same directory
terminal(command="Claude -p 'What did you do last time?' --Continue --max-turns 1", workdir="/project", timeout=30)

# Fork a session (new ID, keeps history)
terminal(command="Claude -p 'Try a different approach' --resume <id --fork-session --max-turns 10", workdir="/project", timeout=120)

`

### Chế độ trần cho CI/Scripting

`

terminal(command="Claude --bare -p 'Run all tests and report failures' --allowedTools 'Read,Bash' --max-turns 10", workdir="/project", timeout=180)

`

--bare
` bỏ qua hook, plugin, khám phá MCP và tải Claude.md. Khởi động nhanh nhất. Yêu cầu 
`Anthropic_API_KEY
` (bỏ qua OAuth).

Để tải ngữ cảnh có chọn lọc ở chế độ trần:
| Để tải | Cờ |
|----------|------|
| Bổ sung nhắc nhở hệ thống |

--append-system-prompt "text"
` hoặc 

--append-system-prompt-file path
` |
| Cài đặt |

--settings <file-or-JSON
` |
| Máy chủ MCP |

--MCP-config <file-or-JSON
` |
| Đại lý tùy chỉnh |

--agents '<JSON'
` |

### Mô hình dự phòng cho tình trạng quá tải

`

terminal(command="Claude -p 'task' --fallback-model haiku --max-turns 5", timeout=90)

`

Tự động quay trở lại kiểu máy đã chỉ định khi mặc định bị quá tải (chỉ ở chế độ in).

## Hoàn thành tham chiếu cờ CLI

### Phiên & Môi trường
| Cờ | Hiệu ứng |
|------|--------|
| 

-p, --print
` | Chế độ chụp một lần không tương tác (thoát khi hoàn tất) |
| 

-c, --Continue
` | Tiếp tục cuộc trò chuyện gần đây nhất trong thư mục hiện tại |
| 

-r, --resume <id
` | Tiếp tục phiên cụ thể theo ID hoặc tên (bộ chọn tương tác nếu không có ID) |
| 

--fork-session
` | Khi tiếp tục, hãy tạo ID phiên mới thay vì sử dụng lại |
| 

--session-id <uuid
` | Sử dụng UUID cụ thể cho cuộc trò chuyện |
| 

--no-session-persistence
` | Không lưu phiên vào đĩa (chỉ ở chế độ in) |
| 

--add-dir <paths...
` | Cấp cho Claude quyền truy cập vào các thư mục làm việc bổ sung |
| 

-w, --worktree [name]
` | Chạy trong cây công việc git biệt lập tại 

.Claude/worktrees/<name
` |
| 

--tmux
` | Tạo phiên tmux cho cây làm việc (yêu cầu 

--worktree

) |
| 

--ide
` | Tự động kết nối với IDE hợp lệ khi khởi động |
| 

--chrome
` / 

--no-chrome
` | Bật/tắt tích hợp trình duyệt Chrome để kiểm tra web |
| 

--from-pr [number]
` | Tiếp tục phiên được liên kết với một GitHub PR cụ thể |
| 

--file <specs...
` | Tài nguyên tệp cần tải xuống khi khởi động (định dạng: 
`file_id:relative_path

) |### Kiểu dáng & Hiệu suất
| Cờ | Hiệu ứng |
|------|--------|
| 

--model <alias
` | Lựa chọn model: 
`sonnet

, 
`opus

, 
`haiku
` hoặc tên đầy đủ như 
`Claude-sonnet-4-6
` |
| 

--effort <level
` | Độ sâu lý luận: 
`low

, 
`medium

, 
`high

, 
`max

, 
`auto
` | Cả hai |
| 

--max-turns <n
` | Hạn chế các vòng lặp tác nhân (chỉ ở chế độ in; ngăn chặn sự chạy trốn) |
| 

--max-budget-usd <n
` | Chi tiêu API giới hạn bằng đô la (chỉ ở chế độ in) |
| 

--fallback-model <model
` | Tự động dự phòng khi mô hình mặc định bị quá tải (chỉ ở chế độ in) |
| 

--betas <betas...
` | Tiêu đề beta để đưa vào yêu cầu API (chỉ dành cho người dùng khóa API) |

### Giấy phép & An toàn
| Cờ | Hiệu ứng |
|------|--------|
| 

--dangerously-skip-permissions
` | Tự động phê duyệt TẤT CẢ việc sử dụng công cụ (ghi tệp, bash, mạng, v.v.) |
| 

--allow-dangerously-skip-permissions
` | Bật bỏ qua dưới dạng *tùy chọn* mà không bật tính năng này theo mặc định |
| 

--permission-mode <mode
` | 
`default

, 
`acceptEdits

, 
`plan

, 
`auto

, 
`dontAsk

, 
`bypassPermissions
` |
| 

--allowedTools <tools...
` | Các công cụ cụ thể trong danh sách trắng (được phân tách bằng dấu phẩy hoặc dấu cách) |
| 

--disallowedTools <tools...
` | Danh sách đen các công cụ cụ thể |
| 

--tools <tools...
` | Ghi đè bộ công cụ tích hợp (

""
` = không có, 

"default"
` = tất cả hoặc tên công cụ) |

### Định dạng đầu ra và đầu vào
| Cờ | Hiệu ứng |
|------|--------|
| 

--output-format <fmt
` | 
``` text
` (mặc định), 
`JSON
` (đối tượng kết quả duy nhất), 
`stream-JSON
` (được phân cách bằng dòng mới) |
| 

`
--input-format <fmt
` | 
``` text
` (mặc định) hoặc 
`stream-JSON
` (đầu vào phát trực tuyến thời gian thực) |
| 

`
--JSON-schema <schema
` | Buộc đầu ra JSON có cấu trúc khớp với một lược đồ |
| 

--verbose
` | Đầu ra đầy đủ theo từng chặng |
| 

--include-partial-messages
` | Bao gồm các đoạn thông báo một phần khi chúng đến (stream-JSON + print) |
| 

--replay-user-messages
` | Phát lại tin nhắn của người dùng trên thiết bị xuất chuẩn (stream-JSON hai chiều) |

### Lời nhắc và bối cảnh hệ thống
| Cờ | Hiệu ứng |
|------|--------|
| 

--append-system-prompt <text
` | **Thêm** vào lời nhắc hệ thống mặc định (giữ nguyên các khả năng tích hợp sẵn) |
| 

--append-system-prompt-file <path
` | **Thêm** nội dung tệp vào dấu nhắc hệ thống mặc định |
| 

--system-prompt <text
` | **Thay thế** toàn bộ lời nhắc hệ thống (thường sử dụng --append) |
| 

--system-prompt-file <path
` | **Thay thế** lời nhắc hệ thống bằng nội dung tệp |
| 

--bare
` | Bỏ qua hook, plugin, khám phá MCP, Claude.md, OAuth (khởi động nhanh nhất) |
| 

--agents '<JSON'
` | Xác định các tác nhân phụ tùy chỉnh một cách linh hoạt dưới dạng JSON |
| 

--MCP-config <path
` | Tải máy chủ MCP từ tệp JSON (có thể lặp lại) |
| 

--strict-MCP-config
` | Chỉ sử dụng máy chủ MCP từ 

--MCP-config

, bỏ qua tất cả các cấu hình MCP khác |
| 

--settings <file-or-JSON
` | Tải cài đặt bổ sung từ tệp JSON hoặc JSON nội tuyến |
| 

--setting-sources <sources
` | Các nguồn được phân tách bằng dấu phẩy để tải: 
`user

, 
`project

, 
`local
` |
| 

--plugin-dir <paths...
` | Chỉ tải plugin từ các thư mục cho phiên này |
| 

--disable-slash-commands
` | Vô hiệu hóa tất cả các kỹ năng/lệnh gạch chéo |

### Gỡ lỗi
| Cờ | Hiệu ứng |
|------|--------|
| 

-d, --debug [filter]
` | Bật ghi nhật ký gỡ lỗi bằng bộ lọc danh mục tùy chọn (ví dụ: 

"API,hooks"

, 

"!1p,!file"

) |
| 

--debug-file <path
` | Ghi nhật ký gỡ lỗi vào tệp (ngầm kích hoạt chế độ gỡ lỗi) |

### Nhóm đại lý
| Cờ | Hiệu ứng |
|------|--------|
| 

--teammate-mode <mode
` | Cách các nhóm đại lý hiển thị: 
`auto

, 
`in-process
` hoặc 
`tmux
` |
| 

--brief
` | Kích hoạt công cụ 
`SendUserMessage
` để liên lạc giữa tác nhân với người dùng |

### Cú pháp tên công cụ cho --allowedTools / --disallowedTools

`

Read                    # All file reading
Edit                    # File editing (existing files)
Write                   # File creation (new files)
Bash                    # All shell commands
Bash(git *)             # Only git commands
Bash(git commit *)      # Only git commit commands
Bash(npm run lint:*)    # Pattern matching with wildcards
WebSearch               # Web search capability
WebFetch                # Web page fetching
MCP__<server__<tool   # Specific MCP tool

`

## Cài đặt & Cấu hình

### Phân cấp cài đặt (ưu tiên cao nhất đến thấp nhất)
1. **Cờ CLI** — ghi đè mọi thứ
2. **Dự án địa phương:** 

.Claude/settings.local.JSON
` (cá nhân, gitignored)
3. **Dự án:** 

.Claude/settings.JSON
` (được chia sẻ, theo dõi git)
4. **Người dùng:** 

~/.Claude/settings.JSON
` (toàn cầu)

### Quyền trong Cài đặt

`
``` json
{
  "permissions": {
    "allow": ["Bash(npm run lint:*)", "WebSearch", "Read"],
    "ask": ["Write(*.ts)", "Bash(git push*)"],
    "deny": ["Read(.env)", "Bash(rm -rf *)"]
  }
}

`

### Tệp bộ nhớ (Claude.md)

1. **Toàn cầu:** 

~/.Claude/Claude.md
` — áp dụng cho tất cả các dự án
2. **Dự án:** 

./Claude.md
` — bối cảnh dành riêng cho dự án (theo dõi git)
3. **Địa phương:** 

.Claude/Claude.local.md
` — ghi đè dự án cá nhân (gitignored)

Sử dụng tiền tố 

#
` ở chế độ tương tác để nhanh chóng thêm vào bộ nhớ: 

# Always use 2-space indentation

.## Phiên tương tác: Lệnh gạch chéo

### Phiên & bối cảnh
| Lệnh | Mục đích |
|----------|----------|
| 

/help
` | Hiển thị tất cả các lệnh (bao gồm các lệnh tùy chỉnh và MCP) |
| 

/compact [focus]
` | Nén ngữ cảnh để lưu mã thông báo; Claude.md vẫn tồn tại sau quá trình nén. Ví dụ: 

/compact focus on auth logic
` |
| 

/clear
` | Xóa lịch sử hội thoại để bắt đầu lại |
| 

/context
` | Trực quan hóa việc sử dụng ngữ cảnh dưới dạng lưới màu với các mẹo tối ưu hóa |
| 

/cost
` | Xem mức sử dụng mã thông báo với thông tin chi tiết về từng mô hình và lần truy cập bộ đệm |
| 

/resume
` | Chuyển sang hoặc tiếp tục một phiên khác |
| 

/rewind
` | Hoàn nguyên về điểm kiểm tra trước đó trong cuộc trò chuyện hoặc mã |
| 

/btw <question
` | Đặt một câu hỏi phụ mà không cần thêm chi phí ngữ cảnh |
| 

/status
` | Hiển thị phiên bản, kết nối và thông tin phiên |
| 

/todos
` | Liệt kê các mục hành động được theo dõi từ cuộc trò chuyện |
| 

/exit
` hoặc 
`Ctrl+D
` | Kết thúc phiên |

### Phát triển & Đánh giá
| Lệnh | Mục đích |
|----------|----------|
| 

/review
` | Yêu cầu xem xét mã của những thay đổi hiện tại |
| 

/security-review
` | Thực hiện phân tích bảo mật các thay đổi hiện tại |
| 

/plan [description]
` | Vào chế độ Kế hoạch với tính năng tự động bắt đầu để lập kế hoạch nhiệm vụ |
| 

/loop [interval]
` | Lên lịch các nhiệm vụ định kỳ trong phiên |
| 

/batch
` | Tự động tạo cây công việc cho những thay đổi song song lớn (5-30 cây công việc) |

### Cấu hình & Công cụ
| Lệnh | Mục đích |
|----------|----------|
| 

/model [model]
` | Chuyển đổi mô hình giữa phiên (sử dụng phím mũi tên để điều chỉnh nỗ lực) |
| 

/effort [level]
` | Đặt nỗ lực suy luận: 
`low

, 
`medium

, 
`high

, 
`max
` hoặc 
`auto
` |
| 

/init
` | Tạo tệp Claude.md cho bộ nhớ dự án |
| 

/memory
` | Mở Claude.md để chỉnh sửa |
| 

/config
` | Mở cấu hình cài đặt tương tác |
| 

/permissions
` | Xem/cập nhật quyền của công cụ |
| 

/agents
` | Quản lý các đại lý phụ chuyên trách |
| 

/MCP
` | Giao diện người dùng tương tác để quản lý máy chủ MCP |
| 

/add-dir
` | Thêm các thư mục làm việc bổ sung (hữu ích cho monorepos) |
| 

/usage
` | Hiển thị giới hạn gói và trạng thái giới hạn tỷ lệ |
| 

/voice
` | Bật chế độ giọng nói nhấn để nói (20 ngôn ngữ; giữ Space để ghi, nhả để gửi) |
| 

/release-notes
` | Bộ chọn tương tác cho ghi chú phát hành phiên bản |

### Lệnh gạch chéo tùy chỉnh
Tạo 

.Claude/commands/<name.md
` (dự án chia sẻ) hoặc 

~/.Claude/commands/<name.md
` (cá nhân):

`markdown
# .Claude/commands/deploy.md
Run the deploy pipeline:
1. Run all tests
2. Build the Docker image
3. Push to registry
4. Update the $ARGUMENTS environment (default: staging)

`
``Cách sử dụng: 

/deploy production
` — 

$ARGUMENTS
` được thay thế bằng đầu vào của người dùng.

### Kỹ năng (Kêu gọi ngôn ngữ tự nhiên)
Không giống như các lệnh gạch chéo (được gọi thủ công), các kỹ năng trong 

.Claude/skills/
` là các hướng dẫn đánh dấu mà Claude tự động gọi ra thông qua ngôn ngữ tự nhiên khi nhiệm vụ phù hợp:

`markdown
# .Claude/skills/database-migration.md
When asked to create or modify database migrations:
1. Use Alembic for migration generation
2. Always create a rollback function
3. Test migrations against a local database copy

`

## Phiên tương tác: Phím tắt

### Kiểm soát chung
| Chìa khóa | Hành động |
|------|--------|
| 
`Ctrl+C
` | Hủy đầu vào hoặc thế hệ hiện tại |
| 
`Ctrl+D
` | Thoát phiên |
| 
`Ctrl+R
` | Lịch sử lệnh tìm kiếm ngược |
| 
`Ctrl+B
` | Làm nền cho một tác vụ đang chạy |
| 
`Ctrl+V
` | Dán hình ảnh vào cuộc trò chuyện |
| 
`Ctrl+O
` | Chế độ ghi chép - xem quá trình tư duy của Claude |
| 
`Ctrl+G
` hoặc 
`Ctrl+X Ctrl+E
` | Mở lời nhắc trong trình chỉnh sửa bên ngoài |
| 
`Esc Esc
` | Tua lại cuộc trò chuyện hoặc trạng thái mã/tóm tắt |

### Chuyển đổi chế độ
| Chìa khóa | Hành động |
|------|--------|
| 
`Shift+Tab
` | Chế độ cấp phép chu kỳ (Bình thường → Tự động chấp nhận → Kế hoạch) |
| 
`Alt+P
` | Chuyển đổi mô hình |
| 
`Alt+T
` | Chuyển đổi chế độ tư duy |
| 
`Alt+O
` | Chuyển đổi chế độ nhanh |

### Đầu vào nhiều dòng
| Chìa khóa | Hành động |
|------|--------|
| 

\

 + 
`Enter
` | Dòng mới nhanh |
| 
`Shift+Enter
` | Dòng mới (thay thế) |
| 
`Ctrl+J
` | Dòng mới (thay thế) |

### Tiền tố đầu vào
| Tiền tố | Hành động |
|--------|--------|
| 

!
` | Thực thi bash trực tiếp, bỏ qua AI (ví dụ: 

!npm test

). Chỉ sử dụng 

!
` để chuyển đổi chế độ shell. |
| 

@
` | Các tệp/thư mục tham chiếu có tính năng tự động hoàn thành (ví dụ: 

@./src/API/

) |
| 

#
` | Thêm nhanh vào bộ nhớ Claude.md (ví dụ: 

# Use 2-space indentation

) |
| 

/
` | Lệnh gạch chéo |### Mẹo chuyên nghiệp: "siêu suy nghĩ"
Sử dụng từ khóa "siêu suy nghĩ" trong lời nhắc của bạn để có nỗ lực lý luận tối đa trong một lượt cụ thể. Điều này kích hoạt chế độ suy nghĩ sâu nhất bất kể cài đặt 

/effort
` hiện tại.

## Mẫu đánh giá PR

### Xem lại nhanh (Chế độ in)

`

terminal(command="cd /path/to/repo && git diff main...feature-branch | Claude -p 'Review this diff for bugs, security issues, and style problems. Be thorough.' --max-turns 1", timeout=60)

`

### Đánh giá sâu (Tương tác + Worktree)

`

terminal(command="tmux new-session -d -s review -x 140 -y 40")
terminal(command="tmux send-keys -t review 'cd /path/to/repo && Claude -w pr-review' Enter")
terminal(command="sleep 5 && tmux send-keys -t review Enter")  # TRust dialog
terminal(command="sleep 2 && tmux send-keys -t review 'Review all changes vs main. Check for bugs, security issues, race conditions, and missing tests.' Enter")
terminal(command="sleep 30 && tmux capture-pane -t review -p -S -60")

`

### Đánh giá PR từ Number

`

terminal(command="Claude -p 'Review this PR thoroughly' --from-pr 42 --max-turns 10", workdir="/path/to/repo", timeout=120)

`

### Claude Worktree với tmux

`

terminal(command="Claude -w feature-x --tmux", workdir="/path/to/repo")

`

Tạo một cây công việc git biệt lập tại 

.Claude/worktrees/feature-x
` VÀ một phiên tmux cho nó. Sử dụng các khung gốc iTerm2 khi có sẵn; thêm 

--tmux=classic
` cho tmux truyền thống.

## Phiên bản Claude song song

Chạy đồng thời nhiều tác vụ Claude độc lập:

`
# Task 1: Fix backend
terminal(command="tmux new-session -d -s task1 -x 140 -y 40 && tmux send-keys -t task1 'cd ~/project && Claude -p \"Fix the auth bug in src/auth.py\" --allowedTools \"Read,Edit\" --max-turns 10' Enter")

# Task 2: Write tests
terminal(command="tmux new-session -d -s task2 -x 140 -y 40 && tmux send-keys -t task2 'cd ~/project && Claude -p \"Write integration tests for the API endpoints\" --allowedTools \"Read,Write,Bash\" --max-turns 15' Enter")

# Task 3: Update docs
terminal(command="tmux new-session -d -s task3 -x 140 -y 40 && tmux send-keys -t task3 'cd ~/project && Claude -p \"Update README.md with the new API endpoints\" --allowedTools \"Read,Edit\" --max-turns 5' Enter")

# Monitor all
terminal(command="sleep 30 && for s in task1 task2 task3; do echo '=== '$s' ==='; tmux capture-pane -t $s -p -S -5 2>/dev/null; done")

`

## Claude.md — Tệp ngữ cảnh dự án

Mã Claude tự động tải 
`Claude.md
` từ thư mục gốc của dự án. Sử dụng nó để duy trì bối cảnh dự án:

`markdown
# Project: My API

## Architecture
- FastAPI backend with SQLAlchemy ORM
- PostgreSQL database, Redis cache
- pytest for testing with 90% coverage target

## Key Commands
- 
`make test
` — run full test suite
- 
`make lint
` — ruff + mypy
- 
`make dev
` — start dev server on :8000

## Code Standards
- Type hints on all public functions
- Docstrings in Google style
- 2-space indentation for YAML, 4-space for Python
- No wildcard imports

`
``**Hãy cụ thể.** Thay vì "Viết mã tốt", hãy sử dụng "Sử dụng thụt lề 2 dấu cách cho JS" hoặc "Đặt tên tệp kiểm tra có hậu tố 

.test.ts

." Hướng dẫn cụ thể lưu chu kỳ hiệu chỉnh.

### Thư mục quy tắc (Mô-đun Claude.md)
Đối với các dự án có nhiều quy tắc, hãy sử dụng thư mục quy tắc thay vì một Claude.md lớn:
- **Quy tắc dự án:** 

.Claude/rules/*.md
` — được chia sẻ theo nhóm, được theo dõi bằng git
- **Quy tắc người dùng:** 

~/.Claude/rules/*.md
` — cá nhân, toàn cầu

Mỗi tệp 

.md
` trong thư mục quy tắc được tải dưới dạng ngữ cảnh bổ sung. Điều này sạch hơn việc nhồi nhét mọi thứ vào một Claude.md duy nhất.

### Bộ nhớ tự động
Claude tự động lưu trữ bối cảnh dự án đã học trong 

~/.Claude/projects/<project/memory/

.
- **Giới hạn:** 25KB hoặc 200 dòng cho mỗi dự án
- Điều này khác với Claude.md — đây là ghi chú của chính Claude về dự án, được tích lũy qua các phiên

## Đại lý phụ tùy chỉnh

Xác định các tác nhân chuyên biệt trong 

.Claude/agents/
` (dự án), 

~/.Claude/agents/
` (cá nhân) hoặc thông qua cờ 

--agents
` CLI (phiên):

### Ưu tiên vị trí đại lý
1. 

.Claude/agents/
` — cấp dự án, chia sẻ nhóm
2. Cờ 

--agents
` CLI - dành riêng cho phiên, động
3. 

~/.Claude/agents/
` — cấp độ người dùng, cá nhân

### Tạo đại lý

`
`markdown
# .Claude/agents/security-reviewer.md
---
name: security-reviewer
description: Security-focused code review
model: opus
tools: [Read, Bash]
---
You are a senior security engineer. Review code for:
- Injection vulnerabilities (SQL, XSS, command injection)
- Authentication/authorization flaws
- Secrets in code
- Unsafe deserialization

`
``Gọi qua: 

@security-reviewer review the auth module

### Đại lý động thông qua CLI

`

terminal(command="Claude --agents '\{\"reviewer\": \{\"description\": \"Reviews code\", \"prompt\": \"You are a code reviewer focused on performance\"}}' -p 'Use @reviewer to check auth.py'", timeout=120)

`
``Claude có thể điều phối nhiều tác nhân: "Sử dụng @db-expert để tối ưu hóa các truy vấn, sau đó sử dụng @security để kiểm tra các thay đổi."

## Hooks — Tự động hóa sự kiện

Định cấu hình trong 

.Claude/settings.JSON
` (dự án) hoặc 

~/.Claude/settings.JSON
` (toàn cầu):

``` json
{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write(*.py)",
      "hooks": [\{"type": "command", "command": "ruff check --fix $Claude_FILE_PATHS"}]
    }],
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [\{"type": "command", "command": "if echo \"$Claude_TOOL_INPUT\" | grep -q 'rm -rf'; then echo 'Blocked!' && exit 2; fi"}]
    }],
    "Stop": [{
      "hooks": [\{"type": "command", "command": "echo 'Claude finished a response' >> /tmp/Claude-activity.log"}]
    }]
  }
}

`
``###Tất cả 8 loại móc
| Móc | Khi nó cháy | Sử dụng phổ biến |
|------|--------------|-------------|
| 
`UserPromptSubmit
` | Trước khi Claude xử lý lời nhắc của người dùng | Xác thực đầu vào, ghi nhật ký |
| 
`PreToolUse
` | Trước khi thực hiện công cụ | Cổng an ninh, chặn lệnh nguy hiểm (lối ra 2=chặn) |
| 
`PostToolUse
` | Sau khi một công cụ kết thúc | Tự động định dạng mã, chạy linters |
| 
`Notification
` | Về yêu cầu cấp phép hoặc chờ đầu vào | Thông báo, cảnh báo trên màn hình |
| 
`Stop
` | Khi Claude trả lời xong | Hoàn thành ghi nhật ký, cập nhật trạng thái |
| 
`SubagentStop
` | Khi một tác nhân phụ hoàn thành | Điều phối đại lý |
| 
`PreCompact
` | Trước khi bộ nhớ ngữ cảnh bị xóa | Sao lưu bảng điểm phiên |
| 
`SessionStart
` | Khi một phiên bắt đầu | Tải bối cảnh nhà phát triển (ví dụ: 
`git status

) |

### Biến môi trường hook
| Biến | Nội dung |
|----------|----------|
| 
`Claude_PROJECT_DIR
` | Lộ trình dự án hiện tại |
| 
`Claude_FILE_PATHS
` | Tập tin đang được sửa đổi |
| 
`Claude_TOOL_INPUT
` | Tham số công cụ dưới dạng JSON |

### Ví dụ về móc bảo mật

`
`JSON
{
  "PreToolUse": [{
    "matcher": "Bash",
    "hooks": [\{"type": "command", "command": "if echo \"$Claude_TOOL_INPUT\" | grep -qE 'rm -rf|git push.*--force|:(){ :|:& };:'; then echo 'Dangerous command blocked!' && exit 2; fi"}]
  }]
}

`

## Tích hợp MCP

Thêm máy chủ công cụ bên ngoài cho cơ sở dữ liệu, API và dịch vụ:

`

# GitHub integration
terminal(command="Claude MCP add -s user GitHub -- npx @modelcontextprotocol/server-GitHub", timeout=30)

# PostgreSQL queries
terminal(command="Claude MCP add -s local postgres -- npx @Anthropic-ai/server-postgres --connection-string PostgreSQL://localhost/mydb", timeout=30)

# Puppeteer for web testing
terminal(command="Claude MCP add puppeteer -- npx @Anthropic-ai/server-puppeteer", timeout=30)

`

### Phạm vi MCP
| Cờ | Phạm vi | Lưu trữ |
|------|-------|---------|
| 

-s user
` | Toàn cầu (tất cả các dự án) |

~/.Claude.JSON
` |
| 

-s local
` | Dự án này (cá nhân) |

.Claude/settings.local.JSON
` (đã bỏ qua) |
| 

-s project
` | Dự án này (nhóm chia sẻ) |

.Claude/settings.JSON
` (theo dõi git) |

### MCP ở Chế độ In/CI

`

terminal(command="Claude --bare -p 'Query database' --MCP-config MCP-servers.JSON --strict-MCP-config", timeout=60)

`

`
--strict-MCP-config
` bỏ qua tất cả các máy chủ MCP ngoại trừ các máy chủ từ 

--MCP-config

.

Tài nguyên MCP tham khảo trong trò chuyện: 

@GitHub:issue://123

### Giới hạn & Điều chỉnh MCP
- **Mô tả công cụ:** Giới hạn 2KB trên mỗi máy chủ dành cho mô tả công cụ và hướng dẫn máy chủ
- **Kích thước kết quả:** Giới hạn mặc định; sử dụng chú thích 
`maxResultSizeChars
` để cho phép tối đa **500K** ký tự cho đầu ra lớn
- **Mã thông báo đầu ra:** 
`export MAX_MCP_OUTPUT_TOKENS=50000
` — giới hạn đầu ra từ máy chủ MCP để ngăn chặn tình trạng tràn bối cảnh
- **Vận chuyển:** 
`stdio
` (quy trình cục bộ), 
`http
` (từ xa), 
`sse
` (sự kiện do máy chủ gửi)

## Giám sát các phiên tương tác

### Đọc trạng thái TUI

`

# Periodic capture to check if Claude is still working or waiting for input
terminal(command="tmux capture-pane -t dev -p -S -10")

`
``Hãy tìm những chỉ số sau:
- 

❯
` ở dưới = chờ bạn nhập liệu (Claude làm xong hoặc đang đặt câu hỏi)
- Dòng 

●
` = Claude đang tích cực sử dụng các công cụ (đọc, viết, chạy lệnh)
- 

⏵⏵ bypass permissions on
` = thanh trạng thái hiển thị chế độ cấp phép
- 

◐ medium · /effort
` = mức nỗ lực hiện tại trên thanh trạng thái
- 
`ctrl+o to expand
` = đầu ra công cụ bị cắt bớt (có thể mở rộng tương tác)

### Tình trạng cửa sổ ngữ cảnh
Sử dụng 

/context
` ở chế độ tương tác để xem lưới màu sử dụng ngữ cảnh. Ngưỡng chính:
- **< 70%** — Hoạt động bình thường, độ chính xác hoàn toàn
- **70-85%** — Độ chính xác bắt đầu giảm, hãy xem xét 

/compact

- **> 85%** — Nguy cơ ảo giác tăng đột biến đáng kể, hãy sử dụng 

/compact
` hoặc 

/clear

## Biến môi trường

| Biến | Hiệu ứng |
|----------|--------|
| 
`Anthropic_API_KEY
` | Khóa API để xác thực (thay thế cho OAuth) |
| 
`Claude_CODE_EFFORT_LEVEL
` | Nỗ lực mặc định: 
`low

, 
`medium

, 
`high

, 
`max
` hoặc 
`auto
` |
| 
`MAX_THINKING_TOKENS
` | Giới hạn mã thông báo tư duy (được đặt thành 
`0
` để tắt hoàn toàn tư duy) |
| 
`MAX_MCP_OUTPUT_TOKENS
` | Đầu ra giới hạn từ máy chủ MCP (mặc định thay đổi; đặt ví dụ: 
`50000

) |
| 
`Claude_CODE_NO_FLICKER=1
` | Bật hiển thị màn hình thay thế để loại bỏ hiện tượng nhấp nháy của terminal |
| 
`Claude_CODE_SUBPROCESS_ENV_SCRUB
` | Loại bỏ thông tin xác thực khỏi các quy trình phụ để bảo mật |

## Mẹo về chi phí & hiệu suất
1. **Sử dụng 

--max-turns

** ở chế độ in để tránh lặp lại. Bắt đầu với 5-10 cho hầu hết các nhiệm vụ.
2. **Sử dụng 

--max-budget-usd

** để biết giới hạn chi phí. Lưu ý: tối thiểu ~$0,05 để tạo bộ nhớ đệm theo lời nhắc của hệ thống.
3. **Sử dụng 

--effort low

** cho các tác vụ đơn giản (nhanh hơn, rẻ hơn). 
`high
` hoặc 
`max
` cho lý luận phức tạp.
4. **Sử dụng 

--bare

** cho CI/tập lệnh để bỏ qua chi phí khám phá plugin/hook.
5. **Sử dụng 

--allowedTools

** để chỉ giới hạn những gì cần thiết (ví dụ: chỉ 
`Read
` để đánh giá).
6. **Sử dụng 

/compact

** trong các phiên tương tác khi ngữ cảnh trở nên lớn.
7. **Đầu vào ống** thay vì yêu cầu Claude đọc tệp khi bạn chỉ cần phân tích nội dung đã biết.
8. **Sử dụng 

--model haiku

** cho các tác vụ đơn giản (rẻ hơn) và 

--model opus
` cho công việc nhiều bước phức tạp.
9. **Sử dụng 

--fallback-model haiku

** ở chế độ in để xử lý tình trạng quá tải mô hình một cách linh hoạt.
10. **Bắt đầu các phiên mới cho các nhiệm vụ riêng biệt** — các phiên kéo dài 5 giờ; bối cảnh mới sẽ hiệu quả hơn.
11. **Sử dụng 

--no-session-persistence

** trong CI để tránh tích lũy các phiên đã lưu trên đĩa.

## Cạm bẫy & vấn đề1. **Chế độ tương tác YÊU CẦU tmux** — Claude Code là một ứng dụng TUI đầy đủ. Chỉ sử dụng 
`pty=true
` trong terminal Hermes sẽ hoạt động nhưng tmux cung cấp cho bạn 
`capture-pane
` để giám sát và 
`send-keys
` cho đầu vào, điều này rất cần thiết cho việc điều phối.
2. **Hộp thoại 

--dangerously-skip-permissions
` mặc định là "Không, thoát"** — bạn phải gửi Xuống rồi nhấn Enter để chấp nhận. Chế độ in (

-p

) hoàn toàn bỏ qua điều này.
3. **

--max-budget-usd
` tối thiểu là ~$0,05** — chỉ riêng việc tạo bộ đệm nhắc nhở hệ thống đã tốn nhiều tiền như vậy. Đặt thấp hơn sẽ báo lỗi ngay lập tức.
4. **

--max-turns
` chỉ ở chế độ in** — bị bỏ qua trong các phiên tương tác.
5. **Claude có thể sử dụng 
``` python
` thay vì 
`Python3

`
** — trên các hệ thống không có liên kết tượng trưng 
``` python

, các lệnh bash của Claude sẽ thất bại trong lần thử đầu tiên nhưng nó sẽ tự sửa.

6. **Việc nối lại phiên yêu cầu cùng một thư mục** — 

--Continue
` tìm phiên gần đây nhất cho thư mục làm việc hiện tại.
7. **

--JSON-schema
` cần đủ 

--max-turns

** — Claude phải đọc tệp trước khi tạo đầu ra có cấu trúc, quá trình này mất nhiều lượt.
8. **Hộp thoại tin cậy chỉ xuất hiện một lần cho mỗi thư mục** — chỉ lần đầu tiên, sau đó được lưu vào bộ nhớ đệm.
9. **Phiên tmux trong nền vẫn tồn tại** — luôn dọn sạch bằng 
`tmux kill-session -t <name
` khi hoàn tất.
10. **Các lệnh gạch chéo (như 

/commit

) chỉ hoạt động ở chế độ tương tác** — ở chế độ 

-p

, thay vào đó hãy mô tả tác vụ bằng ngôn ngữ tự nhiên.
11. **

--bare
` bỏ qua OAuth** — yêu cầu 
`Anthropic_API_KEY
` env var hoặc 
`APIKeyHelper
` trong cài đặt.
12. **Sự xuống cấp của bối cảnh là có thật** — Chất lượng đầu ra AI giảm đáng kể khi sử dụng cửa sổ ngữ cảnh trên 70%. Giám sát bằng 

/context
` và chủ động 

/compact

.

## Nội quy dành cho Đại lý Hermes
1. **Ưu tiên chế độ in (

-p

) cho các tác vụ đơn lẻ** — sạch hơn, không xử lý hộp thoại, đầu ra có cấu trúc
2. **Sử dụng tmux cho công việc tương tác nhiều lượt** — cách đáng tin cậy duy nhất để điều phối TUI
3. **Luôn đặt 
`workdir

** — giúp Claude tập trung vào đúng thư mục dự án
4. **Đặt 

--max-turns
` ở chế độ in** - ngăn chặn các vòng lặp vô hạn và chi phí vượt mức
5. **Theo dõi các phiên tmux** — sử dụng 
`tmux capture-pane -t <session -p -S -50
` để kiểm tra tiến trình
6. **Tìm lời nhắc 

❯

** - cho biết Claude đang chờ nhập liệu (hoàn tất hoặc đặt câu hỏi)
7. **Dọn dẹp các phiên tmux** — hủy chúng khi hoàn tất để tránh rò rỉ tài nguyên
8. **Báo cáo kết quả cho người dùng** — sau khi hoàn thành, tóm tắt những gì Claude đã làm và những gì đã thay đổi
9. **Đừng tắt các phiên chạy chậm** — Claude có thể đang thực hiện công việc gồm nhiều bước; thay vào đó hãy kiểm tra tiến độ
10. **Sử dụng 

--allowedTools

** — hạn chế khả năng đối với những gì nhiệm vụ thực sự cần