Hướng Dẫn Các Workflow Phổ Biến Trong Claude Code

Trang này tổng hợp các workflow thực tế khi sử dụng Claude Code hàng ngày: khám phá codebase mới, debug lỗi, refactor code, viết test, tạo PR và quản lý phiên làm việc. Mỗi phần đều có prompt mẫu mà bạn có thể điều chỉnh cho dự án của mình. Để tìm hiểu thêm các mẹo nâng cao, xem phần tổng quan Claude Code trên Agentwork.vn.

Tìm Hiểu Codebase Mới

Xem tổng quan nhanh codebase

Giả sử bạn vừa tham gia một dự án mới và cần hiểu cấu trúc nhanh chóng.

Bước 1: Di chuyển đến thư mục gốc của dự án

cd /path/to/project

Bước 2: Khởi động Claude Code

claude

Bước 3: Yêu cầu tổng quan

give me an overview of this codebase

Bước 4: Đào sâu vào các thành phần cụ thể

explain the main architecture patterns used here
what are the key data models?
how is authentication handled?

💡 Mẹo: Bắt đầu với câu hỏi tổng quan, sau đó thu hẹp dần vào từng khu vực cụ thể. Hãy hỏi về coding convention và pattern được sử dụng trong dự án. Yêu cầu Claude tạo bảng thuật ngữ riêng của dự án.

Tìm kiếm code liên quan

Khi bạn cần tìm code liên quan đến một tính năng cụ thể:

find the files that handle user authentication
how do these authentication files work together?
trace the login process from front-end to database

💡 Mẹo: Hãy mô tả cụ thể những gì bạn đang tìm. Sử dụng ngôn ngữ chuyên ngành (domain language) của dự án để Claude hiểu chính xác hơn.

Sửa Lỗi Hiệu Quả Với Claude Code

Khi bạn gặp thông báo lỗi và cần tìm nguyên nhân:

Bước 1: Chia sẻ lỗi với Claude

I'm seeing an error when I run npm test

Bước 2: Yêu cầu gợi ý cách sửa

suggest a few ways to fix the @ts-ignore in user.ts

Bước 3: Áp dụng bản sửa

update user.ts to add the null check you suggested

💡 Mẹo: Cho Claude biết lệnh để tái tạo lỗi và lấy stack trace. Đề cập các bước reproduce lỗi — lỗi xuất hiện liên tục hay không liên tục.

Refactor Code An Toàn

Khi bạn cần cập nhật code cũ theo pattern và practice hiện đại:

# Bước 1: Tìm code cần refactor
find deprecated API usage in our codebase

# Bước 2: Nhận gợi ý refactoring
suggest how to refactor utils.js to use modern JavaScript features

# Bước 3: Áp dụng thay đổi an toàn
refactor utils.js to use ES2024 features while maintaining the same behavior

# Bước 4: Kiểm tra kết quả
run tests for the refactored code

💡 Mẹo: Yêu cầu Claude giải thích lợi ích của approach mới. Hãy refactor từng bước nhỏ, có test kiểm tra — đừng refactor quá nhiều cùng lúc.

Sử Dụng Subagent Chuyên Biệt

Claude Code cho phép sử dụng các subagent chuyên biệt để xử lý task hiệu quả hơn. Đây là tính năng rất mạnh cho các dự án phức tạp.

Xem danh sách subagent có sẵn:

/agents

Claude tự động delegate task phù hợp:

review my recent code changes for security issues
run all tests and fix any failures

Chỉ định subagent cụ thể:

use the code-reviewer subagent to check the auth module
have the debugger subagent investigate why users can't log in

Tạo subagent tùy chỉnh: Chạy /agents, chọn "Create New subagent" và định nghĩa identifier, điều kiện kích hoạt, quyền truy cập tool, và system prompt.

💡 Mẹo: Tạo subagent theo dự án trong thư mục .claude/agents/ để chia sẻ với team. Hạn chế quyền tool access cho mỗi subagent — chỉ cấp những gì cần thiết.

Plan Mode — Phân Tích Code An Toàn

Plan Mode hướng dẫn Claude phân tích codebase với quyền read-only, hoàn hảo cho việc khám phá codebase, lên kế hoạch thay đổi phức tạp hoặc review code an toàn.

Khi nào nên dùng Plan Mode?

• Triển khai nhiều bước: Khi feature cần chỉnh sửa nhiều file
• Khám phá code: Khi muốn nghiên cứu kỹ codebase trước khi thay đổi
• Phát triển tương tác: Khi muốn trao đổi qua lại với Claude về hướng đi

