Kết nối SeedRouter qua CC Switch để dùng Codex

Về tài liệu này

Tài liệu này giải thích cách dùng tính năng nhà cung cấp thống nhất (Universal Provider) của CC Switch để kết nối công cụ dòng lệnh OpenAI Codex với API gateway được chỉ định và làm cấu hình có hiệu lực.

Phiên bản áp dụng: CC Switch v3.16.x trở lên.

Nguồn thông tin: sổ tay người dùng và mã nguồn của repo chính thức CC Switch. Phần mềm được cập nhật khá nhanh; nếu giao diện sản phẩm không khớp với mô tả trong tài liệu này, lấy phần hiển thị thực tế trong ứng dụng làm chuẩn.

Giải thích thuật ngữ

Thuật ngữ	Mô tả
Codex	Trợ lý lập trình AI dòng lệnh do OpenAI cung cấp. Sau khi cài đặt, chạy lệnh `codex` trong terminal để khởi động.
CC Switch	Công cụ quản lý cấu hình desktop đa nền tảng, dùng để quản lý endpoint dịch vụ và credential của các công cụ như Codex, Claude Code, Gemini CLI. Bản thân CC Switch không cung cấp khả năng AI, chỉ đảm nhận việc tạo và chuyển tệp cấu hình.
Nhà cung cấp (Provider)	Bên cung cấp khả năng inference của mô hình. Có thể là dịch vụ chính thức của hãng sản xuất mô hình, cũng có thể là API gateway tự xây dựng hoặc mua.
API Key	Chuỗi khóa dùng để xác thực danh tính, thường bắt đầu bằng `sk-`.
Nhà cung cấp thống nhất (Universal Provider)	Một tính năng của CC Switch. Một cấu hình có thể đồng bộ đồng thời tới ba công cụ Claude Code, Codex và Gemini CLI, phù hợp với gateway hỗ trợ đồng thời nhiều giao thức API (ví dụ NewAPI).
Nhà cung cấp riêng cho ứng dụng	Cấu hình nhà cung cấp chỉ áp dụng cho một công cụ, đối lập với nhà cung cấp thống nhất.

Trước khi bắt đầu

Yêu cầu hệ thống

Hệ điều hành	Phiên bản tối thiểu	Kiến trúc
Windows	Windows 10	x64
macOS	macOS 12 (Monterey)	Intel (x64) / Apple Silicon (arm64)
Linux	Ubuntu 22.04 / Debian 11 / Fedora 34 và phiên bản tương đương	x64 / ARM64

Ngoài ra còn cần Node.js 18 hoặc phiên bản cao hơn. Các bước cài đặt xem ở “Nhiệm vụ 1”.

Thông tin cần lấy trước

Trước khi bắt đầu cấu hình, bạn hãy lấy bốn thông tin sau từ bên cung cấp dịch vụ API. Thiếu bất kỳ mục nào cũng không thể hoàn tất cấu hình.

Mục	Mô tả	Ví dụ
Địa chỉ API (Base URL)	Địa chỉ dịch vụ của gateway	`https://seedrouter.net`
API Key	Khóa xác thực	`sk-xxxxxxxxxxxx`
Tên mô hình	Định danh mô hình dùng ở phía Codex	`gpt-5.6-sol`
Tình trạng hỗ trợ giao thức	Gateway có hỗ trợ giao thức OpenAI Responses hay không	Hỗ trợ / Không hỗ trợ

Điểm chính: Mục thứ tư quyết định tài liệu này có áp dụng hay không. Trong cấu hình mà nhà cung cấp thống nhất tạo cho Codex, giao thức truyền thông được cố định là wire_api = "responses" và không sửa được. Nếu gateway không hỗ trợ giao thức Responses mà chỉ hỗ trợ giao thức Chat Completions, bạn không thể dùng nhà cung cấp thống nhất; hãy chuyển sang phương án F trong mục "Chẩn đoán sự cố".

Mở terminal

Tài liệu này có nhiều chỗ cần chạy lệnh trong terminal. Cách mở terminal như sau:

