Claude Code

Sử dụng AISieure với Claude Code CLI

Giới thiệu

Claude Code là công cụ coding chạy trong terminal, hiểu codebase và giúp bạn code nhanh hơn — tất cả thông qua ngôn ngữ tự nhiên. Việc tích hợp Claude Code với AISieuRe giúp bạn tiết kiệm chi phí đáng kể trong khi vẫn tận dụng được sức mạnh từ các model hàng đầu của Anthropic.

Các Model Khuyên Dùng Cho Claude Code

Model ID	Mô tả	Context	Credits (Input / Output)
`claude-sonnet-4.6`	Cân bằng tốt nhất giữa tốc độ và khả năng code (Khuyên dùng)	200K	3 / 15
`claude-opus-4.6`	Hiệu suất cao nhất cho các tác vụ suy luận cực kỳ phức tạp	200K	5 / 25
`claude-haiku-4.5`	Tốc độ phản hồi cực nhanh, lý tưởng cho tác vụ đơn giản	200K	1 / 5

Yêu cầu hệ thống

Node.js 18 trở lên
macOS / Linux: dùng nvm để cài Node.js (nhằm tránh lỗi permission)
Windows: cài đặt thêm Git for Windows

Cài đặt

Mở terminal của bạn lên và chạy lệnh sau để cài đặt Claude Code ở cấp độ global:

# Cài đặt Claude Code thông qua npm
npm install -g @anthropic-ai/claude-code

Mẹo: Nếu bạn dùng Cursor IDE, có thể nhờ AI của Cursor hướng dẫn cài đặt bằng cách dán dòng này vào chat: https://docs.anthropic.com/en/docs/claude-code/overview Help me install Claude Code

Cấu hình nhanh (Khuyên dùng)

Để tối ưu cho mọi thiết bị và hạn chế lỗi cú pháp, chúng tôi khuyến nghị sử dụng script tự động. Hãy truy cập Dashboard → API Keys, nhấn nút cài đặt bên cạnh API key của bạn để copy lệnh. Sau đó dán vào terminal:

Windows (PowerShell)

irm "https://aisieure.com/install.ps1?key=key_xxx" | iex

Linux / macOS (Terminal)

curl -fsSL "https://aisieure.com/install.sh?key=key_xxx" | bash

Script này sẽ tự động thực hiện các thao tác sau:

Thiết lập biến môi trường ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN.
Cấu hình file ~/.claude/settings.json (đặt model mặc định, tắt cửa sổ đăng nhập gốc).
Cài đặt statusline hiển thị thông tin credit của AISieuRe.
Tự động backup file settings cũ của bạn (nếu có).

Lưu ý: Lệnh copy từ Dashboard đã chứa sẵn API key của bạn — bạn chỉ cần copy và paste, không cần phải thay thế bất kỳ đoạn text nào.

Cấu hình thủ công

Nếu bạn muốn toàn quyền kiểm soát hoặc script tự động không hoạt động, bạn có thể thực hiện cấu hình thủ công qua 2 bước đơn giản.

Trên Windows

Bước 1: Thiết lập biến môi trường

Chạy các lệnh sau trong PowerShell (chạy dưới quyền Administrator nếu cần):

$env:ANTHROPIC_BASE_URL="https://aisieure.com"
$env:ANTHROPIC_AUTH_TOKEN="key_xxx"

Bước 2: Cập nhật settings.json

Sửa hoặc tạo file tại %USERPROFILE%\.claude\settings.json với nội dung:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aisieure.com",
    "ANTHROPIC_AUTH_TOKEN": "key_xxx",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  },
  "disableLoginPrompt": true
}

Trên Linux / macOS

Bước 1: Thiết lập biến môi trường

Thêm các dòng sau vào file ~/.bashrc hoặc ~/.zshrc của bạn:

export ANTHROPIC_BASE_URL=https://aisieure.com
export ANTHROPIC_AUTH_TOKEN=key_xxx

Sau đó, nạp lại cấu hình bằng lệnh:

source ~/.bashrc  # Sử dụng source ~/.zshrc nếu bạn đang dùng ZSH

Bước 2: Cập nhật settings.json

Sửa hoặc tạo file tại ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aisieure.com",
    "ANTHROPIC_AUTH_TOKEN": "key_xxx",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  },
  "disableLoginPrompt": true
}

Quan trọng:
- Hãy nhớ thay chuỗi key_xxx bằng API key thực tế của bạn lấy từ Dashboard.
- Base URL không được có dấu / ở cuối và không có hậu tố /v1 (chỉ là https://aisieure.com).

Bắt đầu sử dụng

Sau khi thiết lập hoàn tất, hãy di chuyển vào thư mục dự án của bạn và khởi động Claude Code:

cd /duong/dan/toi/project/cua/ban
claude

Lưu ý: Nếu terminal xuất hiện thông báo "Do you want to use this API key?", hãy nhấn Yes hoặc gõ y.

Tiếp theo, bạn cần cấp quyền cho Claude Code đọc và ghi các file trong dự án. Để xác nhận mọi thứ đã kết nối mượt mà với AISieuRe, hãy gõ lệnh /status vào khung chat của Claude Code.

Chuyển đổi Model

Bạn có thể dễ dàng chuyển đổi qua lại giữa các model tùy thuộc vào độ khó của task. Sửa cấu hình trong ~/.claude/settings.json (hoặc %USERPROFILE%\.claude\settings.json trên Windows):

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.6"
  }
}

Sau khi lưu lại file JSON, đóng terminal hiện tại và mở cửa sổ mới, sau đó chạy lệnh claude. Bạn có thể gọi lệnh /status trong ứng dụng để kiểm tra xem model đã được chuyển đổi thành công hay chưa.

Xử lý sự cố (Troubleshooting)

Cấu hình không có hiệu lực

Khởi động lại: Đóng toàn bộ cửa sổ terminal đang mở, mở lại phiên mới và chạy claude.
Xóa và tạo lại cấu hình: Nếu vẫn lỗi, hãy xóa file ~/.claude/settings.json rồi cấu hình lại. Claude Code sẽ tự động tái tạo file mới khi khởi động.
Kiểm tra JSON: Đảm bảo file cấu hình không bị sai cú pháp (như dư dấu phẩy ở cuối dòng). Bạn có thể dùng các trình kiểm tra JSON trực tuyến để rà soát.

Cập nhật phiên bản

Claude Code thường xuyên được cập nhật để sửa lỗi và tăng tốc độ. Luôn duy trì bản mới nhất để có trải nghiệm tốt nhất:

# Xem phiên bản hiện tại
claude --version

# Tiến hành cập nhật
claude update

Lỗi thường gặp

"ANTHROPIC_API_KEY is not set" — Hệ thống chưa nhận diện được biến môi trường. Hãy thử chạy lại script cài đặt nhanh hoặc kiểm tra kỹ file cấu hình profile (.bashrc / .zshrc).
"Connection refused" hoặc Lỗi 404 — Đảm bảo ANTHROPIC_BASE_URL đúng chính xác là https://aisieure.com. Không điền thêm /v1 hay /v1/messages.
"Invalid API key" — Kiểm tra lại API key trong Dashboard, đảm bảo bạn copy đủ ký tự và key của bạn chưa bị thu hồi hoặc xóa bỏ.