Cách sử dụng Plan Mode

Bật Plan Mode trong phiên: Nhấn Shift+Tab để chuyển giữa các chế độ quyền. Normal Mode → Auto-Accept Mode → Plan Mode (hiển thị ⏸ plan mode on).

Bắt đầu phiên mới trong Plan Mode:

claude --permission-mode plan

Chạy query headless trong Plan Mode:

claude --permission-mode plan -p "Analyze the authentication system and suggest improvements"

💡 Mẹo: Nhấn Ctrl+G để mở plan trong text editor mặc định, nơi bạn có thể chỉnh sửa trực tiếp trước khi Claude tiếp tục.

Cấu hình Plan Mode làm mặc định:

// .claude/settings.json
{
  "permissions": {
    "defaultMode": "plan"
  }
}

Viết Test Tự Động

Khi cần thêm test cho code chưa được cover:

# Tìm code chưa có test
find functions in NotificationsService.swift that are not covered by tests

# Tạo test scaffold
add tests for the notification service

# Thêm test case cho edge case
add test cases for edge conditions in the notification service

# Chạy và kiểm tra
run the new tests and fix any failures

Claude sẽ tạo test theo pattern và convention của dự án. Khi yêu cầu test, hãy cụ thể về behavior bạn muốn kiểm tra. Claude sẽ phân tích code path và gợi ý test cho error condition, boundary value và unexpected input.

Tạo Pull Request

Bạn có thể tạo PR bằng cách yêu cầu Claude trực tiếp hoặc hướng dẫn từng bước:

# Cách nhanh
create a pr for my changes

# Cách chi tiết
summarize the changes I've made to the authentication module
create a pr
enhance the PR description with more context about the security improvements

Khi tạo PR bằng gh pr create, phiên sẽ tự động liên kết với PR đó. Bạn có thể tiếp tục sau bằng claude --from-pr <number>.

Xử Lý Tài Liệu Và Documentation

# Tìm code chưa có doc
find functions without proper JSDoc comments in the auth module

# Tạo documentation
add JSDoc comments to the undocumented functions in auth.js

# Cải thiện doc
improve the generated documentation with more context and examples

# Kiểm tra chuẩn
check if the documentation follows our project standards

💡 Mẹo: Chỉ rõ style documentation bạn muốn (JSDoc, docstrings, v.v.). Yêu cầu ví dụ trong documentation. Ưu tiên document cho public API, interface và logic phức tạp.

Làm Việc Với Hình Ảnh

Claude Code hỗ trợ phân tích hình ảnh trực tiếp trong conversation:

Cách thêm hình ảnh:

• Kéo thả (drag & drop) hình ảnh vào cửa sổ Claude Code
• Copy hình ảnh và paste bằng Ctrl+V (không dùng Cmd+V)
• Cung cấp đường dẫn: Analyze this image: /path/to/your/image.png

Ví dụ prompt:

Here's a screenshot of the error. What's causing it?
This is our current database schema. How should we modify it for the new feature?
Generate CSS to match this design mockup

Tham Chiếu File Và Thư Mục

Sử dụng @ để nhanh chóng đưa file hoặc thư mục vào context mà không cần đợi Claude đọc:

# Tham chiếu file đơn
Explain the logic in @src/utils/auth.js

# Tham chiếu thư mục
What's the structure of @src/components?

# Tham chiếu MCP resource
Show me the data from @github:repos/owner/repo/issues

💡 Mẹo: Đường dẫn file có thể relative hoặc absolute. Bạn có thể tham chiếu nhiều file trong cùng một message: @file1.js and @file2.js.

Extended Thinking — Chế Độ Suy Nghĩ Sâu

Extended thinking được bật mặc định, cho Claude không gian để suy luận qua các vấn đề phức tạp từng bước trước khi phản hồi. Bạn có thể xem quá trình suy nghĩ bằng verbose mode với Ctrl+O.

Ngoài ra, Opus 4.6 và Sonnet 4.6 hỗ trợ adaptive reasoning: thay vì budget thinking token cố định, model tự động phân bổ thinking dựa trên effort level bạn chọn.

Cấu hình thinking mode

