Claude Code · TaiKhoanGiaRe30/09/2026

Cài Claude Code với TaiKhoanGiaRe: hướng dẫn từng bước

Hướng dẫn cài Claude Code với TaiKhoanGiaRe: lấy secret key, đặt ANTHROPIC_BASE_URL, chọn claude-sonnet-5, chạy thử và theo dõi chi phí.

Claude Code có thể kết nối tới API tương thích Anthropic để hỗ trợ đọc mã nguồn, phân tích dự án và thực hiện các tác vụ trong môi trường dòng lệnh. Với TaiKhoanGiaRe, bạn dùng endpoint Anthropic-compatible, secret key được cấp trong tài khoản và nạp trước bằng VietQR qua PayOS.

Bài viết này hướng dẫn theo quy trình thực tế: chuẩn bị tài khoản, lấy secret key trong tab API keys, khai báo đúng biến môi trường, chọn model claude-sonnet-5, gửi một yêu cầu kiểm tra và theo dõi chi phí. Nếu muốn xem toàn bộ hướng dẫn tích hợp có ảnh chụp màn hình, bạn có thể mở trang Integrations.

1. Chuẩn bị tài khoản và thông tin kết nối

Trước khi mở Claude Code, bạn cần có tài khoản TaiKhoanGiaRe và một secret key. Mỗi tài khoản có chính xác một secret key, được tạo tự động khi đăng ký. Bạn không tạo thêm key thứ hai trong giao diện; thao tác hiện có là xem key bằng Show hoặc xoay key bằng Rotate.

Nếu chưa có tài khoản, hãy đăng ký hoặc đăng nhập tại khu vực đăng nhập. Sau khi vào vùng tài khoản tại /dashboard.html, thực hiện các bước sau:

Mở tab API keys.
Chọn Show để xem secret key hiện tại.
Sao chép key vào nơi lưu trữ riêng, chẳng hạn trình quản lý mật khẩu.
Không đưa key vào mã nguồn, file README, log terminal hoặc kho Git công khai.

Claude Code cần dùng đúng hai biến môi trường của Anthropic:

ANTHROPIC_BASE_URL=https://taikhoangiare.vn
ANTHROPIC_AUTH_TOKEN=<secret-key-cua-ban>

Điểm dễ nhầm nhất là base URL cho Claude Code không có phần /v1. Địa chỉ https://taikhoangiare.vn/v1 là base URL dành cho OpenAI SDK, còn Claude Code sử dụng base URL tương thích Anthropic là https://taikhoangiare.vn. Không đổi hai địa chỉ này cho nhau.

2. Lấy key và kiểm tra hướng dẫn trong Integrations

Sau khi sao chép key, chuyển sang tab Integrations trong vùng tài khoản. Tab này có hướng dẫn cho Claude Code, cùng các cách kiểm tra key bằng yêu cầu nhỏ. Đây là nơi phù hợp để xác nhận cấu hình trước khi đưa Claude Code vào một dự án thật.

Trong quá trình kiểm tra, hãy đối chiếu ba giá trị:

Secret key là key đang được hiển thị trong tab API keys.
Base URL là https://taikhoangiare.vn, không thêm /v1.
Model được chọn là claude-sonnet-5.

Nếu bạn vừa dùng Rotate, secret key cũ sẽ bị vô hiệu hóa. Khi đó, mọi terminal, file cấu hình hoặc tích hợp đang dùng key cũ sẽ không còn xác thực được. Hãy sao chép key mới và cập nhật lại biến môi trường trước khi kiểm tra.

Để hiểu thêm về cấu trúc endpoint, phương thức xác thực và tham số request, hãy xem tài liệu API. Claude Code dùng giao tiếp Anthropic; các endpoint API được liệt kê gồm POST /v1/messages, POST /v1/chat/completions và POST /v1/responses theo từng chuẩn tương thích.

3. Cấu hình Claude Code trên macOS và Linux

Trên macOS hoặc Linux, mở một terminal mới rồi khai báo biến môi trường trong phiên hiện tại. Thay phần giá trị mẫu bằng secret key của bạn:

export ANTHROPIC_BASE_URL="https://taikhoangiare.vn"
export ANTHROPIC_AUTH_TOKEN="your-secret-key"

Để kiểm tra biến đã có trong phiên terminal hay chưa, bạn có thể dùng:

echo "$ANTHROPIC_BASE_URL"
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"

Lệnh kiểm tra thứ hai chỉ in ra trạng thái, không in nội dung secret key. Đây là cách nên dùng khi bạn cần xác nhận cấu hình mà không làm lộ key trên màn hình hoặc trong bản ghi terminal.

