Hướng dẫn kết nối CC Proxy: Để Claude Code và Codex cùng đi qua một điểm trung gian

I. Đây là gì

CC Proxy (thường gặp như cc-switch, claude-code-proxy) là một loại proxy chuyển tiếp cục bộ/tự xây dựng: cung cấp một cổng truy cập thống nhất ra bên ngoài (tương thích Anthropic / OpenAI), sau đó chuyển tiếp yêu cầu đến upstream (nguồn thượng nguồn) của bạn. Bằng cách này, cả Claude Code (Anthropic) và Codex (OpenAI) cục bộ đều kết nối vào cùng một proxy, lưu lượng được tập trung về gateway của trang web này, sử dụng chung một khóa sk- và định mức.

Khi Claude Code (Anthropic) và Codex (OpenAI) cục bộ của bạn cần đi qua gateway của trang web này, proxy có thể phân phối các yêu cầu đến cổng truy cập thống nhất, sử dụng chung một khóa và định mức.

II. Chuẩn bị

1. Đăng nhập bảng điều khiển API của chúng tôi, tạo khóa API sk-… (chỉ hiển thị một lần, vui lòng lưu lại).
2. Xác nhận slug mô hình bạn muốn sử dụng (Claude và GPT riêng biệt hoặc tùy nhu cầu).
3. Xác nhận địa chỉ gateway: https://www.relay-api.com.

III. Cấu hình CC Proxy

① Cài đặt và khởi chạy

npm install -g cc-switch   # hoặc claude-code-proxy / công cụ proxy tương ứng
cc-switch start            # mặc định cổng cục bộ 127.0.0.1:8787

② Trỏ "upstream" của proxy về gateway của trang web (hai mục cốt lõi: địa chỉ upstream + khóa). Lấy ví dụ cấu hình cc-switch:

# Ví dụ cấu hình cc-switch
anthropic_upstream = "https://www.relay-api.com"
openai_upstream    = "https://www.relay-api.com/v1"
api_key            = "sk-khóa_của_bạn"

③ Kết nối Claude Code và Codex tương ứng (trỏ tới cổng cục bộ của proxy):

export ANTHROPIC_BASE_URL="http://127.0.0.1:8787"
export ANTHROPIC_API_KEY="sk-khóa_của_bạn"
export ANTHROPIC_MODEL="claude-sonnet-5"
claude

export OPENAI_BASE_URL="http://127.0.0.1:8787"
export OPENAI_API_KEY="sk-khóa_của_bạn"
codex --model gpt-5.5

IV. Đối chiếu điểm cuối upstream

Mục đích	Upstream Base URL
Claude Code (Claude)	https://www.relay-api.com
Codex (GPT)	https://www.relay-api.com/v1

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

Hiện tượng	Xử lý
401 / 403	Khóa không hợp lệ hoặc không đủ số dư; xác nhận sk- chính xác và nạp tiền.
404 / Mô hình không hợp lệ	Xác nhận địa chỉ upstream đã dùng cổng truy cập của trang web này; mô hình cần được kích hoạt.

Khuyến nghị bảo mật: Không viết sk- của nền tảng vào các kho lưu trữ công khai (public repo); khuyến khích tạo riêng một khóa cho proxy để dễ dàng thống kê và giới hạn hạn mức.

Giải thích về Base URL: Trang web này chấp nhận cả /v1beta/models/... và /v1beta/v1beta/models/... (cũng như /v1/... và /v1/v1/...), vì vậy việc client có tự thêm /v1, /v1beta hay không đều không ảnh hưởng đến việc gọi API: Base URL điền gốc tên miền hay điền địa chỉ có kèm /v1beta đều sử dụng được. Vui lòng tra cứu và sao chép ID mô hình tại mục "ID mô hình" ở góc trên bên phải trang "Token" trong bảng điều khiển.