Cài đặt
Hướng dẫn cài đặt và cấu hình AISieure cho Claude Code trên mọi nền tảng.
Giới thiệu
Claude Code là công cụ AI coding agent của Anthropic chạy trực tiếp trong terminal, cho phép bạn lập trình, debug, và quản lý dự án bằng ngôn ngữ tự nhiên. Thay vì trả phí trực tiếp cho Anthropic, bạn có thể kết nối Claude Code với AISieuRe để sử dụng các model Claude (Haiku, Sonnet, Opus) với chi phí tiết kiệm hơn đáng kể thông qua hệ thống credit.
Hướng dẫn này sẽ đưa bạn từ con số không đến một phiên Claude Code hoạt động hoàn chỉnh với AISieuRe — bao gồm cài đặt, cấu hình tự động lẫn thủ công, chọn model, và xử lý sự cố.
Yêu cầu hệ thống
Trước khi bắt đầu, hãy đảm bảo bạn đã chuẩn bị đầy đủ các mục sau:
| Yêu cầu | Chi tiết |
|---|---|
| Tài khoản AISieuRe | Đã đăng ký tại aisieure.com/register và tạo ít nhất một API key (prefix key_) trong Dashboard → API Keys |
| Credit khả dụng | Tài khoản cần có credit để gọi API. Xem bảng giá để nạp credit phù hợp |
| Node.js 18+ | Claude Code yêu cầu Node.js phiên bản 18 trở lên. Khuyến nghị sử dụng bản LTS (20.x hoặc 22.x) |
| Hệ điều hành | Windows 10/11 (PowerShell 5.1+), macOS 12+, hoặc Linux (Ubuntu 20.04+, Debian 11+, Fedora 36+) |
| Terminal | PowerShell hoặc Windows Terminal (Windows), Terminal.app hoặc iTerm2 (macOS), bất kỳ terminal nào (Linux) |
Chưa có tài khoản? Đăng ký miễn phí, sau đó vào Dashboard → API Keys để tạo key. Toàn bộ quá trình chỉ mất khoảng 30 giây.
Bước 1: Cài đặt Claude Code
Claude Code được phân phối qua npm. Mở terminal và chạy lệnh sau để cài đặt toàn cục:
npm install -g @anthropic-ai/claude-codeSau khi cài đặt hoàn tất, xác nhận bằng cách kiểm tra phiên bản:
claude --versionNếu terminal hiển thị số phiên bản (ví dụ: 1.x.x), bạn đã cài đặt thành công.
Cài đặt Node.js (nếu chưa có)
Nếu bạn chưa có Node.js hoặc đang dùng phiên bản cũ hơn 18, hãy cài đặt theo hệ điều hành:
Windows:
winget install OpenJS.NodeJS.LTSmacOS:
brew install nodeLinux (Ubuntu/Debian):
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejsSau khi cài Node.js, hãy đóng và mở lại terminal trước khi tiếp tục.
Bước 2: Cấu hình kết nối AISieuRe
Có hai cách để kết nối Claude Code với AISieuRe: cài đặt tự động (khuyến nghị) hoặc cấu hình thủ công. Cách tự động đơn giản hơn và đã được tối ưu sẵn.
Cách 1: Cài đặt tự động (Khuyến nghị)
AISieuRe cung cấp install script tự động thiết lập mọi thứ chỉ với một lệnh duy nhất. Đây là cách nhanh nhất và ít lỗi nhất:
- Đăng nhập vào Dashboard → API Keys
- Tìm API key bạn muốn sử dụng, nhấn nút Windows hoặc Linux/macOS bên cạnh key đó để copy lệnh cài đặt
- Mở terminal, paste lệnh vừa copy và nhấn Enter
- Đợi script chạy xong — toàn bộ quá trình mất khoảng 10–15 giây
Mẹo: Lệnh copy từ Dashboard đã chứa sẵn API key của bạn — chỉ cần paste và chạy, không cần chỉnh sửa gì thêm.
Nếu muốn chạy install script thủ công (không qua Dashboard), bạn có thể dùng lệnh chung:
Windows (PowerShell):
irm https://aisieure.com/install.ps1 | iexLinux / macOS:
curl -fsSL https://aisieure.com/install.sh | bashInstall script thực hiện những gì?
Script tự động thực hiện 4 bước, tương đương với toàn bộ quá trình cấu hình thủ công:
| Bước | Hành động | Chi tiết |
|---|---|---|
| 1 | Thiết lập biến môi trường | Gán ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN. Windows lưu vào User Environment scope, Linux/macOS ghi vào ~/.bashrc và ~/.zshrc |
| 2 | Cài statusline script | Tải và cấu hình script hiển thị thông tin credit còn lại trên thanh trạng thái của Claude Code, giúp bạn theo dõi chi phí realtime |
| 3 | Cấu hình settings.json | Tạo hoặc cập nhật file ~/.claude/settings.json với endpoint AISieuRe, model mặc định (Haiku, Sonnet, Opus), và tắt login prompt của Anthropic |
| 4 | Xác minh cấu hình | Kiểm tra tất cả file và biến môi trường đã được thiết lập chính xác, báo kết quả pass/fail cho từng mục |
An toàn: Script sẽ tự động backup file
settings.jsoncũ (nếu có) trước khi ghi đè. File backup được lưu cùng thư mục với hậu tố.backup.
Cách 2: Cấu hình thủ công
Nếu bạn muốn kiểm soát hoàn toàn quá trình cấu hình, hoặc install script không hoạt động trên môi trường của bạn, hãy thực hiện hai bước sau:
Bước 2a: Thiết lập biến môi trường
Windows (PowerShell) — lưu vĩnh viễn vào User scope:
# Thiết lập endpoint AISieuRe
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://aisieure.com", "User")
# Thiết lập API key (thay key_xxx bằng key thực tế của bạn)
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "key_xxx", "User")Linux / macOS — thêm vào shell profile:
Mở file ~/.bashrc (hoặc ~/.zshrc nếu bạn dùng zsh) và thêm hai dòng sau vào cuối file:
export ANTHROPIC_BASE_URL="https://aisieure.com"
export ANTHROPIC_AUTH_TOKEN="key_xxx"Sau đó áp dụng thay đổi ngay lập tức:
# Cho bash
source ~/.bashrc
# Cho zsh
source ~/.zshrcBước 2b: Cập nhật settings.json
Tạo hoặc chỉnh sửa file ~/.claude/settings.json với nội dung sau:
{
"env": {
"ANTHROPIC_BASE_URL": "https://aisieure.com",
"ANTHROPIC_AUTH_TOKEN": "key_xxx",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.6"
},
"disableLoginPrompt": true
}Quan trọng:
- Thay
key_xxxbằng API key thực tế từ Dashboard- URL phải là
https://aisieure.com— không có dấu/cuối, không có/v1- Nếu thư mục
~/.claude/chưa tồn tại, hãy tạo nó trước:mkdir -p ~/.claude(Linux/macOS) hoặcmkdir "$env:USERPROFILE\.claude"(Windows)
Bước 3: Kiểm tra kết nối
Sau khi cấu hình xong (dù bằng cách tự động hay thủ công), hãy mở một terminal mới để đảm bảo biến môi trường được nạp, rồi thực hiện kiểm tra:
Kiểm tra nhanh
Chạy Claude Code với một câu hỏi đơn giản:
claude "Xin chào, bạn là model nào? Hãy cho biết tên model chính xác."Nếu nhận được phản hồi cho biết tên model (ví dụ: Claude Sonnet 4.6), kết nối đã hoạt động.
Kiểm tra chi tiết bằng /status
- Mở phiên Claude Code interactive:
claude - Nếu được hỏi "Do you want to use this API key?", chọn Yes
- Gõ lệnh
/statustrong phiên Claude Code để xem thông tin chi tiết:- Model đang sử dụng
- Endpoint kết nối
- Credit còn lại (nếu statusline đã được cài)
Xác nhận biến môi trường đã được thiết lập
Nếu Claude Code không kết nối được, hãy kiểm tra biến môi trường:
Windows (PowerShell):
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKENLinux / macOS:
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKENCả hai lệnh phải trả về giá trị tương ứng (https://aisieure.com và key_xxx...). Nếu trả về trống, biến môi trường chưa được thiết lập — hãy quay lại Bước 2.
Chọn model Claude
AISieuRe hỗ trợ nhiều model Claude với mức giá và năng lực khác nhau. Bạn có thể chuyển đổi model linh hoạt tùy theo nhu cầu:
| Model ID | Tên | Context | Credits (input / output / 1M tokens) | Phù hợp cho |
|---|---|---|---|---|
claude-haiku-4.5 |
Claude Haiku 4.5 | 200K | 1 / 5 | Tác vụ nhanh, tiết kiệm: autocomplete, giải thích code, refactor nhỏ |
claude-sonnet-4 |
Claude Sonnet 4 | 216K | 2 / 10 | Coding hàng ngày, cân bằng chất lượng và chi phí |
claude-sonnet-4.5 |
Claude Sonnet 4.5 | 200K | 3 / 15 | Coding nâng cao, phân tích phức tạp |
claude-sonnet-4.6 |
Claude Sonnet 4.6 | 200K | 3 / 15 | Model Sonnet mới nhất, hiệu suất tốt nhất trong dòng Sonnet |
claude-opus-4.5 |
Claude Opus 4.5 | 200K | 5 / 25 | Tác vụ phức tạp, kiến trúc hệ thống, debug khó |
claude-opus-4.6 |
Claude Opus 4.6 | 200K | 5 / 25 | Model Opus mới nhất, chất lượng cao nhất |
claude-opus-4.6-fast |
Claude Opus 4.6 (fast) | 200K | 8 / 30 | Opus với tốc độ phản hồi nhanh hơn, phí cao hơn một chút |
Chuyển model trong Claude Code
Bạn có thể chuyển model ngay trong phiên Claude Code bằng lệnh /model:
# Trong phiên Claude Code interactive
/model claude-sonnet-4.6
# Hoặc chọn tên preset
/model opus # → sử dụng ANTHROPIC_DEFAULT_OPUS_MODEL
/model sonnet # → sử dụng ANTHROPIC_DEFAULT_SONNET_MODEL
/model haiku # → sử dụng ANTHROPIC_DEFAULT_HAIKU_MODELBạn cũng có thể chỉ định model khi khởi chạy Claude Code:
claude --model claude-opus-4.6 "Phân tích kiến trúc dự án này"Chiến lược chọn model tiết kiệm
Để tối ưu chi phí, bạn nên kết hợp nhiều model tùy tác vụ:
- Haiku 4.5 cho các câu hỏi nhanh, giải thích code, tạo commit message, viết comment
- Sonnet 4.6 (mặc định) cho coding hàng ngày — viết function, debug, refactor, viết test
- Opus 4.6 cho các tác vụ phức tạp — thiết kế kiến trúc, debug issue khó, phân tích codebase lớn
Các lệnh Claude Code hữu ích
Dưới đây là một số lệnh và cách sử dụng Claude Code hiệu quả với AISieuRe:
Chạy lệnh nhanh (không vào interactive mode)
# Giải thích một file code
claude "Giải thích file src/auth/middleware.ts làm gì"
# Tạo unit test
claude "Viết unit test cho function calculateTotal trong utils.js"
# Tìm và sửa bug
claude "Tìm bug trong file payment.service.ts và đề xuất cách sửa"Làm việc với dự án
# Mở Claude Code trong thư mục dự án
cd /path/to/your/project
claude
# Claude Code sẽ tự động đọc cấu trúc dự án và contextCác lệnh slash trong interactive mode
| Lệnh | Mô tả |
|---|---|
/status |
Xem trạng thái kết nối, model đang dùng, credit còn lại |
/model <tên> |
Chuyển sang model khác (haiku, sonnet, opus, hoặc model ID cụ thể) |
/clear |
Xóa context hiện tại, bắt đầu cuộc hội thoại mới |
/help |
Xem danh sách tất cả lệnh có sẵn |
/cost |
Xem chi phí token của phiên hiện tại |
Xử lý sự cố
Dưới đây là các lỗi phổ biến nhất khi cấu hình Claude Code với AISieuRe và cách khắc phục:
| Lỗi / Triệu chứng | Nguyên nhân | Cách khắc phục |
|---|---|---|
ANTHROPIC_API_KEY is not set |
Biến môi trường chưa được nạp | Mở terminal mới (bắt buộc sau khi cấu hình). Nếu vẫn lỗi, chạy lại install script |
Connection refused hoặc ECONNREFUSED |
URL endpoint sai | Kiểm tra ANTHROPIC_BASE_URL phải là https://aisieure.com — không có /v1 ở cuối, không có dấu / cuối |
Invalid API key hoặc 401 Unauthorized |
API key sai, hết hạn, hoặc bị thu hồi | Vào Dashboard → API Keys kiểm tra trạng thái key. Tạo key mới nếu cần |
Insufficient credits hoặc 402 |
Hết credit trong tài khoản | Vào trang nạp credit để nạp thêm |
| Claude Code yêu cầu đăng nhập Anthropic | disableLoginPrompt chưa được bật |
Kiểm tra file ~/.claude/settings.json có "disableLoginPrompt": true |
| Cấu hình không có hiệu lực sau khi sửa | File settings.json bị lỗi JSON syntax | Validate JSON tại jsonlint.com. Hoặc xóa file rồi chạy lại install script |
Model không tìm thấy (model_not_found) |
Dùng sai model ID | Kiểm tra model ID chính xác trong bảng model ở trên hoặc tại trang tài liệu |
Reset toàn bộ cấu hình
Nếu gặp vấn đề phức tạp, bạn có thể reset và cấu hình lại từ đầu:
Linux / macOS:
# Xóa cấu hình Claude Code
rm -rf ~/.claude/settings.json
# Xóa biến môi trường (xóa 2 dòng export trong ~/.bashrc hoặc ~/.zshrc)
# Sau đó chạy lại install script từ DashboardWindows (PowerShell):
# Xóa cấu hình Claude Code
Remove-Item "$env:USERPROFILE\.claude\settings.json" -ErrorAction SilentlyContinue
# Xóa biến môi trường
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User")
# Sau đó chạy lại install script từ DashboardCập nhật Claude Code
Anthropic thường xuyên cập nhật Claude Code. Để đảm bảo tương thích tốt nhất với AISieuRe:
# Kiểm tra phiên bản hiện tại
claude --version
# Cập nhật lên bản mới nhất
claude update
# Hoặc cập nhật qua npm
npm update -g @anthropic-ai/claude-codeBước tiếp theo
Bạn đã kết nối Claude Code với AISieuRe thành công. Dưới đây là một số hướng đi tiếp theo:
- Khám phá các model khác: Ngoài Claude, AISieuRe còn hỗ trợ GPT-4o, GPT-5, Gemini, và nhiều model khác qua API tương thích OpenAI. Xem tài liệu đầy đủ
- Tích hợp với IDE: Sử dụng AISieuRe API với Cursor, Continue.dev, hoặc các AI coding tool khác. Xem hướng dẫn tại trang tài liệu
- Theo dõi chi phí: Kiểm tra lượng credit sử dụng và lịch sử gọi API tại Dashboard
- Xem bảng giá: So sánh chi phí giữa các model và chọn gói phù hợp tại trang pricing
Cần hỗ trợ? Nếu gặp vấn đề không giải quyết được, hãy liên hệ chúng tôi qua thông tin hỗ trợ trên trang chủ AISieuRe.