Windows: nhấn Win + R, nhập powershell, nhấn phím Enter.
macOS: nhấn Command + Dấu cách, nhập terminal, nhấn phím Enter.
Linux: dùng ứng dụng terminal có sẵn của bản phân phối.

Tác vụ 1: Cài đặt Node.js

Về tác vụ này

Codex được phân phối qua npm, trình quản lý gói của Node.js. Kể cả khi dùng cách cài một chạm của CC Switch, bạn vẫn cần có sẵn môi trường chạy Node.js.

Quy trình

Truy cập trang web chính thức của Node.js.
Tải gói cài đặt được đánh dấu LTS (bản hỗ trợ dài hạn). Bạn đừng tải bản Current.
Chạy trình cài đặt, hoàn tất theo các tùy chọn mặc định, không cần sửa mục cấu hình nào.

Nếu bạn dùng macOS và đã cài Homebrew, cũng có thể chạy brew install node trong terminal.
Đóng mọi cửa sổ terminal hiện tại, rồi mở một cửa sổ terminal mới.
Chạy lần lượt các lệnh sau để kiểm tra cài đặt:
```
node --version
      npm --version
```

Kết quả

Cả hai lệnh đều in ra số phiên bản (ví dụ v22.14.0 và 10.9.2), và phiên bản Node.js không thấp hơn v18, nghĩa là cài đặt thành công.

Lưu ý: Nếu hiện thông báo "không phải lệnh nội bộ hoặc lệnh bên ngoài" hoặc "command not found", thường là do bạn chưa mở lại cửa sổ terminal. Lệnh vừa cài chỉ có hiệu lực trong phiên terminal mới mở.

Tác vụ 2: Cài đặt CC Switch

Về tác vụ này

CC Switch là phần mềm mã nguồn mở miễn phí, chỉ được phân phối qua hai kênh sau:

Trang web chính thức: ccswitch.io
Trang phát hành trên GitHub: farion1231/cc-switch Releases

Cảnh báo: Mọi trang web hoặc client "CC Switch" yêu cầu trả phí, nạp tiền hoặc xin thông tin đăng nhập tài khoản đều không phải kênh chính thức. Bạn đừng tải xuống và sử dụng.

Quy trình

Windows

Mở trang phát hành trên GitHub, tìm CC-Switch-v3.16.x-Windows.msi trong vùng Assets dưới mục phiên bản mới nhất.
Tải xuống và nhấp đúp để chạy trình cài đặt, làm theo hướng dẫn để hoàn tất cài đặt.

Nếu nhấp đúp mà không có phản hồi nào, tệp đã bị chính sách bảo mật của hệ thống khóa. Hãy nhấp chuột phải vào tệp, chọn Thuộc tính, ở vùng Bảo mật phía dưới tab Chung, đánh dấu Bỏ chặn, nhấp OK rồi chạy lại.

Nếu bạn không muốn cài vào hệ thống, cũng có thể tải bản không cần cài CC-Switch-v3.16.x-Windows-Portable.zip, giải nén rồi chạy trực tiếp CC-Switch.exe.

macOS

Dùng một trong các cách sau:

Cách 1 (nên dùng khi đã cài Homebrew): chạy trong terminal
```
brew install --cask cc-switch
```
Cách 2: Tải CC-Switch-v3.16.x-macOS.dmg, nhấp đúp để mở, rồi kéo biểu tượng CC Switch vào thư mục "Ứng dụng".

Lưu ý: Bản macOS đã được Apple ký mã và công chứng, có thể cài và mở trực tiếp, không hiện lời nhắc "không thể xác minh nhà phát triển", không cần thực hiện thêm thao tác gỡ cách ly.

Linux

Chọn theo bản phân phối:

Debian / Ubuntu: tải gói .deb rồi chạy

sudo dpkg -i CC-Switch-v3.16.x-Linux-*.deb
      sudo apt-get install -f

Arch Linux: paru -S cc-switch-bin
Bản phân phối khác: tải .AppImage, chạy chmod +x để thêm quyền thực thi rồi chạy trực tiếp.

Kết quả

Sau khi khởi động CC Switch, cửa sổ chính hiển thị bình thường, và khu vực khay hệ thống (Windows ở góc dưới bên phải, macOS ở bên phải thanh menu) xuất hiện biểu tượng CC Switch, cho thấy cài đặt thành công.

