Bắt đầu với Claude Code: cấu hình API và tiết kiệm token

Claude Code là gì và vì sao nên dùng qua API?

Claude Code là trợ lý lập trình chạy trong terminal: đọc code trong thư mục dự án, sửa file, chạy lệnh và giải thích lỗi. Cách dùng phổ biến là đăng ký gói tháng của Anthropic, trả phí cố định bằng USD dù tháng đó bạn code nhiều hay ít.

Nếu bạn là freelancer nhận dự án lúc nhiều lúc ít, hoặc một nhóm nhỏ chỉ cần Claude Code vài ngày mỗi tuần, trả theo mức dùng thường hợp lý hơn. Claude Code cho phép đổi địa chỉ API bằng biến môi trường, nên bạn trỏ nó về MaCloud AI và trả theo token.

Chuẩn bị gì trước?

Cài Claude Code theo hướng dẫn cài đặt chính thức của Anthropic, kiểm tra bằng lệnh claude --version.
Đăng ký MaCloud AI. Tài khoản đã xác minh email nhận một khoản dùng thử ở lần đầu vào bảng điều khiển; cần thêm thì vào Nạp tiền và chọn phương thức thanh toán đang mở.
Vào API Key, bấm Tạo Key, đặt tên claude-code và sao chép key sk-....
Đặt ba biến môi trường theo hệ điều hành (xem bên dưới), hoặc ghi vào ~/.claude/settings.json.
Mở terminal trong thư mục dự án, chạy claude và gửi một câu ngắn để kiểm tra.

Với Claude Code, base URL là https://api.macloudai.com, không thêm /v1. Địa chỉ có /v1 dành cho công cụ dùng chuẩn OpenAI như Cursor hay LobeChat. Đây là lỗi hay gặp nhất khi cấu hình.

Cấu hình trên macOS, Linux và Windows

export ANTHROPIC_BASE_URL=https://api.macloudai.com
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_MODEL=hk-5-5
claude

$env:ANTHROPIC_BASE_URL="https://api.macloudai.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-..."
$env:ANTHROPIC_MODEL="hk-5-5"
claude

Cách trên chỉ có hiệu lực trong cửa sổ terminal đang mở. Để không phải gõ lại: trên macOS thêm ba dòng export vào ~/.zshrc, trên Linux thêm vào ~/.bashrc, rồi mở terminal mới. Trên Windows dùng setx cho từng biến, ví dụ setx ANTHROPIC_BASE_URL "https://api.macloudai.com", rồi đóng và mở lại PowerShell.

Hoặc ghi vào settings.json

Nếu không muốn đụng tới biến môi trường của cả máy, ghi cấu hình vào file ~/.claude/settings.json (trên Windows là thư mục .claude trong thư mục người dùng). Claude Code đọc phần env mỗi khi khởi động:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.macloudai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "hk-5-5"
  }
}

Nếu file đã có nội dung khác, chỉ thêm khối env vào, giữ nguyên các mục còn lại và chú ý dấu phẩy để file vẫn là JSON hợp lệ. Đừng đưa file này lên repo công khai vì trong đó có key.

Kiểm tra đã chạy đúng chưa

Chạy claude trong thư mục dự án và gửi câu "xin chào". Có câu trả lời là kết nối đã thông.
Vào bảng điều khiển → Mức dùng: lần gọi vừa rồi hiện ra với tên mô hình, số token đầu vào, đầu ra và chi phí.
Báo 401: key sai hoặc đã bị xóa. Báo 403: hết số dư hoặc key không được dùng mô hình đó. Báo 404: tên mô hình sai, hãy sao chép đúng từ trang mô hình.

Nếu trước đó bạn đã đăng nhập Claude Code bằng tài khoản Anthropic, hãy chắc rằng biến môi trường được đặt trong đúng cửa sổ terminal đang chạy claude. Kiểm tra nhanh bằng echo $ANTHROPIC_BASE_URL (macOS / Linux) hoặc echo $env:ANTHROPIC_BASE_URL (PowerShell).

