Hướng dẫn Claude Code — cách dùng hằng ngày với khóa tính phí theo mức sử dụng: đổi mô hình, tính chi phí và quản lý ngữ cảnh

Cách dùng Claude Code có thể tóm tắt thành bốn bước: chạy claude trong thư mục dự án, chạy /init một lần để nó tạo CLAUDE.md, mô tả nhiệm vụ bằng tiếng Việt và đính kèm đường dẫn tệp, xem các thay đổi nó đề xuất rồi quyết định có chấp nhận hay không. Đây là một trợ lý lập trình chạy trong terminal; nó tự đọc tệp, sửa tệp và chạy kiểm thử, nhưng sẽ xin phép bạn trước khi thực hiện. Có thể đăng nhập bằng gói Pro/Max hoặc thiết lập khóa API tính phí theo mức sử dụng; khi dùng khóa, mỗi bước đều tính theo token, nên trọng tâm của việc sử dụng hằng ngày trở thành ba điều — chuyển đổi mô hình theo nhiệm vụ, biết một phiên làm việc tốn bao nhiêu và giữ ngữ cảnh ngắn gọn.

Trên mạng, hầu hết hướng dẫn Claude Code đều giả định bạn đăng nhập bằng gói thuê bao. Trang này dành cho nhóm người dùng khác: không có gói thuê bao hoặc không muốn bị giới hạn bởi cửa sổ sử dụng 5 giờ, nên dùng khóa tính phí theo mức sử dụng. Nếu chưa cài đặt, hãy xem Hướng dẫn cài đặt Claude Code, cài đặt và kết nối xong rồi quay lại.

Bắt đầu lần đầu: bốn thao tác

# 1. 一定要在專案資料夾裡啟動——它能看、能改的範圍就是這個資料夾
cd ~/work/my-app
claude

# 2. 第一個指令：讀過整個 repo，產生 CLAUDE.md
> /init

# 3. 之後直接用中文交代任務，附上檔案路徑最準
> 把 src/api/user.ts 的輸入驗證改用 zod，測試也一起修好

# 4. 牽涉很多檔案的任務，先按 Shift+Tab 切到計畫模式，確認做法再動手

Mỗi khi muốn sửa tệp hoặc chạy lệnh, nó sẽ hỏi bạn trước. Nếu đi sai hướng, nhấn Esc để dừng, rồi dùng /rewind quay lại điểm kiểm tra trước đó; mã nguồn và cuộc trò chuyện sẽ cùng được khôi phục. /init CLAUDE.md do nó tạo ra chỉ là bản nháp; bên dưới có một phần riêng hướng dẫn cách rút gọn nó.

Tính phí một phiên làm việc khi dùng khóa API

Mỗi lần Claude Code gửi yêu cầu, nó gửi lại toàn bộ lời nhắc hệ thống, CLAUDE.md, cuộc trò chuyện và nội dung các tệp đã đọc; nội dung mới được nối vào cuối. Phần đầu không thay đổi sẽ dùng bộ nhớ đệm: đọc bộ nhớ đệm tính bằng 10% giá đầu vào, ghi bộ nhớ đệm tính bằng 1,25 lần giá đầu vào. Vì vậy, phần lớn chi phí của một phiên thường đến từ việc “đọc lại cuộc trò chuyện cũ”.

Bảng dưới đây dùng một phiên làm việc trong tài liệu chi phí chính thức của Anthropic — đầu vào 1.200, đầu ra 5.300, đọc bộ nhớ đệm 940.000 và ghi bộ nhớ đệm 50.000 token — rồi áp dụng mức giá của Kunavo, tính riêng cho bốn mô hình:

Trên Claude Sonnet 5, khoảng 85% hóa đơn của phiên này là đọc và ghi bộ nhớ đệm. Nói cách khác, chi phí được quyết định bởi độ dài cuộc trò chuyện, không phải số ký tự bạn gõ — đó cũng là lý do có phần “Vệ sinh ngữ cảnh” bên dưới.

Để xem số liệu của mình, chạy /usage trong Claude Code (/cost là bí danh của lệnh này); lệnh sẽ liệt kê bốn loại token. Tuy nhiên, số tiền bên cạnh là ước tính cục bộ của Claude Code theo bảng giá Anthropic; khi dùng Kunavo, số tiền thực tế bị trừ được xác định trên trang mức sử dụng trong bảng điều khiển, nơi có số token của từng mô hình (bao gồm đọc và ghi bộ nhớ đệm) cùng số tiền bị trừ.

Chuyển mô hình theo từng nhiệm vụ

