Chuyển đến nội dung chính
Sử dụng hướng dẫn này để kết nối Claude Code với CometAPI. Tài liệu tham khảo chính thức:
Khả dụng của model thay đổi theo thời gian. Để xem ID model Claude hiện tại, hãy kiểm tra trang Models của CometAPI.

Điều kiện tiên quyết

  • Một khóa CometAPI từ dashboard của bạn (bắt đầu bằng sk-)
  • Đã cài đặt Git
  • Hệ điều hành được hỗ trợ: macOS, Linux hoặc Windows

Cài đặt Claude Code

1

Chạy trình cài đặt chính thức

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

Xác minh cài đặt

claude --version

Cấu hình endpoint CometAPI

Tạo hoặc chỉnh sửa tệp cài đặt:
  • macOS / Linux: ~/.claude/settings.json
  • Windows: %USERPROFILE%\.claude\settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-cometapi-key",
    "ANTHROPIC_BASE_URL": "https://api.cometapi.com"
  }
}
Thay sk-your-cometapi-key bằng khóa CometAPI thực tế của bạn, sau đó khởi động Claude Code:
cd your-project
claude

Khắc phục sự cố

settings.json không có hiệu lực?
  1. Khởi động lại hoàn toàn terminal của bạn (đóng tất cả cửa sổ rồi mở lại)
  2. Nếu vẫn không hoạt động, tạo ~/.claude.json và thêm:
    {
      "hasCompletedOnboarding": true
    }
    
  3. Như một phương án dự phòng, xuất trực tiếp các biến môi trường:
    # Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
    export ANTHROPIC_AUTH_TOKEN="sk-your-cometapi-key"
    export ANTHROPIC_BASE_URL="https://api.cometapi.com"
    
Invalid API Key hoặc Please run /login? Kiểm tra rằng ~/.claude/settings.json tồn tại và định dạng JSON hợp lệ (không có dấu phẩy thừa, dùng dấu ngoặc kép đúng). Xác thực tại jsonlint.com. Trước đó đã đăng nhập vào Anthropic chính thức? Claude Code ưu tiên thông tin xác thực chính thức được lưu trong bộ nhớ đệm. Chạy /logout bên trong Claude Code, đóng ứng dụng, rồi khởi động lại. Nếu vẫn lỗi:
rm -rf ~/.config/claude-code/auth.json
Trạng thái hiển thị offline? Claude Code kiểm tra kết nối thông qua Google. offline chỉ có nghĩa là không thể truy cập Google — điều này không ảnh hưởng đến việc sử dụng CometAPI. Fetch / duyệt web bị lỗi? Tính năng Fetch của Claude Code trước tiên gọi dịch vụ gốc của Anthropic, dịch vụ này yêu cầu truy cập internet trực tiếp. Có thể cần một proxy toàn hệ thống.