ddshub.cc LogoDDS Hub

Cài đặt Claude Code

Phần này trình bày toàn bộ quy trình cài đặt Claude Code CLI trên macOS và Windows, cũng như cách kết nối tới nút trung chuyển của DDShub.

Cài đặt trên Mac

Cài Node.js qua Brew

Claude Code cần Node.js. Chúng tôi khuyến nghị dùng Homebrew để quản lý các phiên bản Node.js.

1

Cài Homebrew

bash
# Tải và cài đặt Homebrew
curl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash
2

Cài Node.js

bash
# Tải và cài đặt Node.js
brew install node

# Kiểm tra phiên bản Node.js
node -v

# Kiểm tra phiên bản NPM
npm -v

Cài Claude Code

Claude Code là công cụ CLI lập trình AI chính thức của Anthropic, được cài toàn cục qua npm.

1

Cài Claude Code CLI toàn cục

bash
npm install -g @anthropic-ai/claude-code
2

Kiểm tra cài đặt

bash
claude --version
# Claude Code x.x.x

Nếu gặp lỗi quyền truy cập, hãy thêm sudo vào trước lệnh, hoặc cấu hình thư mục npm toàn cục về thư mục người dùng của bạn.

3

Chạy kiểm tra sức khỏe

bash
claude doctor

Lệnh này kiểm tra cấu hình môi trường của bạn, bao gồm cả khả năng kết nối API.

Mẹo
Nếu gặp sự cố mạng trong quá trình cài đặt, hãy tạm thời đặt registry của npm: npm config set registry https://registry.npmmirror.com
Lưu ý
Yêu cầu Claude Code v2.1.68 trở lên.

Cấu hình AUTH_TOKEN & BASE_URL

Cấu hình nút trung chuyển API của DDShub để Claude Code kết nối tới dịch vụ Anthropic qua điểm cuối tăng tốc của chúng tôi.

Ghi chú
Trước bước này, hãy đảm bảo bạn đã đăng ký trên DDShub và tạo một API Token. Nếu chưa, vui lòng đọc phần "Tạo Token & API Key" trước.

Cách 1: Biến môi trường (Khuyến nghị)

Thêm nội dung sau vào tệp cấu hình shell của bạn (~/.zshrc hoặc ~/.bashrc):

~/.zshrc
# DDShub - cấu hình trung chuyển Claude Code
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxx"   # Thay bằng API Key của bạn
export ANTHROPIC_BASE_URL="https://www.ddshub.cc"

Sau khi lưu, hãy nạp lại cấu hình:

bash
source ~/.zshrc

# Kiểm tra cấu hình
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

Cách 2: Đăng nhập tương tác

Chạy trực tiếp lệnh claude và CLI sẽ hướng dẫn bạn hoàn tất thiết lập:

bash
claude

# Bạn sẽ được nhắc nhập:
# > Enter your API key: sk-xxx
# > Enter API base URL (optional): https://www.ddshub.cc
Lưu ý
Hãy giữ API Token của bạn an toàn. Đừng bao giờ đưa nó vào Git hoặc chia sẻ. Nếu bị lộ, hãy thu hồi ngay trong bảng điều khiển DDShub.

Kiểm tra kết nối

Sau khi cấu hình, chạy lệnh trong thư mục dự án bất kỳ:

bash
claude "Hello, introduce yourself in one sentence"

# Kết quả mong đợi:
# I am Claude, an AI assistant made by Anthropic.

Cài đặt trên Windows

Lưu ý
Yêu cầu: Windows 10 (phiên bản 1809 / build 17763) trở lên

Cài Node.js qua PowerShell

Chúng tôi khuyến nghị cài Node.js qua trình quản lý gói Chocolatey để dễ quản lý phiên bản.

1

Mở PowerShell với quyền Quản trị viên

Nhấp chuột phải vào menu Start → chọn "Windows PowerShell (Admin)" hoặc "Terminal (Admin)".

2

Cài Chocolatey và Node.js

powershell
# Tải và cài đặt Chocolatey
powershell -c "irm https://community.chocolatey.org/install.ps1|iex"

# Cài Node.js qua Chocolatey
choco install nodejs --version="24.13.0"

# Kiểm tra phiên bản Node.js
node -v

# Kiểm tra phiên bản NPM
npm -v

Cài Claude Code

Sau khi cài Node.js, hãy cài Claude Code CLI toàn cục qua npm.

1

Cài Claude Code CLI toàn cục

powershell
npm install -g @anthropic-ai/claude-code
2

Kiểm tra cài đặt

powershell
claude --version
# Claude Code x.x.x

Nếu gặp lỗi quyền truy cập, hãy mở lại PowerShell với quyền Quản trị viên.

Mẹo
Nếu cài npm chậm, hãy tạm thời đổi registry: npm config set registry https://registry.npmmirror.com
Lưu ý
Yêu cầu Claude Code v2.1.68 trở lên.

Cấu hình AUTH_TOKEN & BASE_URL

Trên Windows, chúng tôi khuyến nghị lưu cấu hình lâu dài qua Biến môi trường hệ thống hoặc PowerShell Profile.

Ghi chú
Trước bước này, hãy đảm bảo bạn đã đăng ký trên DDShub và tạo một API Token. Nếu chưa, vui lòng đọc phần "Tạo Token & API Key" trước.

Cách 1: PowerShell Profile (Khuyến nghị)

Chạy lệnh sau trong PowerShell để mở tệp Profile của bạn:

$PROFILE
# Hiển thị đường dẫn Profile
echo $PROFILE

# Chỉnh sửa Profile (tự tạo nếu chưa tồn tại)
notepad $PROFILE

Thêm nội dung sau vào cuối tệp rồi lưu lại:

$PROFILE
# DDShub - cấu hình trung chuyển Claude Code
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxxxxxxxxxx"   # Thay bằng API Key của bạn
$env:ANTHROPIC_BASE_URL   = "https://www.ddshub.cc"

Mở lại PowerShell để cấu hình có hiệu lực, hoặc chạy ngay:

powershell
. $PROFILE

Cách 2: Biến môi trường hệ thống (GUI)

Phù hợp cho người dùng thích giao diện đồ họa:

1

Mở Biến môi trường hệ thống

Nhấp chuột phải "This PC" → "Properties" → "Advanced system settings" → "Environment Variables", hoặc tìm "environment variables" trong menu Start.

2

Tạo Biến người dùng mới

Trong phần "User variables", nhấn "New" và thêm:

Tên biếnGiá trị
ANTHROPIC_AUTH_TOKENsk-xxxxxxxx...
ANTHROPIC_BASE_URLhttps://www.ddshub.cc
3

Khởi động lại terminal và kiểm tra

powershell
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL

Kiểm tra kết nối

Sau khi cấu hình, chạy lệnh trong thư mục dự án bất kỳ:

powershell
claude "Hello, introduce yourself in one sentence"

# Kết quả mong đợi:
# I am Claude, an AI assistant made by Anthropic.
Lưu ý
Hãy giữ API Token của bạn an toàn. Đừng bao giờ đưa nó vào Git hoặc chia sẻ. Nếu bị lộ, hãy thu hồi ngay trong bảng điều khiển DDShub.