CC Switch

Quản lý hồ sơ routerra.ai cho Claude Code và Codex trong CC Switch.

Cài đặt và chuẩn bị

  1. Tải trình cài đặt cho hệ điều hành từ CC Switch Releases, cài và mở. Cài riêng CLI đích; CC Switch quản lý cấu hình của nó. Hướng dẫn theo cách xử lý khóa từ v3.20.1.
  2. Tạo khóa tại routerra.ai Khóa API và sao chép ID được phép từ Mô hình.

Thêm và bật hồ sơ ứng dụng

  1. Chọn ứng dụng, rồi Direct → Add Provider → Custom Configuration, đặt tên routerra.ai. Với Claude Code, dùng JSON và /model YOUR_CLAUDE_MODEL_ID trong CLI. Với Codex, nhập API Key, https://routerra.ai/v1, mô hình Responses và định dạng phía trên Responses. TOML minh họa các trường được tạo.
  2. Nhấn Add, rồi Enable, và khởi động lại CLI. Từ v3.20.1, CC Switch ghi token Codex dạng experimental_bearer_token vào ~/.codex/config.toml, không phải auth.json. Không dùng cách cũ requires_openai_auth = true cho quy trình này.
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://routerra.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_CLAUDE_MODEL_ID"
  }
}

Cấu hình Codex được tạo

Kiểm tra các trường trong ~/.codex/config.toml sau khi bật hồ sơ Codex.

model = "YOUR_MODEL_ID"
model_provider = "routerra"

[model_providers.routerra]
name = "routerra.ai"
base_url = "https://routerra.ai/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_API_KEY"

Kiểm tra kết nối

Lưu không có nghĩa là đã bật: kiểm tra thẻ provider và tệp CLI được tạo. Nếu đổi không có tác dụng, đóng CLI, xóa biến shell xung đột rồi mở lại. Tài khoản chính thức hiển thị trong Codex không xác định tuyến yêu cầu; xem mức sử dụng routerra.ai. Để giữ đăng nhập sẵn có, bật Settings → General → Codex App Enhancements → Keep official login for direct switches. Nếu tìm mô hình trả 404/405, nhập ID thủ công.