Tích hợp Claude Code CLI

Độ khó ⌨️ Trung cấp (dòng lệnh)　|　Định dạng API Claude　|　base_url https://byesu.com

Thông tin kết nối

Địa chỉ APIhttps://byesu.com

Khóa APIsk-xxxxxxxxTạo trong bảng điều khiển →

Mô hìnhclaude-opus-4-8

Định dạng API Claude · tên mô hình theo bảng điều khiển

Claude Code là trợ lý lập trình dòng lệnh chính thức của Anthropic. Mặc định nó kết nối đến Anthropic, chúng ta dùng hai biến môi trường để trỏ nó về Byesu.

Trước khi bắt đầu

Trước tiên hãy vào Bảng điều khiển → Token để tạo một token thuộc nhóm Claude (xem Chọn nhóm). Hãy thay sk-xxxx ở phần dưới bằng token của chính bạn.

Bước 1: Cài đặt Claude Code

Chọn một trong hai cách:

Trình cài đặt gốc (không cần Node, khuyên dùng)

curl -fsSL https://claude.ai/install.sh | bash

npm (cần Node.js 18+)

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

Cách npm cần cài Node.js 18+ trước (nếu chưa có, hãy vào nodejs.org tải bản LTS). Người dùng Windows còn cần cài Git for Windows trước — Claude Code phụ thuộc vào Git Bash, thiếu nó thì khi khởi động sẽ báo lỗi.

Sau khi cài xong, kiểm tra lại:

claude --version

Bước 2: Trỏ về Byesu (chọn một trong hai)

Cách 1: Script một dòng (nhanh nhất, khuyên dùng)

Địa chỉ API chúng tôi đã viết sẵn vào script cho bạn —— sau khi chạy, bạn chỉ cần dán API Key của mình (sk-xxxx), nó sẽ tự động thiết lập hai biến môi trường ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY:

Windows

iex (irm 'https://docs.byesu.com/setup/claude.ps1')

macOS / Linux

curl -fsSL https://docs.byesu.com/setup/claude.sh | bash

Cách 2: Tự thiết lập hai biến môi trường thủ công

macOS / Linux

# Ghi vào ~/.zshrc hoặc ~/.bashrc, mở lại terminal để có hiệu lực
export ANTHROPIC_BASE_URL="https://byesu.com"
export ANTHROPIC_API_KEY="sk-token-của-bạn"

Windows PowerShell

setx ANTHROPIC_BASE_URL "https://byesu.com"
setx ANTHROPIC_API_KEY "sk-token-của-bạn"
# Mở lại PowerShell để có hiệu lực

Lưu ý

• ANTHROPIC_BASE_URL là https://byesu.com (định dạng Anthropic, không có /v1).
• Nếu một số phiên bản gặp lỗi xác thực, bạn có thể đổi ANTHROPIC_API_KEY thành ANTHROPIC_AUTH_TOKEN rồi thử lại.

Bước 3: Chọn model (tùy chọn)

Sau khi khởi động Claude Code, gõ /model là có thể chuyển đổi model; bạn cũng có thể dùng biến môi trường để chỉ định model mặc định:

export ANTHROPIC_MODEL="claude-opus-4-8"   # Mạnh nhất hiện tại; hoặc các model Claude khác trong bảng điều khiển

Bước 4: Chạy thử để kiểm tra

Vào bất kỳ thư mục dự án nào, khởi động:

claude

Bảo nó làm một việc nhỏ (chẳng hạn "liệt kê các tệp trong thư mục hiện tại"), nếu nó trả lời bình thường thì đã kết nối thành công ✅

Bị kẹt?

• 401 / Token không hợp lệ → Nhập sai Key, hoặc thử đổi ANTHROPIC_API_KEY thành ANTHROPIC_AUTH_TOKEN (chi tiết)
• Không có kênh khả dụng → Token không nằm trong nhóm Claude (Chọn nhóm, chi tiết)
• Số dư không đủ → Vào bảng điều khiển nạp tiền (chi tiết)
• Các trường hợp khác xem Lỗi thường gặp & cách giải quyết