GetCheapAI

Dùng dịch vụ trung chuyển API trong Claude Code

Trỏ Claude Code tới địa chỉ API tùy chỉnh bằng biến môi trường hoặc settings.json.

Đọc 3 phút

Claude Code hỗ trợ gửi yêu cầu tới một địa chỉ API tùy chỉnh, chỉ cần đặt biến môi trường tương ứng hoặc ghi vào tệp cấu hình. Bài viết này giới thiệu cách trỏ Claude Code tới một dịch vụ trung chuyển API tương thích với giao diện API của Anthropic.

Thông tin cần chuẩn bị

Trước khi bắt đầu, hãy lấy các thông tin sau từ nền tảng API mà bạn đang dùng:

  • Địa chỉ API (Base URL): địa chỉ gốc của API do nền tảng cung cấp
  • API key (khóa API): token dùng để xác thực
  • Tên mô hình: mã định danh mô hình (model ID) mà nền tảng hỗ trợ và bạn định dùng

Cách 1: Biến môi trường

Đặt các biến môi trường sau trong terminal (có thể ghi vào ~/.zshrc hoặc ~/.bashrc để giữ hiệu lực lâu dài):

export ANTHROPIC_BASE_URL="https://example.com"   # thay bằng địa chỉ API do nền tảng cung cấp
export ANTHROPIC_AUTH_TOKEN="your-key"            # thay bằng API key của bạn
export ANTHROPIC_MODEL="your-model-name"          # thay bằng tên mô hình mà nền tảng hỗ trợ

Sau khi đặt xong, hãy mở lại terminal rồi chạy claude, cấu hình sẽ có hiệu lực.

Cách 2: settings.json

Bạn cũng có thể ghi vào tệp cấu hình của Claude Code là ~/.claude/settings.json (toàn cục), hoặc .claude/settings.json nằm trong dự án:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://example.com",
    "ANTHROPIC_AUTH_TOKEN": "your-key",
    "ANTHROPIC_MODEL": "your-model-name"
  }
}

Khi cấu hình có chứa API key, nên dùng .claude/settings.local.json vì tệp này không được đưa vào quản lý phiên bản.

Câu hỏi thường gặp

  • Gặp lỗi 404: một số dịch vụ nhạy cảm với dấu gạch chéo ở cuối, bạn có thể thử thêm hoặc bỏ dấu / ở cuối địa chỉ API.
  • Tên mô hình không khớp: Claude Code không tự chuyển đổi tên mô hình, hãy đặt tên mô hình đúng với tên mà nền tảng nhận diện được.
  • Giao diện đồ họa không nhận cấu hình: ứng dụng giao diện đồ họa mở từ dock hoặc lối tắt sẽ không đọc các biến môi trường đặt trong terminal.
  • Xung đột với thuê bao: nếu bạn đồng thời đã đăng nhập tài khoản thuê bao Claude, địa chỉ tùy chỉnh sẽ ghi đè thuê bao; muốn quay lại dùng dịch vụ chính thức thì chỉ cần xóa các cấu hình trên.

Tìm hiểu thêm