Nếu muốn biến môi trường được nạp ở các phiên terminal sau, thêm hai dòng export vào file cấu hình shell mà bạn đang sử dụng, chẳng hạn ~/.zshrc hoặc ~/.bashrc. Sau đó mở terminal mới hoặc nạp lại file cấu hình. Không chèn key trực tiếp vào mã nguồn của dự án.

Khi Claude Code đã được cài trong môi trường của bạn, khởi chạy bằng lệnh tương ứng của công cụ:

claude

Trong Claude Code, chọn model claude-sonnet-5 khi công cụ yêu cầu chọn model. Nếu phiên bản Claude Code bạn đang dùng hỗ trợ lệnh chọn model trong phiên làm việc, có thể nhập:

/model claude-sonnet-5

Cách hiển thị lựa chọn có thể phụ thuộc vào phiên bản Claude Code. Điều quan trọng là tên model phải khớp chính xác với model ID claude-sonnet-5, không dùng tên hiển thị tự đặt hoặc thêm khoảng trắng.

4. Cấu hình trên Windows PowerShell

Trong PowerShell, cú pháp khai báo biến môi trường khác macOS và Linux. Mở PowerShell trong phiên làm việc cần dùng Claude Code và chạy:

$env:ANTHROPIC_BASE_URL = "https://taikhoangiare.vn"
$env:ANTHROPIC_AUTH_TOKEN = "your-secret-key"

Kiểm tra base URL mà không in secret key:

$env:ANTHROPIC_BASE_URL
if ($env:ANTHROPIC_AUTH_TOKEN) { Write-Output "ANTHROPIC_AUTH_TOKEN is set" }

Sau đó chạy Claude Code:

claude

Nếu cần dùng lại cấu hình ở những phiên sau, hãy áp dụng cách lưu biến môi trường phù hợp với chính sách máy tính của bạn. Với máy dùng chung, nên ưu tiên trình quản lý secret hoặc cơ chế bảo mật của hệ điều hành thay vì đặt key trong file văn bản dễ đọc.

Nếu Claude Code báo lỗi xác thực, quay lại tab API keys để kiểm tra key hiện tại. Nếu trước đó bạn đã dùng Rotate, hãy thay key cũ bằng key mới trong phiên PowerShell rồi khởi động lại Claude Code.

5. Gửi yêu cầu kiểm tra nhỏ trước khi làm việc

Tab Integrations cho phép kiểm tra key bằng một yêu cầu thật có kích thước nhỏ. Nên thực hiện bước này trước khi cho Claude Code phân tích cả repository, vì bạn sẽ dễ xác định lỗi nằm ở key, base URL hay model.

Bạn cũng có thể kiểm tra endpoint Anthropic bằng cURL. Ví dụ dưới đây sử dụng POST /v1/messages và model claude-sonnet-5:

curl https://taikhoangiare.vn/v1/messages \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 128,
    "messages": [
      {
        "role": "user",
        "content": "Trả lời ngắn: kết nối API đang hoạt động."
      }
    ]
  }'

Trong PowerShell, nếu biến môi trường đã được đặt, phần header vẫn dùng giá trị của $env:ANTHROPIC_AUTH_TOKEN. Bạn cũng có thể ưu tiên trình kiểm tra có sẵn trong tab Integrations nếu không muốn tự viết request.

Yêu cầu kiểm tra nên ngắn và có max_tokens vừa phải. Sau khi nhận được phản hồi, mở Claude Code trong thư mục dự án nhỏ trước. Gửi một tác vụ đơn giản như yêu cầu mô tả cấu trúc thư mục hoặc giải thích một file cụ thể, thay vì bắt đầu bằng toàn bộ lịch sử mã nguồn.

6. Theo dõi chi phí khi dùng claude-sonnet-5

TaiKhoanGiaRe sử dụng credit trả trước; 1 credit = 55,8đ. Bạn nạp credit bằng chuyển khoản VietQR qua PayOS trong tab Billing. Các gói hiện có gồm Starter 99.000đ = 1500 credit, Pro 279.000đ = 5000 credit, Business 679.000đ = 13000 credit và Enterprise 1.339.000đ = 30000 credit. Tài khoản mới có credit dùng thử; số lượng cụ thể không nêu trong bài này.

Claude Code thường gửi nhiều ngữ cảnh trong quá trình làm việc. Vì vậy, nên phân biệt input mới, output và cache read khi đọc bảng giá model:

Model ID	Input / 1 triệu token	Output / 1 triệu token	Cache read / 1 triệu token
`claude-sonnet-5`	10.499đ	52.500đ	2.401đ