Lần khởi động đầu tiên, nếu có lời nhắc nhập cấu hình công cụ CLI hiện có, bạn nên chọn nhập. Thao tác này lưu cấu hình hiện có thành một nhà cung cấp mặc định và không làm mất cấu hình.

Tác vụ 3: Cài đặt Codex

Về tác vụ này

Bạn có thể cài qua giao diện đồ họa CC Switch, hoặc cài bằng dòng lệnh. Người dùng lần đầu nên dùng cách A.

Quy trình

Cách A: Cài đặt qua CC Switch (khuyến nghị)

Khởi động CC Switch.
Lần lượt vào Settings > About.
Trong vùng Local Environment Check, xem trạng thái của dòng Codex.
Nếu hiển thị Not detected, nhấp nút Install ở bên phải dòng đó.

Quá trình cài đặt chạy ngầm trong nền, nút hiển thị tiến trình và tự làm mới số phiên bản khi hoàn tất.

Lưu ý: Các lần nâng cấp sau cũng thực hiện tại giao diện này. Khi phát hiện phiên bản mới, bạn có thể nâng cấp riêng, hoặc nhấp Upgrade All để xử lý hàng loạt.

Cách B: Cài đặt bằng dòng lệnh

Mở terminal.
Chạy lệnh sau:
```
npm install -g @openai/codex
```
Nếu tốc độ tải quá chậm, bạn có thể chuyển sang nguồn mirror:
```
npm install -g @openai/codex --registry=https://registry.npmmirror.com
```
Nếu cần dùng nguồn mirror lâu dài, bạn có thể chạy một lần lệnh sau để thiết lập toàn cục:
```
npm config set registry https://registry.npmmirror.com
```

Kết quả

Sau khi đóng và mở lại terminal, chạy lệnh sau:

codex --version

In ra số phiên bản nghĩa là cài đặt thành công.

Lưu ý: Lúc này chưa hoàn tất cấu hình nhà cung cấp. Chạy trực tiếp codex sẽ báo lỗi vì thiếu thông tin xác thực hợp lệ; đây là hành vi dự kiến. Cấu hình được hoàn tất trong tác vụ 4.

Tác vụ 4: Tạo nhà cung cấp hợp nhất

Về tác vụ này

Tác vụ này tạo một cấu hình nhà cung cấp hợp nhất trong CC Switch và đồng bộ cấu hình đó vào danh sách nhà cung cấp của Codex.

Quy trình

Khởi động CC Switch.
Trong bộ chuyển ứng dụng ở phía trên, chuyển sang Codex.

Chuyển sang panel Claude hoặc Gemini cũng vào được lối vào nhà cung cấp hợp nhất; cả ba dùng chung một cấu hình.
Nhấp nút ＋ ở góc trên bên phải để mở panel thêm nhà cung cấp.
Ở đầu panel, chọn tab Unified Provider.

Giới hạn: Các panel OpenCode, OpenClaw, Hermes và Claude Desktop không hỗ trợ nhà cung cấp hợp nhất, nên không hiển thị tab này. Nếu bạn không thấy tab này, hãy chuyển sang panel Claude, Codex hoặc Gemini trước.
Nhấp Add Unified Provider.

Điền các trường của biểu mẫu theo bảng dưới đây:

