Facade CodeClaude Code + nhà cung cấp của bạn
Giữ Claude Code làm CLI và nối một cấu hình khởi chạy với nhà cung cấp mô hình tương thích Anthropic khác.
Chuẩn bị thông tin nhà cung cấp
Cài Claude Code, sau đó lấy base URL tương thích Anthropic, khóa API và các ID mô hình từ nhà cung cấp của bạn. Chỉ có endpoint tương thích OpenAI thì không dùng được với Claude Code.
Ví dụ này tạo một mục riêng tên Claude · work. Các mục Claude Code khác của bạn vẫn giữ cài đặt hiện có.
1. Thêm cấu hình nhà cung cấp
Thêm cấu hình này vào facade.json (xem Cài đặt agent). Thay URL, khóa và ID mô hình trong ví dụ bằng giá trị từ nhà cung cấp của bạn:
{
"clis": {
"Claude · work": {
"type": "claude",
"model": "YOUR_MODEL_ID",
"env": {
"ANTHROPIC_BASE_URL": "https://api.example.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_API_KEY": null,
"ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_SMALL_MODEL_ID"
}
}
}
}Hãy dùng mô hình mà nhà cung cấp hỗ trợ cho từng alias. Ánh xạ Haiku dùng cho các tác vụ nền nhỏ hơn, nên có thể dùng mô hình khác với mô hình chính.
2. Kiểm tra endpoint và ánh xạ mô hình
| Cài đặt | Tác dụng |
|---|---|
ANTHROPIC_BASE_URL | Chuyển Claude Code sang API tương thích Anthropic của nhà cung cấp. |
ANTHROPIC_AUTH_TOKEN | Cung cấp token của nhà cung cấp. |
ANTHROPIC_API_KEY: null | Loại bỏ khóa API Anthropic được kế thừa cho cấu hình này. |
model | Đặt mô hình khởi đầu cho mục này. |
ANTHROPIC_DEFAULT_…_MODEL | Ánh xạ yêu cầu Opus, Sonnet và Haiku sang ID mô hình của nhà cung cấp. |
Ví dụ này lưu khóa ngay trong facade.json. Nếu muốn đọc một biến môi trường có sẵn, hãy dùng "ANTHROPIC_AUTH_TOKEN": "${env:WORK_API_KEY}". Trình soạn thảo phải có biến đó trước khi agent khởi chạy.
Các biến này chỉ áp dụng cho agent khởi chạy bằng mục này. Bạn không cần sửa cài đặt Claude Code toàn cục.
3. Khởi chạy Claude Code với cấu hình này
Lưu facade.json, chọn New Agent và chọn Claude · work. Giao cho agent một nhiệm vụ ngắn trong dự án của bạn.
Nếu nhà cung cấp có báo cáo mức sử dụng, hãy xác nhận yêu cầu xuất hiện ở đúng tài khoản. Nếu agent không khởi chạy được hoặc yêu cầu thất bại, hãy chạy Show Agent Launch và chọn vị trí làm việc. Tìm mục này trong báo cáo để xem Facade sẽ khởi chạy nó như thế nào.
Với lỗi xác thực hoặc lỗi thiếu mô hình, xem Khắc phục sự cố.
Ví dụ: QwenCloud
Với khóa QwenCloud Token Plan, hãy dùng https://token-plan.maas.qwencloudapi.com/apps/anthropic làm base URL. Chọn các ID mô hình có trong gói của bạn. Khóa trả theo mức sử dụng dùng endpoint theo khu vực.