GLM-5.2, GLM-5.3 và GLM-5.3-Flash trong Claude Code: Cấu hình và chuyển đổi mô hình
Thiết lập GLM trong Claude Code bằng APIMaster. Cấu hình settings.json trên Windows, macOS và Linux, khởi chạy claude, chọn mô hình bằng /model và bắt đầu trò chuyện.
Cấu hình APIMaster trong settings.json, chạy claude, sau đó nhập /model MODEL_ID trong cuộc hội thoại để sử dụng GLM. Các ID khả dụng được đề cập trong hướng dẫn này là glm-5.2, glm-5.3, glm-5.3-flash. Claude Code là ứng dụng khách; GLM là mô hình trả lời.
Trước khi bắt đầu
Hoàn tất kiểm tra môi trường và thiết lập Claude Code. Lấy khóa API APIMaster với số dư đủ dùng và quyền truy cập vào các mô hình đã chọn.
claude --version
URL gốc của gateway là https://apimaster.ai, không có /v1. Claude Code tự động thêm /v1/messages.
1. Mở thư mục cấu hình
Windows
Nhấn Win + R, nhập đường dẫn sau và nhấn Enter:
%USERPROFILE%\.claude
Tạo thư mục nếu cần. Mở hoặc tạo settings.json. Đảm bảo tệp không có tên settings.json.txt.
macOS / Linux
Trên macOS, trong Finder nhấn Command + Shift + G và nhập:
~/.claude
Trên Linux, mở cùng thư mục đó bằng trình quản lý tệp hoặc trình soạn thảo của bạn. Tạo thư mục nếu cần:
mkdir -p ~/.claude
Mở hoặc tạo settings.json tại đó. Nếu bạn đặt thư mục cấu hình Claude Code tùy chỉnh, hãy sử dụng thư mục đó thay thế.
2. Chỉnh sửa settings.json
Windows, macOS và Linux sử dụng cùng một cấu hình. Thay YOUR_APIMASTER_API_KEY bằng khóa APIMaster của bạn:
{
"model": "glm-5.3",
"env": {
"ANTHROPIC_BASE_URL": "https://apimaster.ai",
"ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
"ANTHROPIC_AUTH_TOKEN": "",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
}
}
Nếu tệp đã tồn tại, hãy sao lưu nó và hợp nhất các trường này vào đối tượng JSON hiện có và đối tượng env. Giữ lại các cài đặt khác mà bạn cần. Không thêm một đối tượng JSON thứ hai hoặc trùng lặp khóa env. JSON không cho phép chú thích hoặc dấu phẩy thừa ở cuối.
Hướng dẫn Claude Code chung trình bày xác thực bằng token. Hướng dẫn này sử dụng xác thực bằng khóa API đã được kiểm chứng trong các bài kiểm tra tích hợp của chúng tôi. Giữ ANTHROPIC_AUTH_TOKEN trống khi sử dụng ANTHROPIC_API_KEY, và xóa các thông tin xác thực xung đột khỏi cài đặt khác hoặc terminal của bạn. Sử dụng khóa APIMaster cho gateway này.
Trường model đặt mô hình khởi động. Bạn có thể chọn mô hình khác sau khi khởi chạy. Giữ tệp cài đặt người dùng này ở chế độ riêng tư; không commit khóa thật vào kho lưu trữ dùng chung. Lưu tệp và khởi động lại Claude Code để nạp cấu hình mới.
3. Khởi chạy Claude Code
Trong một terminal được mở tại thư mục dự án của bạn, chạy:
claude
Hoàn tất các bước nhắc lần đầu chạy bình thường và xem lại bước nhắc tin cậy dự án. Mô hình khởi động phải là glm-5.3. Đây là phiên tương tác bình thường với các công cụ và cài đặt dự án thông thường.
4. Chọn mô hình và bắt đầu trò chuyện
Trong cuộc hội thoại Claude Code, nhập một trong các lệnh sau và nhấn Enter:
/model glm-5.2
/model glm-5.3
/model glm-5.3-flash
Chạy từng dòng một, chọn mô hình bạn muốn. Sau khi Claude Code xác nhận việc chuyển đổi, gửi một tin nhắn ngắn:
Reply with exactly OK.
Một câu trả lời văn bản bình thường xác nhận kết nối cơ bản. Sau đó bạn có thể tiếp tục trò chuyện hoặc yêu cầu nó làm việc trên dự án của bạn. Để chuyển đổi lại trong cùng cuộc hội thoại, nhập một lệnh /model MODEL_ID khác.
Chỉ nhập /model sẽ mở trình chọn mô hình. Các ID gateway tùy chỉnh có thể không xuất hiện trong danh sách mặc định của nó. Thay vào đó, hãy gõ toàn bộ ID như hiển thị ở trên. Lệnh slash thuộc về bên trong Claude Code, không phải trong PowerShell hay Bash. Các tên mô hình mô tả các mô hình GLM, không phải Claude Sonnet hay Opus.
Bạn cũng có thể chọn mô hình khi khởi chạy từ terminal. Chạy từng lệnh một:
claude --model glm-5.2
claude --model glm-5.3
claude --model glm-5.3-flash
Để đặt mặc định rõ ràng cho các phiên sau này, hãy chỉnh sửa model trong settings.json. Cờ khởi chạy, biến môi trường ANTHROPIC_MODEL, hoặc cài đặt dự án/quản lý có thể ảnh hưởng đến mô hình được chọn; hãy kiểm tra các yếu tố này nếu mô hình khởi động khác với giá trị bạn đã lưu.
Khắc phục sự cố
| Triệu chứng | Cần kiểm tra |
|---|---|
| 401 / bước nhắc đăng nhập bất thường | Kiểm tra khóa APIMaster, URL gốc và các biến xác thực xung đột; khởi động lại CLI sau khi chỉnh sửa cài đặt. |
| 404 | Sử dụng https://apimaster.ai, không có /v1 hay /v1/messages. |
| Cài đặt không có hiệu lực | Kiểm tra vị trí tệp, JSON hợp lệ và các ghi đè từ terminal, dự án hoặc cài đặt quản lý. |
| Không thấy mô hình trong trình chọn | Nhập /model MODEL_ID với ID chính xác, hoặc khởi chạy bằng claude --model MODEL_ID. |
| Mô hình không khả dụng / 403 | Kiểm tra chính tả, các mô hình được phép của khóa, số dư tài khoản và tình trạng khả dụng của tuyến hiện tại. |
unrecognized_model |
Được quan sát với các ID tùy chỉnh trong quá trình kiểm tra của chúng tôi. Kiểm tra câu trả lời thực tế và kết quả công cụ; các mặc định năng lực Claude tích hợp sẵn chưa được xác minh cho GLM. |
| Tệp hoặc lệnh bị từ chối quyền | Xem lại và phê duyệt thao tác mong muốn qua các bước nhắc quyền thông thường. |
| 429 / 5xx / phản hồi bị gián đoạn | Giữ lại lỗi, ID mô hình, phiên bản CLI, giờ UTC và ID yêu cầu nếu có để hỗ trợ. |
Xác thực và chẩn đoán tùy chọn
Các bài kiểm tra tích hợp đã ghi lại: 2026-09-15 UTC, Claude Code 2.1.239, Linux. Tất cả các mô hình được liệt kê ở đây đều trả về văn bản mong đợi và đọc một tệp cục bộ qua công cụ. Cả ba mô hình cũng hoàn thành một tác vụ sửa lỗi và chạy kiểm tra Python nhỏ, được kiểm tra độc lập sau đó. Windows và macOS không thuộc các lần chạy đã ghi lại này.
Các bước kiểm tra tự động trước đó sử dụng chế độ bare để cô lập cấu hình. Việc sử dụng hàng ngày bình thường tuân theo settings.json và các bước tương tác ở trên. Chế độ bare và --setting-sources "" bỏ qua các tích hợp bình thường hoặc cài đặt đã lưu, vì vậy không nên thêm chúng vào lệnh khởi động hàng ngày trong hướng dẫn này.
Để kiểm tra nhanh không tương tác bằng cấu hình đã lưu của bạn:
claude --model glm-5.3 -p "Reply with exactly OK."
Để kiểm tra công cụ, tạo probe.txt chứa FILE_PROBE_739182, khởi chạy Claude Code trong thư mục đó và yêu cầu nó đọc tệp bằng công cụ và trả về nội dung chính xác của tệp. Xác nhận rằng công cụ thực sự chạy.
Đây là các bước kiểm tra tích hợp có giới hạn, không phải sự đảm bảo cho mọi tính năng của Claude Code, hành vi phiên dài hoặc ngữ cảnh tối đa. Tài liệu gateway của Anthropic không chính thức hỗ trợ định tuyến Claude Code đến các mô hình không phải Claude; hướng dẫn này mô tả tích hợp của APIMaster.
Câu hỏi thường gặp
Bản đăng ký Claude của tôi có trả tiền cho các yêu cầu này không?
Không. Với cấu hình APIMaster này, các yêu cầu sử dụng khóa và số dư APIMaster của bạn.
Tôi có thể tiếp tục trò chuyện sau khi chuyển đổi mô hình không?
Có, hãy sử dụng lệnh chuyển đổi mô hình trong cuộc hội thoại đang mở và đợi xác nhận trước khi gửi tin nhắn tiếp theo. Để so sánh sạch giữa các mô hình, hãy bắt đầu một phiên riêng biệt với claude --model MODEL_ID.