Hướng dẫn kết nối CC 反代: Cho phép Claude Code và Codex đi chung một đường trung chuyển

I. Đây là gì?

CC 反代 (Proxy đảo ngược CC, 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 vào thống nhất ra bên ngoài (tương thích Anthropic/OpenAI), sau đó chuyển tiếp các yêu cầu đến thượng nguồn (upstream) của bạn. Bằng cách này, cả Claude Code (Anthropic) và Codex (OpenAI) ở máy cục bộ đều kết nối vào cùng một proxy đảo ngược, tất cả luồng dữ liệu đổ về gateway của trang web này, sử dụng chung một khóa sk- và hạn mức.

Khi Claude Code (Anthropic) và Codex (OpenAI) ở máy cục bộ của bạn cần sử dụng chung gateway của trang web này, proxy đảo ngược có thể gửi yêu cầu đến cổng vào thống nhất đó, giúp quản lý bằng một khóa và hạn mức duy nhất.

II. Công tác chuẩn bị

1. Đăng nhập bảng điều khiển API của Jizhi (hoặc nền tảng tương đương), tạo sk-… API Key (chỉ hiển thị một lần, vui lòng lưu lại).
2. Xác nhận slug của model muốn sử dụng (mỗi loại một cái cho Claude và GPT hoặc tùy theo nhu cầu).
3. Xác nhận địa chỉ gateway: https://www.relay-api.com.

III. Cấu hình CC 反代 (Proxy đảo ngược)

① 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            # Cổng cục bộ mặc định 127.0.0.1:8787

② Trỏ "thượng nguồn" (upstream) của proxy về gateway của trang web này (hai mục cốt lõi: địa chỉ upstream + khóa API). 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 lần lượt Claude Code và Codex (trỏ tới cổng cục bộ của proxy đảo ngược):

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.4

IV. Đối chiếu điểm cuối thượng nguồn (Upstream Endpoints)

Mục đích	Base URL thượng nguồn
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	Cách xử lý
401 / 403	Khóa không hợp lệ hoặc hết số dư; kiểm tra lại sk- và nạp tiền.
404 / Model không hợp lệ	Xác nhận địa chỉ upstream đã dùng đúng cổng vào của trang này; model cần được kích hoạt.

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