Cách cài Claude Code với apmix trong hai phút

Claude Code là agent lập trình dòng lệnh của Anthropic: nó đọc kho mã của bạn, sửa tệp, chạy lệnh và viết kiểm thử. Nó giao tiếp với API của Anthropic, và apmix cung cấp chính API đó. Vì vậy bạn có thể chạy Claude Code bằng khóa apmix, với các mô hình Claude trong gói của bạn và một hạn mức hằng tháng thay vì một hóa đơn Anthropic riêng.

Hướng dẫn này mất khoảng hai phút. Bạn cần một tài khoản apmix có khóa API (tạo trong bảng điều khiển) và Node.js 18 trở lên.

1. Cài Claude Code#

Bỏ qua bước này nếu máy bạn đã chạy được claude.

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

2. Trỏ nó tới apmix#

Claude Code đọc ba biến môi trường. Vì nó dùng giao thức Anthropic, Base URL là https://api.apmix.ai không có /v1; Claude Code tự thêm đường dẫn.

Trên macOS hoặc Linux:

export ANTHROPIC_BASE_URL="https://api.apmix.ai"
export ANTHROPIC_AUTH_TOKEN="apx_live_YOUR_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"

Trên Windows, trong PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.apmix.ai"
$env:ANTHROPIC_AUTH_TOKEN = "apx_live_YOUR_KEY"
$env:ANTHROPIC_MODEL = "claude-sonnet-5"

Các giá trị này chỉ có hiệu lực trong terminal hiện tại. Rất hợp cho lần thử đầu tiên; bước tiếp theo sẽ lưu chúng vĩnh viễn.

3. Lưu vĩnh viễn#

Claude Code cũng đọc cấu hình từ ~/.claude/settings.json. Đặt cùng các giá trị đó vào khối env, và mọi terminal mới đều sẵn sàng:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apmix.ai",
    "ANTHROPIC_AUTH_TOKEN": "apx_live_YOUR_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}

Tài liệu có các lệnh một dòng cho PowerShell và bash để ghi tệp này giúp bạn, kèm bản sao lưu tệp cũ.

4. Chạy thử#

Mở dự án và khởi động Claude Code:

cd your-project
claude

Xong: giờ mọi yêu cầu đều đi qua apmix và được trừ vào hạn mức của gói.

Đổi mô hình bằng /model#

Trong Claude Code, gõ /model để đổi mô hình cho phiên làm việc, dùng bất kỳ id Claude nào trong danh mục:

Mỗi mô hình có hệ số token quy đổi riêng, liệt kê trên trang bảng giá. Dùng mô hình nhẹ hơn cho việc thường ngày giúp cùng một hạn mức dùng được lâu hơn nhiều; xem bài giải thích token quy đổi.

Kiểm tra khóa có hoạt động không#

Nếu có gì bất thường, hãy liệt kê các mô hình mà khóa của bạn gọi được. Nhận về một danh sách JSON nghĩa là khóa và URL đều đúng:

curl https://api.apmix.ai/v1/models -H "Authorization: Bearer apx_live_YOUR_KEY"

Các phản hồi thường gặp nhất và cách xử lý:

• 401 invalid_api_key: khóa sai hoặc đã bị xóa. Sao chép lại từ Bảng điều khiển → Khóa API.
• 403 model_not_in_plan: mô hình vượt quá gói của bạn. GET /v1/models chỉ liệt kê những gì gói của bạn gọi được; hãy chọn một trong số đó hoặc nâng cấp.
• 429 rate_limit_exceeded: hơn 60 yêu cầu mỗi phút trên một khóa (120 với Max). Hãy đợi số giây trong retry-after.

Mọi lỗi đều được giải thích trong tài liệu tra cứu lỗi, và mọi phản hồi đều có header x-apmix-request-id để bạn gửi kèm khi liên hệ hỗ trợ.

Theo dõi mức sử dụng#

Agent rất "ngốn": một phiên Claude Code dài có thể gửi hàng triệu token. Ba điều sau sẽ giúp bạn:

1. Xem Bảng điều khiển → Nhật ký, nơi hiển thị trực tiếp từng yêu cầu với mô hình, token và chi phí.
2. Đặt giới hạn theo ngày hoặc theo tuần tùy chọn trong Cài đặt, để một phiên chạy mất kiểm soát không dùng hết cả tháng.
3. Bật email cảnh báo khi dùng tới 50, 70, 80 hoặc 90% hạn mức.

Chuẩn bị như vậy, Claude Code trên apmix dùng y hệt Claude Code gốc, với một khóa và một hóa đơn cho mọi thứ khác bạn đang chạy.