Prompt caching được bật. Phần cache read có mức giá riêng thấp hơn trong bảng trên, nhưng chi phí thực tế vẫn phụ thuộc vào số token được gửi và nhận trong từng yêu cầu. Các mức tham khảo đã tính sẵn cho claude-sonnet-5 là:

Một lượt agent gồm 100.000 token đọc cache + 5.000 token input mới + 1.000 token output = 345đ.
1.000 lượt như vậy = 345.114đ.
Một tin nhắn chat gồm 1.000 token input + 500 token output = 37đ.
1.000 tin nhắn = 36.749đ.

Đây là các kịch bản tham khảo theo lượng token đã nêu, không phải mức phí cố định cho mọi phiên Claude Code. Khi chạy tác vụ lớn, hãy xem số dư trước khi bắt đầu và kiểm tra phát sinh sau đó.

Trong /dashboard.html, tab Overview hiển thị số dư, mức chi hôm nay, 7 ngày gần nhất và số token. Tab Usage cho phép xem dữ liệu theo hôm nay, 7 ngày hoặc 30 ngày, đồng thời lọc theo sản phẩm. Tab Billing hiển thị lịch sử thanh toán và chính sách hoàn tiền.

Nếu một job thất bại, credit được hoàn lại theo cơ chế của dịch vụ. Với Claude Code, bạn vẫn nên kiểm tra log lỗi và tab Usage để xác nhận yêu cầu đã xử lý như thế nào. Để xem thêm cách kiểm soát token, bạn có thể tham khảo bài tối ưu chi phí token khi gọi API LLM và bảng model tại trang Models.

7. Lỗi thường gặp và cách xử lý

Base URL có thêm /v1

Đây là lỗi cấu hình phổ biến khi sao chép địa chỉ OpenAI-compatible. Với Claude Code, đặt đúng ANTHROPIC_BASE_URL=https://taikhoangiare.vn. Không dùng https://taikhoangiare.vn/v1 cho biến này.

Dùng sai tên biến xác thực

Tên biến cần là ANTHROPIC_AUTH_TOKEN. Không thay bằng AUTH_TOKEN, vì Claude Code cần biến Anthropic đầy đủ theo hướng dẫn tích hợp.

Key đã bị vô hiệu hóa

Nếu bạn đã dùng Rotate, key trước đó không còn dùng được. Mở tab API keys, chọn Show để lấy key hiện tại, cập nhật lại terminal rồi thử yêu cầu nhỏ trong tab Integrations.

Model ID không khớp

Hãy dùng chính xác claude-sonnet-5. Nếu muốn xem các model đang được cung cấp và mức giá tương ứng, kiểm tra trang Pricing và danh sách model trước khi đổi cấu hình.

Đưa secret key vào Git

Nếu key đã xuất hiện trong commit, hãy Rotate ngay trong tab API keys, sau đó xóa key khỏi biến môi trường hoặc file liên quan. Không đăng key lên issue, đoạn code mẫu hay ảnh chụp terminal.

Tóm lại: lấy secret key trong tab API keys, đặt ANTHROPIC_BASE_URL là https://taikhoangiare.vn, dùng ANTHROPIC_AUTH_TOKEN, chọn claude-sonnet-5, kiểm tra bằng yêu cầu nhỏ rồi theo dõi token và chi phí trong Overview, Usage và Billing.

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

Claude Code dùng base URL nào với TaiKhoanGiaRe?

Dùng https://taikhoangiare.vn cho ANTHROPIC_BASE_URL, không thêm /v1. Địa chỉ /v1 là base URL dành cho OpenAI SDK.

Tôi cần dùng biến môi trường nào để xác thực?

Dùng ANTHROPIC_AUTH_TOKEN cùng secret key trong tab API keys. Không dùng riêng biến AUTH_TOKEN.

Làm thế nào để chọn model claude-sonnet-5?

Trong Claude Code, chọn hoặc nhập model ID claude-sonnet-5 khi công cụ yêu cầu model. Bạn cũng có thể kiểm tra model và giá trên trang Models của TaiKhoanGiaRe.

Nếu bấm Rotate thì key cũ có còn dùng được không?

Không. Rotate vô hiệu hóa secret key hiện tại, vì vậy bạn cần dùng key mới được hiển thị trong tab API keys và cập nhật lại biến môi trường.

Dùng thử API TaiKhoanGiaRe

Tạo tài khoản, nhận credit dùng thử và lấy API key dùng ngay cho Claude, GPT, DeepSeek, tạo ảnh, video và giọng nói. Nạp bằng VietQR.

Lấy API key Xem bảng giá

← Về trang Blog