Phạm vi	Cách cấu hình	Chi tiết
Effort level	Chạy /effort hoặc điều chỉnh trong /model	Kiểm soát độ sâu thinking cho Opus 4.6 và Sonnet 4.6
Keyword ultrathink	Thêm "ultrathink" vào prompt	Đặt effort cao cho turn đó — hữu ích cho task cần suy luận sâu
Toggle shortcut	Option+T (macOS) hoặc Alt+T (Windows/Linux)	Bật/tắt thinking cho phiên hiện tại
Global default	Dùng /config	Đặt mặc định cho tất cả dự án

⚠️ Lưu ý: Bạn sẽ bị tính phí cho tất cả thinking token đã sử dụng, kể cả khi Claude 4 model hiển thị thinking tóm tắt.

Tiếp Tục Phiên Làm Việc Trước

Khi khởi động Claude Code, bạn có thể tiếp tục phiên trước đó:

• claude --continue — tiếp tục conversation gần nhất trong thư mục hiện tại
• claude --resume — mở conversation picker hoặc resume theo tên
• claude --from-pr 123 — tiếp tục phiên liên kết với PR cụ thể

Đặt tên phiên

# Đặt tên khi khởi động
claude -n auth-refactor

# Hoặc đổi tên trong phiên
/rename auth-refactor

# Resume theo tên
claude --resume auth-refactor

Session picker

Lệnh /resume mở interactive picker với các phím tắt:

Phím tắt	Hành động
↑ / ↓	Di chuyển giữa các phiên
→ / ←	Mở rộng/thu gọn phiên nhóm
Enter	Chọn và resume phiên
P	Preview nội dung phiên
R	Đổi tên phiên
/	Tìm kiếm để lọc phiên
B	Lọc theo git branch hiện tại

Chạy Song Song Với Git Worktrees

Khi làm nhiều task cùng lúc, mỗi phiên Claude cần bản copy riêng của codebase để không xung đột. Git worktree giải quyết vấn đề này bằng cách tạo thư mục làm việc riêng biệt, mỗi thư mục có file và branch riêng, nhưng chia sẻ cùng lịch sử repository.

Sử dụng flag --worktree (-w) để tạo worktree cô lập:

# Bắt đầu Claude trong worktree tên "feature-auth"
claude --worktree feature-auth

# Bắt đầu phiên khác trong worktree riêng
claude --worktree bugfix-123

# Tự động tạo tên ngẫu nhiên
claude --worktree

Worktree được tạo tại <repo>/.claude/worktrees/<name> và branch từ default remote branch.

Subagent worktrees

Subagent cũng có thể sử dụng worktree isolation để làm việc song song. Cấu hình trong custom subagent bằng isolation: worktree trong frontmatter.

Copy file gitignored vào worktree

Thêm file .worktreeinclude vào project root để tự động copy các file như .env:

.env
.env.local
config/secrets.json

Nhận Thông Báo Khi Claude Cần Chú Ý

Khi bạn giao task dài và chuyển sang cửa sổ khác, hãy thiết lập desktop notification:

macOS:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

Thêm cấu hình trên vào ~/.claude/settings.json. Bạn có thể thu hẹp matcher:

Matcher	Kích hoạt khi
permission_prompt	Claude cần bạn phê duyệt tool use
idle_prompt	Claude hoàn thành và đợi prompt tiếp
auth_success	Xác thực hoàn tất
elicitation_dialog	Claude đang hỏi bạn câu hỏi

Dùng Claude Code Như Unix Utility

Thêm Claude vào quy trình kiểm tra

// package.json
{
  "scripts": {
    "lint:claude": "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
  }
}

Pipe dữ liệu vào và ra

cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

Kiểm soát format output

# Text format (mặc định)
cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt

# JSON format — đầy đủ metadata bao gồm cost và duration
cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json

# Streaming JSON — real-time output
cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json

Chạy Claude Theo Lịch Trình

Claude Code hỗ trợ nhiều tùy chọn lập lịch chạy task tự động:

Tùy chọn	Nơi chạy	Phù hợp cho
Cloud scheduled tasks	Hạ tầng Anthropic	Task cần chạy kể cả khi máy tắt. Cấu hình tại claude.ai/code
Desktop scheduled tasks	Máy của bạn, qua desktop app	Task cần truy cập file local
GitHub Actions	CI pipeline	Task liên kết với sự kiện repo
/loop	CLI session hiện tại	Polling nhanh khi session đang mở

💡 Mẹo: Khi viết prompt cho scheduled task, hãy rõ ràng về kết quả mong muốn và cách xử lý output. Task chạy tự động nên không thể hỏi thêm.