Trường	Hướng dẫn điền
Select Preset Type	Khi gateway là NewAPI, chọn NewAPI; trong các trường hợp khác hoặc khi chưa chắc, chọn Custom Gateway. Hai lựa chọn có các trường hoàn toàn giống nhau, chỉ khác giá trị mặc định.
Name	Tên định danh do bạn tự đặt, ví dụ `Cổng NewAPI`. Tên này sẽ hiển thị trên thẻ nhà cung cấp của Codex.
API Address	Điền Base URL đã lấy trước. Quy tắc điền xem phần “Quy tắc xử lý địa chỉ API” bên dưới.
API Key	Điền khóa đã lấy trước. Bạn có thể nhấp biểu tượng con mắt bên phải để chuyển đổi hiển thị nguyên văn.
Official Website	Tùy chọn. Sau khi điền, bạn có thể chuyển thẳng từ thẻ nhà cung cấp.
Notes	Tùy chọn. Bạn nên ghi nguồn khóa, thời hạn hiệu lực và các thông tin tương tự.
Enabled Apps	Gồm 3 công tắc: Claude Code, OpenAI Codex và Gemini. Phải bật OpenAI Codex. Nếu gateway này cũng dùng cho hai công cụ còn lại, bạn có thể bật cùng lúc.
Model Configuration > Codex > Model	Điền tên model đã lấy trước, ví dụ `gpt-5.6-sol`.
Model Configuration > Codex > Reasoning Effort	Cường độ suy luận, nhận giá trị `low`, `medium` hoặc `high`. Khi không có yêu cầu đặc biệt, điền `high`.

Lưu ý: Biểu mẫu provider thống nhất không có nút "Fetch Models"; bạn phải điền tên model thủ công và phân biệt chữ hoa chữ thường.

Bạn nhấp Add.

Kết quả

Giao diện hiện thông báo "Unified provider added and synced". Lúc này CC Switch đã tạo một thẻ provider cùng tên trong danh sách provider của Codex; nếu bạn đã tích chọn ứng dụng khác, thẻ cũng được tạo trong danh sách tương ứng.

Điểm chính: Đồng bộ không đồng nghĩa với bật. Lúc này cấu hình chưa được ghi vào tệp cấu hình runtime của Codex, bạn phải tiếp tục thực hiện nhiệm vụ 5.

Quy tắc xử lý địa chỉ API

Khi tạo cấu hình cho Codex, CC Switch xử lý địa chỉ API đã điền như sau:

Dạng địa chỉ đã điền	Kết quả xử lý
Chỉ tên miền, không có đường dẫn, ví dụ `https://seedrouter.net`	Tự động bổ sung thành `https://seedrouter.net/v1`
Đã kết thúc bằng `/v1`, ví dụ `https://seedrouter.net/v1`	Dùng nguyên dạng
Có đường dẫn khác, ví dụ `https://api.example.com/openai`	Dùng nguyên dạng, không bổ sung `/v1`

Tiêu chí xác định: địa chỉ sau khi xử lý, khi nối thêm /responses, phải là đường dẫn API mà gateway thực sự dùng được. Trước khi điền, bạn nên xác nhận địa chỉ API đầy đủ với nhà cung cấp dịch vụ, rồi dựa vào bảng trên suy ngược nội dung cần điền. Địa chỉ không đúng sẽ khiến request trả về 404.

Nhiệm vụ 5: Bật provider và làm cấu hình có hiệu lực

Về nhiệm vụ này

Sau khi thẻ provider được tạo, bạn cần bật thủ công thì cấu hình mới được ghi vào tệp cấu hình của Codex. Codex không hỗ trợ hot reload cấu hình; sau khi bật, bạn phải khởi động lại terminal.

Quy trình

Bạn đóng panel thêm provider.
Trong bộ chuyển ứng dụng ở phía trên, bạn chuyển sang Codex.
Trong danh sách provider, bạn tìm thẻ cùng tên đã tạo ở nhiệm vụ 4.
Bạn nhấp nút Enable trên thẻ.

Thẻ hiển thị viền xanh dương và nhãn "Currently enabled", cho biết cấu hình đã được ghi.

Đóng hoàn toàn cửa sổ terminal hiện tại, rồi mở một cửa sổ terminal mới.

Điểm chính: Ở đây là đóng toàn bộ cửa sổ terminal, không phải thoát tiến trình codex rồi chạy lại lệnh codex. Cách có hiệu lực của từng công cụ khác nhau như sau:

Công cụ	Cách có hiệu lực sau khi đổi provider
Claude Code	Có hiệu lực ngay, hỗ trợ hot reload
Gemini CLI	Có hiệu lực ngay, đọc lại cấu hình mỗi lần request
Codex	Cần đóng rồi mở lại terminal
OpenCode / OpenClaw	Cần đóng rồi mở lại terminal