Dùng Claude Code cho cả nhóm thế nào?

Với một nhóm nhỏ, ví dụ ba lập trình viên làm outsource ở Hà Nội, cách gọn nhất là mỗi người một key, đặt tên theo người (claude-code-an, claude-code-binh). Tất cả dùng chung một số dư, nhưng khi cần có thể tắt hoặc xóa riêng key của từng người mà không ảnh hưởng người khác.

Không gửi key qua nhóm chat Zalo chung. Gửi riêng cho từng người, hoặc để mỗi người tự đặt key vào settings.json trên máy mình.
Ai rời dự án thì xóa key của người đó trong mục API Key; key bị xóa không dùng được nữa ngay lập tức.
Thống nhất mô hình mặc định trong nhóm để chi phí dễ đoán, chỉ đổi sang mô hình mạnh hơn khi gặp việc khó.

Mẹo tiết kiệm token với Claude Code

Mỗi bước Claude Code gửi đi rất nhiều ngữ cảnh: nội dung file, kết quả lệnh và toàn bộ lịch sử phiên làm việc. Tất cả đều tính là token đầu vào, nên phiên càng dài thì mỗi bước càng tốn.

Gõ /clear khi chuyển sang việc khác, để lịch sử cũ không bị gửi lại.
Giao việc rõ ràng, chỉ đúng file cần sửa, thay vì bảo nó "xem cả dự án".
Thêm thư mục build, node_modules, file log lớn vào .gitignore để không bị đọc nhầm.
Việc đơn giản (đổi tên biến, viết comment) có thể chọn mô hình nhẹ hơn bằng cách đổi ANTHROPIC_MODEL; việc khó mới dùng mô hình mạnh.
Xem Mức dùng sau vài ngày làm việc để biết chi phí thật của mình.

Giá thực tế hiện tại

Ước tính theo giá ở trang mô hình: mỗi lượt chat 2.000 token input và 500 token output. Số tiền trừ thực tế xem trong bảng điều khiển.

Mô hình	Mỗi lượt chat	1.000 lượt chat
GEM 3.8 Flash	6 ₫	6.307 ₫
TT-6 Luna	15 ₫	15.140 ₫
TT-6.1 Terra	10 ₫	10.333 ₫
HK-5.5	5 ₫	4.960 ₫
GEM 4 Argon	120 ₫	120.427 ₫
TT-6.1 Sol	21 ₫	20.665 ₫

Muốn hiểu vì sao phiên dài tốn hơn, đọc chi phí API tính theo token. Đang phân vân giữa API và gói tháng, xem trả theo mức dùng có rẻ hơn gói tháng không.

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

Q1Có cần đăng ký Claude Pro hay Max để dùng Claude Code không?

Không. Theo cách này Claude Code dùng API key và số dư MaCloud AI, trả theo token. Không có phí tháng.

Q2Vì sao base URL của Claude Code không có /v1?

Claude Code dùng chuẩn Anthropic, và địa chỉ chuẩn Anthropic là https://api.macloudai.com không có /v1. Địa chỉ có /v1 dành cho công cụ dùng chuẩn OpenAI.

Q3Dùng ANTHROPIC_AUTH_TOKEN hay ANTHROPIC_API_KEY?

Hướng dẫn này dùng ANTHROPIC_AUTH_TOKEN, gửi key qua header Authorization: Bearer. MaCloud AI cũng chấp nhận header x-api-key, nhưng chỉ nên đặt một trong hai để tránh nhầm.

Q4Một ngày dùng Claude Code tốn bao nhiêu?

Tùy số token: dự án lớn hay nhỏ, phiên dài hay ngắn và mô hình nào. Cách chính xác nhất là xem mục Mức dùng sau vài ngày làm việc thật.

Q5Dùng chung một key cho cả nhóm được không?

Được, nhưng nên tạo mỗi người một key và đặt tên theo người, để biết ai dùng bao nhiêu và khóa riêng từng key khi cần.

Đăng ký miễn phí → Xem mô hình và giá