CC-Switch Claude Code
Trang này chỉ giải thích một điều: thêm hoặc chọn Provider trong CC Switch, sau đó áp dụng cho Claude Code. Đây không phải là hướng dẫn cấu hình Claude Code trực tiếp; nếu bạn muốn chỉnh sửa trực tiếp tệp cấu hình Claude Code, vui lòng xem phần cấu hình Claude Code CLI.
Trang này giải thích những gì
Mục đích của CC Switch là giúp bạn quản lý tập trung các Provider và đồng bộ hóa cấu hình sang các công cụ mục tiêu. Đối với Claude Code, hãy tập trung kiểm tra giao thức Claude / Anthropic, Key và tên mô hình. Không trực tiếp sử dụng địa chỉ tương thích OpenAI làm địa chỉ Claude trừ khi nhà cung cấp nêu rõ rằng họ hỗ trợ Claude Code.
Xác nhận trước khi bắt đầu
| Điều cần xác nhận | Cách kiểm tra | Lý do |
|---|---|---|
| Claude Code hiện đã có thể khởi động | Xác nhận trong terminal hoặc client rằng Claude Code có thể mở bình thường | CC Switch chỉ xử lý việc chuyển đổi cấu hình, không hỗ trợ cài đặt Claude Code |
| Nhà cung cấp có hỗ trợ Claude Code | Bạn có thể thấy các hướng dẫn liên quan đến Claude / Anthropic / Claude Code trong trang quản trị hoặc tài liệu | Các nhà cung cấp chỉ cung cấp giao diện tương thích với OpenAI có thể không dùng được với Claude Code |
| Key và tên mô hình có thể sử dụng được | Bạn có thể thấy token, Key, danh sách mô hình hoặc hướng dẫn mô hình khả dụng trong trang quản trị | Viết sai tên mô hình sẽ trực tiếp dẫn đến lỗi không tìm thấy mô hình |
| Chỉ thay đổi một công cụ mục tiêu trước | Ban đầu, chỉ chọn Claude Code | Dễ dàng xác định mục nào gặp sự cố hơn khi khắc phục lỗi |
Cách điền các trường thông tin
| Cài đặt | Cách điền | Lưu ý cho người mới bắt đầu |
|---|---|---|
| Provider Name | Đặt một tên dễ nhận biết | Ví dụ: 'Provider Claude chính', không nên chỉ điền mỗi số |
| Target Tool / Preset | Chọn Claude Code hoặc preset liên quan đến Claude | Không chọn Codex, OpenAI hoặc Gemini |
| Base URL | Sao chép liên kết API do trang quản trị của nhà cung cấp cung cấp cho Claude / Anthropic | Không phải tất cả các nhà cung cấp đều dùng chung Base URL với OpenAI |
| API Key | Sao chép toàn bộ Key được tạo trong trang quản trị | Nó cũng thường được gọi là token, Key, secret key |
| Model Name | Sao chép chính xác tên mô hình Claude được trang quản trị hỗ trợ | Không tự ý viết tắt và không nhầm tên hiển thị thành tên mô hình |
Áp dụng cho Claude Code
- Mở CC Switch và đi đến khu vực quản lý Provider.
- Thêm Provider mới hoặc chọn cấu hình nhà cung cấp bạn đã tạo từ trước.
- Chọn preset liên quan đến công cụ mục tiêu Claude Code.
- Lần lượt điền tên Provider, Base URL, API Key và tên mô hình.
- Sau khi lưu, thực hiện Apply / Switch để áp dụng Provider hiện tại cho Claude Code.
- Nếu trang nhắc bạn cần khởi động lại terminal hoặc công cụ mục tiêu, hãy đóng phiên Claude Code hiện tại rồi mở lại.
Kiểm tra xem đã hoạt động chưa
Trong quá trình kiểm tra, trước tiên hãy gửi một câu hỏi cực ngắn và không mở trực tiếp dự án thực tế. Miễn là nó phản hồi bình thường, điều đó cho thấy Key, Base URL, tên mô hình và việc đồng bộ hóa công cụ mục tiêu về cơ bản đã có thể sử dụng được.
claude "Please reply only: CC-Switch Claude Code is active"