Trong terminal mới, bạn chạy:
```
codex
```
Sau khi khởi động, bạn nhập một câu nội dung để thử, ví dụ "Xin chào, hãy giới thiệu ngắn gọn về bản thân".

Kết quả

Model trả về câu trả lời bình thường, tức là cấu hình đã hoàn tất và Codex đã kết nối với gateway được chỉ định.

Tham khảo: Tệp cấu hình được tạo

CC Switch tuân theo nguyên tắc can thiệp tối thiểu. Sau khi bật provider, cấu hình được ghi trực tiếp vào tệp cấu hình của chính Codex; ngay cả khi gỡ cài đặt CC Switch, Codex vẫn tiếp tục hoạt động bình thường.

Các tệp liên quan như sau. ~ trong đường dẫn là thư mục người dùng hiện tại; trên Windows là C:\Users\<tên người dùng>\, trên macOS và Linux là /Users/<tên người dùng>/ hoặc /home/<tên người dùng>/.

~/.codex/auth.json — lưu credential:

{
        "OPENAI_API_KEY": "<API Key>"
      }

~/.codex/config.toml — lưu cấu hình model và endpoint:

model_provider = "cliproxyapi"
      model = "gpt-5.6-sol"
      model_reasoning_effort = "max"
      sandbox_mode = "workspace-write"
      model_context_window = 372000
      model_auto_compact_token_limit = 334800
      model_auto_compact_token_limit_scope = "total"
      service_tier = "priority"
      
      [model_providers.cliproxyapi]
      name = "SeedRouter"
      base_url = "https://seedrouter.net/v1"
      wire_api = "responses"
      requires_openai_auth = true
      experimental_bearer_token = "sk-xxxxxxxxxx"

Dữ liệu của CC Switch được lưu trong thư mục ~/.cc-switch/, trong đó tệp cơ sở dữ liệu là cc-switch.db, bản sao lưu tự động nằm ở thư mục con backups/, giữ lại 10 bản gần nhất.

Thao tác bảo trì

Sửa cấu hình

Khi sửa API Key, tên mô hình hoặc địa chỉ dịch vụ:

Nhấp nút ＋, chuyển sang tab Unified Provider.
Nhấp biểu tượng chỉnh sửa trên thẻ mục tiêu.
Sửa các trường tương ứng.

Ở chế độ chỉnh sửa, cuối biểu mẫu có vùng Config JSON Preview, để bạn xác nhận nội dung thực tế sẽ ghi vào từng ứng dụng trước khi đồng bộ.
Nhấp Save and Sync.
Xác nhận thao tác trong hộp thoại xác nhận. Thao tác này sẽ ghi đè cấu hình nhà cung cấp liên kết trong Claude, Codex và Gemini.
Đóng terminal rồi mở lại.

Hướng dẫn thao tác trên thẻ nhà cung cấp

Thao tác	Mô tả
Sync	Đẩy lại thủ công cấu hình hiện tại tới từng ứng dụng liên kết, để sửa khi cấu hình không khớp.
Copy	Tạo một bản sao từ cấu hình hiện tại, để tiện cấu hình khóa dự phòng.
Edit	Sửa nội dung cấu hình.
Delete	Xóa Unified Provider, đồng thời xóa các thẻ nhà cung cấp liên kết mà nó đã tạo trong Claude, Codex và Gemini.

Chuyển nhanh

Nhấp chuột phải vào biểu tượng CC Switch trên khay hệ thống, trong menu con Codex nhấp trực tiếp tên nhà cung cấp mục tiêu để chuyển, không cần mở giao diện chính. Sau khi chuyển, bạn cũng cần khởi động lại terminal.

Chẩn đoán sự cố

A. Trả về 401 hoặc 403, xác thực thất bại

Nguyên nhân có thể	Giải pháp
Khi sao chép API Key có khoảng trắng hoặc ký tự xuống dòng thừa	Sao chép và dán lại, chú ý phạm vi chọn
API Key đã hết hạn hoặc đã dùng hết hạn mức	Xác nhận trạng thái khóa với bên cung cấp dịch vụ
API Key không khớp với địa chỉ API	Đối chiếu xem cả hai có đến từ cùng một dịch vụ hay không

