cách cấu hình API cho CC Switch

Ưu tiên tính năng nhập một chạm trong bảng điều khiển qionggeme/穷哥么 để chuyển nhà cung cấp, endpoint, mô hình và API Key sang CC Switch an toàn; nếu nhập thất bại, bạn vẫn có thể cấu hình thủ công theo các trường chính thức.

Cấu hình nhanh

Điểm bắt đầu đề xuất
https://qionggeme.com/console/token
Trong menu thao tác của dòng API Key, chọn “CC Switch”.
Giao thức nhập
ccswitch://v1/import
Liên kết có thể chứa API Key; không sao chép vào chat công khai, ticket hoặc ảnh chụp màn hình.
Codex Endpoint
https://qionggeme.com/v1
Giao thức Responses nguyên bản, không cần ánh xạ định tuyến cục bộ.
Claude / Gemini Endpoint
https://qionggeme.com
Trạng thái nhập
enabled=true
Sau khi nhập vẫn phải xác nhận nhà cung cấp đích đang được bật.

Chuẩn bị trước:

Hướng dẫn ưu tiên tính năng nhập một chạm đã có trong bảng điều khiển, không yêu cầu bạn tự ghép Deep Link. Tham số truy vấn của Deep Link có thể chứa API Key dạng rõ; không chia sẻ, chuyển tiếp hoặc đăng ảnh chụp liên kết chứa Key.

Các bước cấu hình

  1. Mở trang API Key qionggeme/穷哥么

    Truy cập https://qionggeme.com/console/token, tìm API Key cần nhập rồi chọn “CC Switch” trong menu thao tác của dòng đó. Không sao chép liên kết chứa khóa được tạo sau đó từ thanh địa chỉ trình duyệt.

  2. Chọn ứng dụng đích, tên nhà cung cấp và mô hình chính

    Trong hộp thoại, chọn Claude, Codex hoặc Gemini, đặt tên nhà cung cấp dễ nhận biết rồi chọn mô hình chính. Model ID phải khớp hoàn toàn với mô hình hiện khả dụng trên trang giá.

  3. Nhấp “Open CC Switch”

    Bảng điều khiển sẽ tạo Deep Link ccswitch://v1/import và yêu cầu mở CC Switch. Nội dung do trang tạo gồm apiKey, model, homepage và enabled=true; endpoint của Codex là https://qionggeme.com/v1, còn Claude / Gemini là https://qionggeme.com.

  4. Xác nhận nhập trong CC Switch

    CC Switch sẽ hiển thị màn hình xác nhận. Hãy kiểm tra loại ứng dụng, tên nhà cung cấp, endpoint và mô hình trước khi đồng ý. Giao thức chính thức yêu cầu hiển thị bản xem trước cấu hình và để người dùng xác nhận; hãy hủy nếu nguồn không đáng tin hoặc trường dữ liệu bất thường.

  5. Xác nhận nhà cung cấp đã bật và khởi động lại CLI đích

    Quay lại danh sách nhà cung cấp của ứng dụng tương ứng và xác nhận nhà cung cấp vừa nhập đang được bật. Nếu Claude Code, Codex hoặc Gemini CLI đã chạy trước khi nhập, hãy đóng rồi khởi động lại CLI để tiến trình đọc lại cấu hình. Đặc biệt với Codex, hướng dẫn chuyển đổi chính thức yêu cầu khởi động lại terminal sau khi chuyển.

  6. Thêm nhà cung cấp thủ công nếu nhập một chạm thất bại

    Trong tab ứng dụng tương ứng của CC Switch, thêm một nhà cung cấp tùy chỉnh:

    • Tab Codex: endpoint là https://qionggeme.com/v1, điền API Key và mô hình; dùng responses nguyên bản, không cần bật ánh xạ định tuyến cục bộ.
    • Tab Claude: endpoint là https://qionggeme.com, điền API Key và mô hình rồi lưu và bật.

    Khi cấu hình thủ công cũng không dùng địa chỉ trang nội dung và tuyệt đối không thêm /docs vào endpoint API.

Ví dụ cấu hình

# Danh sách kiểm tra an toàn (không hiển thị API Key thật, không ghép Deep Link đầy đủ)
Giao thức: ccswitch://v1/import
resource: provider
Codex endpoint: https://qionggeme.com/v1
Claude/Gemini endpoint: https://qionggeme.com
Các trường: apiKey, model, homepage, enabled=true

# Cấu hình Codex thủ công dự phòng
Base URL: https://qionggeme.com/v1
Wire API: responses
Ánh xạ định tuyến cục bộ: không cần

Khắc phục sự cố

Nhấp “Open CC Switch” nhưng ứng dụng không mở

