Tích hợp Claude Code CLI

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

Thông tin kết nối

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

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

Mô hìnhclaude-opus-5-5

Đị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). Script ghi cấu hình vào file cấu hình riêng của Claude Code là ~/.claude/settings.json và bỏ qua màn hình đăng nhập chính thức: không cần source, không cần mở lại terminal, chạy claude ngay.

Windows

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

macOS / Linux

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

Script cũng comment lại các biến ANTHROPIC_* cũ trong ~/.bashrc / ~/.zshrc (file gốc được sao lưu thành *.byesu-bak.<thời gian>) để Key cũ không đè lên cấu hình mới; bản Windows sẽ xóa các biến môi trường người dùng cùng tên.

Cách 2: Tự viết file cấu hình

① ~/.claude/settings.json (Windows: C:\Users\<tên bạn>\.claude\settings.json; nếu file đã có thì chỉ thêm khối env):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://byesu.si",
    "ANTHROPIC_AUTH_TOKEN": "sk-token-của-bạn"
  }
}

② ~/.claude.json (cũng ở thư mục home): thêm "hasCompletedOnboarding": true vào cặp { } ngoài cùng, hoặc tạo file mới với nội dung:

{
  "hasCompletedOnboarding": true
}

Nếu thiếu dòng này, lần chạy đầu sẽ hiện màn hình đăng nhập claude.ai (mở link, dán code) — đó là đăng nhập tài khoản Anthropic, dùng Byesu thì không cần.

Lưu ý

• ANTHROPIC_BASE_URL là https://byesu.si (định dạng Anthropic, không có /v1).
• Dùng ANTHROPIC_AUTH_TOKEN, không dùng ANTHROPIC_API_KEY: biến sau khiến Claude Code hỏi xác nhận API Key trước.
• Nếu shell vẫn còn export ANTHROPIC_API_KEY cũ, nó sẽ đè lên cấu hình trên: chạy unset ANTHROPIC_API_KEY, hoặc xóa dòng đó khỏi ~/.bashrc / ~/.zshrc rồi mở terminal mớ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-5-5"   # 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 shell vẫn còn ANTHROPIC_API_KEY cũ (chạy unset ANTHROPIC_API_KEY hoặc mở terminal mới) (chi tiết)
• Claude Code mở màn hình đăng nhập claude.ai và đòi dán code → Cấu hình chưa có hiệu lực: chạy lại script một dòng ở trên, hoặc thêm hasCompletedOnboarding vào ~/.claude.json như Cách 2
• 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