B. Trả về 404 hoặc thông báo endpoint không tồn tại

Trong đa số trường hợp, địa chỉ API sau khi xử lý không đúng. Hãy đối chiếu lại theo "Nhiệm vụ 4 > Quy tắc xử lý địa chỉ API", và xác nhận địa chỉ endpoint đầy đủ với bên cung cấp dịch vụ.

C. Sửa cấu hình xong nhưng không có thay đổi nào

Chưa khởi động lại terminal. Hãy đóng hẳn cửa sổ terminal rồi mở lại. Đây là vấn đề thường gặp nhất khi dùng Codex.

D. Phía trên giao diện hiện cảnh báo xung đột biến môi trường

Trong hệ thống có các biến môi trường như OPENAI_API_KEY. Biến môi trường có độ ưu tiên cao hơn tệp cấu hình, sẽ ghi đè cấu hình do CC Switch ghi, khiến yêu cầu bị gửi tới endpoint sai hoặc dùng khóa sai.

Các bước xử lý:

Nhấp Expand trên banner cảnh báo để xem tên, giá trị và nguồn của biến xung đột.
Đánh dấu các biến cần xóa, hoặc nhấp Select All.
Nhấp Delete Selected rồi xác nhận.

Trước khi xóa, CC Switch tự động sao lưu vào ~/.cc-switch/env-backups/. Nếu bạn cần khôi phục, có thể hoàn nguyên thủ công từ tệp JSON trong thư mục đó.

E. Terminal báo lệnh codex không tồn tại

Nguyên nhân có thể	Giải pháp
Sau khi cài chưa mở lại terminal	Đóng tất cả cửa sổ terminal rồi mở lại
Node.js chưa được cài đúng	Quay lại Nhiệm vụ 1, kiểm tra `npm --version` có xuất ra bình thường hay không
Thư mục global của npm chưa được thêm vào PATH	Dùng Settings > About > Local Environment Check của CC Switch để cài lại

F. Gateway chỉ hỗ trợ giao thức Chat Completions

Giao thức truyền thông của Unified Provider được cố định là Responses, không áp dụng cho trường hợp này; bạn phải chuyển sang nhà cung cấp riêng của ứng dụng.

Trong CC Switch, chuyển sang panel Codex, nhấp nút ＋.
Giữ ở tab Codex Provider bên trái, không chuyển sang Unified Provider.
Trong hộp thả xuống preset, chọn nhà cung cấp dịch vụ tương ứng. DeepSeek, Zhipu GLM, Kimi, MiniMax, StepFun, Bailian, ModelScope, SiliconFlow, Doubao Seed, Xiaomi MiMo, Novita AI, v.v. đều thuộc preset loại Chat Completions.
Sau khi chọn loại preset này, CC Switch tự động bật công tắc "Requires local route mapping" và cấu hình bảng ánh xạ mô hình; proxy cục bộ thực hiện chuyển đổi giao thức, không cần thiết lập thủ công.
Điền API Key, nhấp Add, sau đó bật nhà cung cấp này và khởi động lại terminal.

G. Cần khôi phục đăng nhập bằng tài khoản chính thức

Trong panel Codex, thêm nhà cung cấp từ preset "OpenAI Official".
Bật nhà cung cấp này và khởi động lại terminal.
Hoàn tất xác thực theo quy trình đăng nhập của chính Codex.

Sau khi hoàn tất, bạn có thể chuyển tự do giữa đăng nhập chính thức và nhà cung cấp bên thứ ba.

Tham khảo lựa chọn: nhà cung cấp thống nhất và nhà cung cấp riêng cho ứng dụng

Trường hợp sử dụng	Phương án đề xuất
Một gateway phục vụ đồng thời Claude Code, Codex và Gemini CLI, đồng thời hỗ trợ giao thức Responses	Nhà cung cấp thống nhất
Chỉ dùng một công cụ là Codex	Cả hai đều được, nhà cung cấp riêng cho ứng dụng có đường cấu hình ngắn hơn
Gateway chỉ hỗ trợ giao thức Chat Completions	Nhà cung cấp riêng cho ứng dụng, kết hợp preset tích hợp sẵn
Mỗi công cụ kết nối với một bên dịch vụ khác nhau	Nhà cung cấp riêng cho ứng dụng, cấu hình riêng từng công cụ
Cần cấu hình OpenCode, OpenClaw hoặc Hermes	Nhà cung cấp riêng cho ứng dụng; ba công cụ này không hỗ trợ nhà cung cấp thống nhất