Trước tiên, trong phần env của ~/.claude/settings.json hãy ánh xạ từng bí danh đến mô hình thực tế. Viết trong tệp này để các tiện ích mở rộng của trình chỉnh sửa và tiến trình nền cũng đọc được; không viết vào .claude/settings.json sẽ được commit trong dự án. Các bí danh phải được ánh xạ: mô hình mặc định của Claude Code và bí danh opus đều trỏ đến Opus mới nhất; nếu Kunavo chưa cung cấp mô hình đó, cấu hình không ánh xạ sẽ khiến yêu cầu đầu tiên nhận 404; bí danh sonnet trỏ đến Sonnet 5.5, nhưng Kunavo không cung cấp mô hình này, nên nếu thiếu ANTHROPIC_DEFAULT_SONNET_MODEL, giai đoạn thực thi của /model sonnet, opusplan và các subagent được đặt thành model: sonnet đều sẽ nhận 404. Cấu hình dưới đây ánh xạ bí danh opus đến Claude Opus 5.5 (claude-opus-5-5), yêu cầu Claude Code v2.1.280 trở lên; nếu phiên bản cũ hơn, trước tiên hãy chạy claude update.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5"
  }
}

Sau khi thiết lập, việc chuyển đổi chỉ cần một dòng:

# 工作階段裡切換（別名會對應到上面設定的模型）
> /model haiku
> /model sonnet
> /model opus

# 也可以直接打完整名稱
> /model claude-fable-5

# 或在啟動時指定
claude --model claude-opus-5-5

/model sẽ lưu lựa chọn làm mặc định cho các phiên làm việc mới sau này; nếu chỉ muốn đổi trong lần này, hãy chạy /model không kèm tham số rồi chọn s trong menu. Không thể bỏ ANTHROPIC_DEFAULT_HAIKU_MODEL khi dùng Kunavo: nếu không đặt, bí danh haiku sẽ yêu cầu một tên mô hình mà Kunavo không cung cấp (Haiku 5.5 từ v2.1.293), khiến /model haiku và các tác tử con được đặt dùng haiku đều trả về 404. Thiết lập này cũng quyết định mô hình Claude Code tự dùng cho các tác vụ chạy nền như tóm tắt và đặt tiêu đề; chọn mô hình rẻ nhất cũng giúp tiết kiệm chi phí.

Tại Kunavo, Claude Opus 5.5 có giá $2,80 / $14,00, còn Claude Sonnet 5 có giá $1,40 / $7,00; đơn giá của Claude Haiku 4.5 khoảng bằng 1/2 giá của Claude Sonnet 5, còn Claude Fable 5 bằng 5 lần giá của nó. So với giá chính thức: Claude Sonnet 5 Rẻ hơn Anthropic chính thức khoảng 30%, Claude Opus 5.5 Rẻ hơn Anthropic chính thức khoảng 30%, Claude Haiku 4.5 Rẻ hơn Anthropic chính thức khoảng 30%, Claude Fable 5 Rẻ hơn Anthropic chính thức khoảng 30%.

Chuyển mô hình giữa các nhiệm vụ, không chuyển giữa chừng một nhiệm vụ.Bộ nhớ đệm của mỗi mô hình tách biệt: nếu /model giữa chừng một nhiệm vụ, yêu cầu tiếp theo phải đọc lại toàn bộ cuộc trò chuyện theo giá chưa dùng bộ nhớ đệm (khi bộ nhớ đệm còn hiệu lực, Claude Code sẽ yêu cầu bạn xác nhận). Hãy /clear trước rồi mới chuyển; phần phải đọc lại sẽ chỉ còn cuộc trò chuyện mới rất ngắn. Token suy luận tính theo giá đầu ra; với nhiệm vụ đơn giản, có thể dùng /effort để giảm mức suy luận — cũng nên đặt ở đầu nhiệm vụ, vì thay đổi effort giữa chừng sẽ làm mất bộ nhớ đệm ở hầu hết mô hình.

CLAUDE.md: chỉ viết những điều bạn sẽ lặp lại nhiều lần

# CLAUDE.md — 放在專案根目錄，commit 進 git

## 指令
- 測試：npm test（只跑一個檔：npm test -- path/to/file）
- 型別檢查：npx tsc --noEmit
- Lint：npm run lint

## 規則
- 日期一律用 date-fns，不用 moment。
- API handler 只放在 app/api/**/route.ts。
- commit 訊息用繁體中文，前綴 feat / fix / docs。

## 不要動的地方
- db/migrations/ —— 產生出來的檔案，不要手改。

CLAUDE.md được tải khi mỗi phiên bắt đầu và được gửi trong mọi yêu cầu sau đó (chủ yếu tính theo giá đọc bộ nhớ đệm). Anthropic khuyến nghị giữ mỗi tệp dưới 200 dòng — càng dài càng chiếm ngữ cảnh và mức tuân thủ càng kém. Những điều có thể suy ra từ mã nguồn (cấu trúc thư mục, mô tả hàm) không cần viết; ghi chú chỉ dành cho con người có thể đặt trong <!-- -->, và sẽ bị loại bỏ trước khi đưa vào ngữ cảnh.

Một hiểu lầm phổ biến khác: chỉnh sửa CLAUDE.md giữa phiên không có hiệu lực ngay; phải chờ đến /clear, /compact hoặc khởi động lại thì phiên bản mới mới được đọc.

