KONG API AI Tài liệu Bắt đầu miễn phí

Công cụ

Claude Code

Dùng Claude Code với khoá KONG API AI. Đặt địa chỉ API và khoá trong file cấu hình shell hoặc file cài đặt của Claude Code, rồi kiểm tra bằng /status.

Claude Code gửi yêu cầu tới KONG API AI khi bạn đặt địa chỉ API và khoá của bạn. Thay gw_live_… bằng khoá của bạn ở mọi bước dưới đây.

Trên Windows, Kong Connect cài tự động cho Claude Code. Bạn chỉ dán khoá một lần.

Cài Claude Code

Bỏ qua bước này nếu bạn đã có Claude Code.

macOS, Linux hoặc WSL:

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

Windows, trong PowerShell:

powershell
irm https://claude.ai/install.ps1 | iex

Hoặc dùng npm (cần Node.js 18 trở lên):

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

Cách nhanh: một lệnh

Lệnh dưới đây hỏi khoá của bạn mà không hiện lên màn hình, kiểm tra khoá với KONG API AI, rồi ghi cấu hình cho Claude Code và Codex như các bước bên dưới. File cũ được sao lưu trước khi sửa.

macOS hoặc Linux:

Terminal
curl -fsSL https://kongapiai.com/install.sh | bash

Windows, trong PowerShell:

powershell
irm https://kongapiai.com/install.ps1 | iex

Để gỡ ra, chạy curl -fsSL https://kongapiai.com/install.sh | bash -s -- --remove, hoặc trên Windows chạy $env:KONG_ACTION='remove' rồi chạy lại lệnh cài. Muốn xem lệnh làm gì trước khi chạy, mở địa chỉ của lệnh trong trình duyệt.

Cách 1: file cấu hình shell (macOS và Linux)

Thêm các dòng dưới đây vào ~/.zshrc hoặc ~/.bashrc:

Terminal
export KONG_API_KEY="gw_live_…"
export ANTHROPIC_BASE_URL="https://kongapiai.com"
export ANTHROPIC_AUTH_TOKEN="$KONG_API_KEY"
export ANTHROPIC_API_KEY="" # Bắt buộc để trống

Chạy source ~/.zshrc (hoặc source ~/.bashrc), hoặc mở một terminal mới.

ANTHROPIC_API_KEY phải để trống. Nếu biến này còn giữ một khoá Anthropic, Claude Code dùng khoá đó thay cho khoá KONG API AI.

Cách 2: file cài đặt của Claude Code (mọi hệ điều hành, gồm Windows)

Tạo file .claude/settings.local.json trong thư mục dự án:

JSON
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://kongapiai.com",
    "ANTHROPIC_AUTH_TOKEN": "gw_live_…",
    "ANTHROPIC_API_KEY": ""
  }
}

Muốn dùng cho mọi dự án, đặt cùng nội dung vào ~/.claude/settings.json (trên Windows: %USERPROFILE%\.claude\settings.json).

Không đặt các giá trị này trong file .env của dự án: Claude Code không đọc file đó.

Đăng xuất tài khoản Anthropic cũ

Nếu bạn từng đăng nhập Claude Code bằng tài khoản Anthropic, chạy /logout một lần trong Claude Code, rồi thoát và mở lại claude. Chưa từng đăng nhập thì bỏ qua bước này.

Bắt đầu

Terminal
cd /đường-dẫn/tới/dự-án
claude

Kiểm tra

Trong Claude Code, chạy /status. Kết quả cần có hai dòng:

text
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://kongapiai.com

Nếu dòng xác thực ghi ANTHROPIC_API_KEY hoặc một tài khoản Claude, cấu hình chưa tới được Claude Code: mở terminal mới rồi chạy lại claude. Sau vài yêu cầu, bạn thấy chúng trong trang Hoạt động của console.

Chọn model (không bắt buộc)

Mặc định, Claude Code tự chọn model. Để chọn model mới nhất của từng dòng đang bán trên KONG API AI, thêm vào cùng file cấu hình shell:

Terminal
export ANTHROPIC_DEFAULT_FABLE_MODEL="claude-fable-5-2"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"

Với file cài đặt của Claude Code, đặt cùng tên và giá trị trong phần env. Sau đó chạy /model để xem. Khoá chỉ gọi được những model nó được phép dùng: xem trang Model và giá.

Khi có lỗi

  • Không tìm thấy model: thường do một phiên đăng nhập Anthropic cũ (chạy /logout), hoặc một khoá Anthropic còn nằm trong ANTHROPIC_API_KEY.
  • Lỗi 401: khoá sai hoặc đã bị thu hồi. Sao chép lại khoá, hoặc tạo khoá mới trong console.
  • Lỗi 402: hết số dư hoặc hết hạn mức tháng của khoá. Xem Hạn mức và cách chọn nguồn.

Khoá trong file cấu hình shell được lưu dạng chữ thường. Đừng chia sẻ file đó.