Lưu ý bảo mật

API Key có mức nhạy cảm ngang với thông tin xác thực tài khoản. Bạn đừng gửi qua công cụ nhắn tin, chia sẻ bằng ảnh chụp màn hình, hoặc đưa vào kho mã nguồn.
Bạn chỉ lấy gói cài CC Switch từ trang chủ CC Switch hoặc kho GitHub chính thức.
Khi bạn đổi thiết bị hoặc nghi ngờ khóa bị lộ, hãy thay khóa ngay.
Tính năng xuất cấu hình của CC Switch ghi toàn bộ thông tin nhà cung cấp dưới dạng plaintext vào tệp sao lưu .sql. Bạn nên giữ tệp đã xuất cẩn thận, tránh để trong thư mục dùng chung.

Tham khảo nhanh

1. Cài Node.js               nodejs.org, chọn phiên bản LTS
      2. Cài CC Switch             ccswitch.io hoặc GitHub Releases
      3. Cài Codex                 CC Switch > Settings > About > Local Environment Check > Install
      4. Tạo nhà cung cấp thống nhất             Chuyển sang panel Codex > ＋ > Unified Provider > Add Unified Provider
                                    Điền tên, địa chỉ API, API Key
                                    Bật công tắc OpenAI Codex, điền tên model
      5. Bật nhà cung cấp                 Panel Codex > thẻ mục tiêu > Enable
      6. Khởi động lại terminal                   Đóng hẳn cửa sổ terminal rồi mở lại
      7. Xác minh                       Chạy lệnh codex và gửi tin nhắn thử

Khi bạn gửi phản hồi vấn đề, hãy kèm ảnh chụp đầy đủ thông báo lỗi và địa chỉ API đã điền ở nhiệm vụ 4 (phần khóa cần được che), để rút ngắn thời gian xử lý.

Cấu hình Codex qua nhà cung cấp thống nhất của CC Switch

Về tài liệu này

Giải thích thuật ngữ

Trước khi bắt đầu

Yêu cầu hệ thống

Thông tin cần lấy trước

Mở terminal

Tác vụ 1: Cài đặt Node.js

Về tác vụ này

Quy trình

Kết quả

Tác vụ 2: Cài đặt CC Switch

Về tác vụ này

Quy trình

Windows

macOS

Linux

Kết quả

Tác vụ 3: Cài đặt Codex

Về tác vụ này

Quy trình

Cách A: Cài đặt qua CC Switch (khuyến nghị)

Cách B: Cài đặt bằng dòng lệnh

Kết quả

Tác vụ 4: Tạo nhà cung cấp hợp nhất

Về tác vụ này

Quy trình

Kết quả

Quy tắc xử lý địa chỉ API

Nhiệm vụ 5: Bật provider và làm cấu hình có hiệu lực

Về nhiệm vụ này

Quy trình

Kết quả

Tham khảo: Tệp cấu hình được tạo

Thao tác bảo trì

Sửa cấu hình

Hướng dẫn thao tác trên thẻ nhà cung cấp

Chuyển nhanh

Chẩn đoán sự cố

A. Trả về 401 hoặc 403, xác thực thất bại

B. Trả về 404 hoặc thông báo endpoint không tồn tại

C. Sửa cấu hình xong nhưng không có thay đổi nào

D. Phía trên giao diện hiện cảnh báo xung đột biến môi trường

E. Terminal báo lệnh codex không tồn tại

F. Gateway chỉ hỗ trợ giao thức Chat Completions

G. Cần khôi phục đăng nhập bằng tài khoản chính thức

Tham khảo lựa chọn: nhà cung cấp thống nhất và nhà cung cấp riêng cho ứng dụng

Lưu ý bảo mật

Tham khảo nhanh