Vệ sinh ngữ cảnh: làm cho mỗi bước rẻ hơn

• Dùng /clear giữa các nhiệm vụ không liên quan.Nó mở một cuộc trò chuyện hoàn toàn mới và không tốn phí; có thể dùng /resume để tìm lại cuộc trò chuyện cũ sau này.
• Khi một nhiệm vụ kéo dài quá lâu, dùng /compact.Có thể kèm các điểm cần giữ lại, chẳng hạn /compact 保留測試輸出和改過的檔案. Lệnh này gửi một yêu cầu tóm tắt; thực hiện khi bộ nhớ đệm còn hiệu lực sẽ rẻ nhất. Nếu compact sau khi rời đi lâu, yêu cầu tóm tắt phải đọc lại toàn bộ lịch sử theo giá chưa dùng bộ nhớ đệm.
• Nếu đi sai hướng, dùng /rewind.Thao tác này quay lại phần đầu đã được lưu trong bộ nhớ đệm, tiết kiệm hơn compact.
• Ở chế độ dùng khóa, bộ nhớ đệm mặc định chỉ tồn tại 5 phút.Nếu quay lại sau hơn 5 phút, bước đầu tiên sẽ ghi lại toàn bộ phần trước vào bộ nhớ đệm (1,25 lần giá đầu vào). Trước khi đi họp hoặc ăn, hãy dùng /compact hoặc /clear để kết thúc.
• Dùng /context để xem thứ gì đang chiếm ngữ cảnh.Khi dùng Kunavo, con số này là ước tính cục bộ — Kunavo hiện không cung cấp /v1/messages/count_tokens; tính năng nén tự động và bản thân phiên làm việc không bị ảnh hưởng.
• Tắt các máy chủ MCP không dùng trong /mcp.Tài liệu Anthropic nêu rõ rằng khi đặt ANTHROPIC_BASE_URL tùy chỉnh, tính năng tìm kiếm công cụ (tool search) không khả dụng; định nghĩa công cụ MCP không được tải trì hoãn mà chiếm chỗ trực tiếp trong mọi yêu cầu.
• Kèm đường dẫn tệp khi giao nhiệm vụ.“Sửa phần xác thực” khiến nó tìm kiếm khắp nơi và đọc nhiều tệp; “đổi phần xác thực của src/api/user.ts sang zod” chỉ đọc những gì cần thiết.

Để nó bớt hỏi “có thể chạy không”, chỉ nên cho phép các lệnh đọc và xác thực; cờ bỏ qua mọi xác nhận chỉ nên dùng trong môi trường có thể vứt bỏ hoàn toàn. Lý do nằm trong giải thích về --dangerously-skip-permissions (tiếng Anh). Cách tính phí bộ nhớ đệm xem tài liệu bộ nhớ đệm.

Giới hạn chi phí và thanh toán

Trong trang quản lý khóa, tạo một khóa riêng cho Claude Code và đặt giới hạn chi tiêu hằng tháng: khi đạt giới hạn, yêu cầu bằng khóa này sẽ trả về 402, không tiếp tục bị trừ tiền; vòng lặp mất kiểm soát cũng chỉ tiêu tốn đến giới hạn. Trang này cũng cho phép đặt danh sách IP cho phép.

Tài khoản sử dụng hình thức trả trước: nạp tối thiểu $10, số dư không hết hạn và các yêu cầu thất bại không bị tính phí. Tại Đài Loan, có thể nạp bằng thẻ tín dụng quốc tế (Visa, Mastercard, Amex, JCB, UnionPay) hoặc Apple Pay, Google Pay; hiện chưa có các kênh nội địa như JkoPay và LINE Pay. Xem chi tiết tại Chi phí Claude Code.

Khi nào thuê bao lại có lợi hơn

Với người tương tác lâu mỗi ngày và chạy nhiều bước mỗi tháng, phí thuê bao cố định thường rẻ hơn tính theo mức sử dụng. Chỉ cần một phép chia: phí tháng ÷ chi phí mỗi bước = số bước hòa vốn; với Claude Sonnet 5 có chi phí khoảng $0,043 mỗi bước (không tính bộ nhớ đệm), nếu chạy ít hơn số bước này mỗi tháng thì tính theo mức sử dụng rẻ hơn, và tháng không làm việc vẫn là $0. Phí tháng hiện tại và công thức đầy đủ của từng gói nằm trên trang Chi phí Claude Code; không lặp lại ở đây.

Cũng cần nói rõ sự đánh đổi: dùng Kunavo là dùng dung lượng chia sẻ, không có hạn ngạch riêng và không có SLA theo hợp đồng. Nhóm cần hạn ngạch hoặc SLA được đảm bảo nên mua trực tiếp từ Anthropic. Hướng dẫn đầy đủ về cấu hình kết nối nằm trong tài liệu tích hợp Claude Code (tiếng Anh).

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