Trước tiên xác nhận CC Switch đã được cài và từng khởi động. Theo tài liệu chính thức, quá trình cài đặt sẽ đăng ký giao thức ccswitch://; nếu hệ thống chưa đăng ký đúng, hãy cài lại hoặc sửa đăng ký theo tài liệu Deep Link rồi bắt đầu nhập lại từ trang API Key.

CC Switch báo nhập thất bại hoặc thiếu trường

Không tự sửa liên kết chứa Key. Quay lại bảng điều khiển, chọn lại ứng dụng, tên nhà cung cấp và mô hình chính rồi mở lại; nếu vẫn thất bại, dùng cấu hình thủ công trên trang này. Endpoint phải lần lượt là https://qionggeme.com/v1 hoặc https://qionggeme.com và không chứa /docs.

Nhập thành công nhưng CLI đích vẫn dùng nhà cung cấp cũ

Trong CC Switch, xác nhận nhà cung cấp mới ở trạng thái bật rồi thoát hoàn toàn và khởi động lại CLI đang chạy. Với Codex, hãy đóng cửa sổ terminal hiện tại rồi mở lại.

Codex yêu cầu thất bại hoặc tưởng rằng phải bật định tuyến cục bộ

Kiểm tra endpoint Codex là https://qionggeme.com/v1 và giao thức là responses nguyên bản. Endpoint qionggeme/穷哥么 không cần ánh xạ định tuyến cục bộ của CC Switch; chỉ khi thượng nguồn không hỗ trợ Responses nguyên bản, chẳng hạn chỉ có Chat Completions hoặc Anthropic Messages, mới cần chuyển đổi.

Gặp lỗi 401, thiếu số dư hoặc mô hình không tồn tại

Kiểm tra lại API Key, quyền token và số dư, đồng thời xác nhận Model ID trên trang bảng giá mô hình. Không đăng Key hoặc Deep Link chứa Key lên kênh công khai để nhờ hỗ trợ.

Sẵn sàng bắt đầu?

Đăng ký qionggeme/穷哥么 để lấy API Key và dùng ngay mọi mô hình đang cung cấp.

Đăng ký ngay

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

Tính năng nhập một chạm của CC Switch ghi những trường nào?

Nhà cung cấp do qionggeme/穷哥么 tạo gồm apiKey, model, homepage, enabled=true và endpoint theo ứng dụng: Codex dùng https://qionggeme.com/v1, Claude/Gemini dùng https://qionggeme.com.

Có thể gửi liên kết nhập ccswitch:// cho người khác không?

Không chia sẻ Deep Link chứa API Key. Tham số liên kết có thể mang khóa trực tiếp; chat công khai, ticket, ảnh chụp màn hình, đồng bộ lịch sử trình duyệt hoặc nhật ký đều có thể làm rò rỉ. Khi cộng tác, hãy loại bỏ trường nhạy cảm và để người kia dùng Key của chính họ.

Vì sao Codex không cần ánh xạ định tuyến cục bộ?

Vì endpoint Codex https://qionggeme.com/v1 của qionggeme/穷哥么 hỗ trợ Responses nguyên bản. Chỉ cần Base URL, API Key và mô hình; chỉ thượng nguồn không hỗ trợ Responses mới cần chuyển đổi giao thức cục bộ.

Vì sao cấu hình không có hiệu lực ngay sau khi nhập?

Trước hết xác nhận nhà cung cấp đã được bật. CLI đang chạy có thể vẫn giữ cấu hình cũ và cần khởi động lại; tài liệu chuyển đổi chính thức của Codex yêu cầu đóng terminal hiện tại rồi mở lại.

Endpoint API có thể là địa chỉ trang /docs không?

Không. Codex dùng https://qionggeme.com/v1, Claude/Gemini dùng https://qionggeme.com; endpoint API tuyệt đối không chứa /docs.

Hướng dẫn liên quan

cách cấu hình API tùy chỉnh cho Codex CLI

Kết nối qionggeme/穷哥么 bằng cấu hình model provider chính thức của Codex, lưu khóa trong biến môi trường và dùng Responses API.

Đọc hướng dẫn →

cách cấu hình API cho Claude Code

Dùng biến môi trường để Claude Code kết nối API trung gian qionggeme/穷哥么 và sử dụng khả năng lập trình của Claude mà không cần gói thuê bao chính thức.

Đọc hướng dẫn →

cách cấu hình API cho Cockpit Tools

Cockpit Tools quản lý profile Codex. Bạn phải thực hiện đúng thứ tự “thêm nhà cung cấp → gán vào instance → bật và khởi động” để Codex thực sự dùng API trung gian qionggeme/穷哥么.

Đọc hướng dẫn →