Hướng Dẫn Cài Đặt & Sử Dụng Claude Code

Claude Code là một trợ lý lập trình AI mạnh mẽ, cho phép bạn cộng tác với AI ngay trong terminal (giao diện dòng lệnh). Hướng dẫn này sẽ giúp bạn cài đặt và cấu hình công cụ này.

📋 Yêu cầu hệ thống (System Requirements)

Node.js phiên bản ≥ 18.0

Hệ điều hành được hỗ trợ: macOS, Linux, Windows (qua WSL)

🚀 Bắt đầu nhanh (Quick Start)

1. Cài đặt Node.js

💡 Gợi ý: Nếu bạn đã cài Node.js phiên bản ≥ 18.0, có thể bỏ qua bước này.

Người dùng Ubuntu / Debian

Người dùng macOS

2. Cài đặt Claude Code

Sử dụng npm để cài đặt toàn cục:

3. Cấu hình và sử dụng (Configuration & Usage)

Thông tin cấu hình cần thiết:

Thông số (Key)	Giải thích	Cách lấy
ANTHROPIC_AUTH_TOKEN	Mã xác thực API	Lấy trong trang `API令牌` sau khi đăng ký (bắt đầu bằng `sk-`)
ANTHROPIC_BASE_URL	Địa chỉ dịch vụ API	Sử dụng `https://api.key4u.shop`

📝 Gợi ý khi tạo token:
Tên: đặt tùy ý
Hạn mức: chọn không giới hạn
Nhóm: chọn az thuần hoặc chuyển từ bản chính sang Claude 3
Các mục khác giữ mặc định

Khởi chạy Claude Code

Trên hệ thống Linux/macOS:

Trên Windows (PowerShell):

cd your-project-folder
$env:ANTHROPIC_BASE_URL = "https://api.key4u.shop"
$env:ANTHROPIC_AUTH_TOKEN = "sk-..."
$env:API_TIMEOUT_MS = "300000"
claude

Cấu hình lần đầu (Initial Setup)

Khi khởi động, bạn sẽ thấy các bước cấu hình:

Chọn giao diện (Theme) → chọn theme yêu thích + nhấn Enter

Thông báo bảo mật (Security Notice) → xác nhận + Enter

Cấu hình Terminal → chọn mặc định + Enter

Tin tưởng thư mục làm việc (Trust Working Directory) → chọn "tin tưởng" + Enter

✨ Chúc mừng! Bạn đã sẵn sàng để cộng tác lập trình cùng AI!

❓ Hỏi & Đáp (FAQ)

A: Chưa thiết lập biến môi trường (environment variables). Hãy kiểm tra:

ANTHROPIC_AUTH_TOKEN và ANTHROPIC_BASE_URL đã được thiết lập chưa?

Token có đúng định dạng bắt đầu bằng sk- không?

Đã khởi động lại terminal sau khi thiết lập chưa?

Q: Trạng thái hiển thị "offline"?

A: Công cụ kiểm tra kết nối Google để đánh giá mạng. Dù hiện "offline", bạn vẫn có thể sử dụng bình thường.

Q: Fetch trang web thất bại?

A: Claude Code cần kiểm tra bảo mật trước khi truy cập web. Giải pháp:

Đảm bảo kết nối internet quốc tế ổn định

Dùng proxy hoặc VPN nếu cần

Q: Fetch luôn thất bại?

A: Có thể do mạng. Thử:

Dùng công cụ proxy (VPN, Shadowsocks, v.v.)

Q: Lỗi khi gọi API?

A: Thường do proxy không ổn định. Giải pháp:

Thoát khỏi Claude Code (Ctrl + C)

Khởi động lại bằng lệnh claude

Nếu vẫn lỗi, thử lại sau

Q: Lỗi đăng nhập trình duyệt?

A: Hãy xóa cookie của trang và đăng nhập lại.

📌 Lưu ý (Notes)

Dịch vụ này kết nối trực tiếp đến API Claude Code chính thức

Chỉ hỗ trợ lưu lượng từ Claude Code, không dùng được cho các API khác

Bảo mật token API của bạn – đừng chia sẻ công khai

🔗 Liên kết hữu ích (Resources)

Tài liệu chính thức Claude Code

Trang chủ Node.js

💡 Gợi ý: Nếu bạn gặp sự cố khác, hãy xem tài liệu chính thức hoặc liên hệ hỗ trợ kỹ thuật.

Hướng dẫn cài đặt và sử dụng Claude Code

Hướng Dẫn Cài Đặt & Sử Dụng Claude Code#

📋 Yêu cầu hệ thống (System Requirements)#

🚀 Bắt đầu nhanh (Quick Start)#

1. Cài đặt Node.js#

Người dùng Ubuntu / Debian#

Người dùng macOS#

2. Cài đặt Claude Code#

3. Cấu hình và sử dụng (Configuration & Usage)#

Thông tin cấu hình cần thiết:#

Khởi chạy Claude Code#

Trên hệ thống Linux/macOS:#

Trên Windows (PowerShell):#

Cấu hình lần đầu (Initial Setup)#

❓ Hỏi & Đáp (FAQ)#

Q: Lỗi "Invalid API Key · Please run /login"?#

Q: Trạng thái hiển thị "offline"?#

Q: Fetch trang web thất bại?#

Q: Fetch luôn thất bại?#

Q: Lỗi khi gọi API?#

Q: Lỗi đăng nhập trình duyệt?#

📌 Lưu ý (Notes)#

🔗 Liên kết hữu ích (Resources)#