Trang chủ › Blog

Hướng dẫn kết nối Claude Code CLI với apicheap.store trên Windows và macOS

· apicheap.store

Claude Code là công cụ lập trình chạy trong terminal. Mặc định nó gọi thẳng máy chủ của Anthropic, nhưng bạn có thể trỏ nó sang một cổng API khác tương thích chuẩn Anthropic bằng vài biến môi trường. Bài này hướng dẫn trỏ Claude Code sang apicheap.store.

Trước khi bắt đầu

Bạn cần ba thứ:

  1. Tài khoản tại apicheap.store và số dư trong ví (nạp qua VietQR hoặc USDT).
  2. Một API key dạng sk-..., tạo trong mục API Keys của trang quản lý.
  3. Một model hoặc combo đã chọn cho key đó. Nếu bỏ qua bước này, công cụ sẽ báo lỗi thiếu model.

Combo là nhóm nhiều model được xoay vòng. Khi một model bận hoặc hết hạn mức, hệ thống chuyển sang model kế tiếp trong combo.

Cách nhanh nhất: chạy script cài đặt

Script sẽ hỏi API key, cho bạn chọn model hoặc combo, rồi lưu biến môi trường giúp bạn.

Trên Windows, mở PowerShell và chạy:

irm https://apicheap.store/setup.ps1 | iex

Trên macOS hoặc Linux, mở Terminal và chạy:

curl -fsSL https://apicheap.store/setup.sh | bash

Chạy xong, đóng terminal và mở lại để biến môi trường mới có hiệu lực.

Cách thủ công trên Windows

Mở PowerShell và chạy ba lệnh sau, thay sk-YOUR_API_KEY bằng key của bạn:

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://apicheap.store', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-YOUR_API_KEY', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'smart-live-combo', 'User')

Các biến này được lưu vĩnh viễn cho tài khoản Windows của bạn. Mở một cửa sổ PowerShell mới rồi gõ claude để bắt đầu.

Cách thủ công trên macOS

Thêm các dòng sau vào cuối file ~/.zshrc:

export ANTHROPIC_BASE_URL="https://apicheap.store"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_API_KEY"
export ANTHROPIC_MODEL="smart-live-combo"
export ANTHROPIC_DEFAULT_SONNET_MODEL="smart-live-combo"

Lưu file, chạy source ~/.zshrc, rồi gõ claude.

Ý nghĩa từng biến

Xử lý lỗi thường gặp

Claude Code vẫn đòi đăng nhập tài khoản Anthropic. Biến môi trường chưa có hiệu lực. Đóng hết cửa sổ terminal, mở lại, rồi kiểm tra bằng echo $env:ANTHROPIC_BASE_URL (Windows) hoặc echo $ANTHROPIC_BASE_URL (macOS).

Báo lỗi model không tồn tại. Key chưa được gán model hoặc tên trong ANTHROPIC_MODEL gõ sai. Vào trang quản lý để chọn lại model cho key, hoặc chạy lại script cài đặt.

Báo lỗi 401. Key sai, đã bị xoá, hoặc còn thừa dấu cách khi dán. Tạo key mới và dán lại.

Báo lỗi hết số dư. Nạp thêm tiền trong mục Nạp tiền. Số dư được cộng tự động sau khi hệ thống đối soát giao dịch.

Tiếp theo

Xem trang tài liệu kết nối để cấu hình thêm Codex CLI, Cursor và các thư viện Python. Bảng giá từng model có ở trang chủ.

Dùng thử API AI tại apicheap.store

Một API key dùng chung cho nhiều model, tương thích chuẩn OpenAI và Anthropic, nạp tiền bằng VietQR hoặc USDT.

Tạo tài khoản Xem hướng dẫn kết nối

Bài viết khác