TL;DR

Codex Router là một router mô hình độc lập cho Codex (Anthropic's code assistant), cho phép dùng Kimi K3 (OAuth hoặc API) và DeepSeek V4 (Flash & Pro) trực tiếp từ bộ chọn mô hình Codex, mà không cần thay thế các mô hình GPT gốc hay mất đăng nhập ChatGPT. Tất cả routing chạy cục bộ qua 127.0.0.1, API key được nhập qua terminal prompt an toàn. Installer hướng dẫn từng bước (macOS, Windows, Linux) tự động phát hiện xác thực, tạo snapshot rollback, và hỗ trợ an toàn từ các phiên bản cũ hơn.

Các Mô Hình AI Bên Ngoài Trong Codex

Codex là bộ công cụ lập trình AI của Anthropic, tích hợp sâu với Claude và OpenAI API. Tuy nhiên, nhiều developer muốn thử các mô hình khác — Kimi (từ Moonshot AI) hoặc DeepSeek — mà vẫn giữ nguyên môi trường Codex hiện tại, không phải thay thế hoàn toàn hay rời khỏi ChatGPT.

Bài toán truyền thống: khi cộng thêm một provider mới, nó thường thay thế provider gốc hoặc bị "generic-ify" thành một entry "Custom" chung, làm mất sự phân biệt các mô hình lựa chọn.

Codex Router cho phép các mô hình GPT gốc và external models coexist

Codex Router giải quyết điều này: nó hoạt động như một middleware routing thông minh, cho phép các mô hình bên ngoài (Kimi, DeepSeek) hiển thị như các mục riêng biệt trong bộ chọn mô hình Codex, cùng tồn tại hoàn toàn độc lập với GPT gốc.

Lời Giải Pháp: Duy Nhất, An Toàn & Cục Bộ

Vấn đề bảo mật thường rất lớn: nếu yêu cầu người dùng dán API key trực tiếp vào chat, đó là rủi ro lộ lệnh và không bao giờ nên được tái tạo lại. Codex Router không bao giờ yêu cầu dán token vào chat.

Codex Router routing cục bộ đảm bảo API key không rời khỏi máy

Thay vào đó:

  • Tất cả routing chạy cục bộ qua 127.0.0.1 trên port 4102 (router chính), 4100 (adapter), 4101 (Kimi OAuth forwarder), 4103 (API-key forwarder)
  • API key được nhập qua terminal prompt an toàn — terminal echo bị tắt, không hiển thị khi bạn gõ
  • Credentials được bảo vệ bằng file permissions: mode 600 trên POSIX, ACL current-user trên Windows
  • Router kiểm tra chỉ sự tồn tại của credential, không bao giờ in hoặc lưu trữ giá trị

Kiến trúc này đảm bảo rằng API key của bạn không bao giờ rời khỏi máy tính thông qua bất kỳ dịch vụ cloud nào.

Cài Đặt: Một Lệnh Được Hướng Dẫn Từng Bước

Codex Router cung cấp một installer hướng dẫn toàn bộ quá trình — bạn không phải sao chép-dán lệnh hoặc chỉnh sửa config thủ công.

Installer hướng dẫn tự động phát hiện xác thực và cài đặt

Tùy thuộc vào hệ điều hành của bạn:

  • macOS / Linux (shell): curl -fsSL https://raw.githubusercontent.com/duolahypercho/codex-router/main/install.sh | sh -s -- --guided
  • Windows (PowerShell): Download và chạy install.ps1 với flag -Guided

Installer sẽ:

  • Hỏi bạn muốn hiển thị các provider nào (Kimi OAuth, Kimi API, DeepSeek)
  • Phát hiện xác thực hiện có (ví dụ: Kimi Code CLI OAuth session)
  • Yêu cầu API key qua terminal prompt an toàn
  • Tạo snapshot rollback của các router phiên bản cũ hơn (nếu có)
  • Cài đặt dịch vụ nền (systemd trên Linux, LaunchAgent trên macOS, Service trên Windows)
  • Chạy xác minh để chắc chắn mọi thứ hoạt động

Nếu Codex có sẵn xác thực (ví dụ: Kimi OAuth), installer có thể hoàn tất tất cả mà không cần restart Codex — chỉ restart cuối cùng là do bạn chọn.

Các Mô Hình Hỗ Trợ

Hiện tại Codex Router hỗ trợ:

Nhãn Picker ID Mô Hình Xác Thực Chi Phí
Kimi K3 (OAuth) kimi-oauth/k3 Kimi Code CLI OAuth session Tùy Kimi Code plan của bạn
Kimi K3 (API) kimi-api/kimi-k3 Kimi Platform API key Tính phí riêng qua Kimi Platform
DeepSeek V4 Flash (API) deepseek/deepseek-v4-flash DeepSeek API key Tính phí qua DeepSeek
DeepSeek V4 Pro (API) deepseek/deepseek-v4-pro DeepSeek API key Tính phí qua DeepSeek

Lưu ý: Kimi Code OAuth và Kimi Platform API là hai hệ thống xác thực & tính phí riêng biệt. Cả hai Kimi entries có thể coexist trong bộ chọn mô hình nếu bạn có cả hai.

Kiến Trúc & Công Nghệ

Codex sử dụng Responses API nội bộ, nhưng các provider bên ngoài (Kimi, DeepSeek) đều expose Chat Completions API tiêu chuẩn OpenAI. Codex Router cầu nối hai chuẩn này qua một LiteLLM adapter được ghim cố định:

  • Mỗi yêu cầu đến router trước tiên trình bày một "capability" ngẫu nhiên trong loopback URL được quản lý bởi Codex
  • Codex authentication headers (chứa token ChatGPT) chỉ được phép cho các yêu cầu native GPT
  • External routes nhận một random internal loopback key; forwarder cuối cùng loại bỏ key này và inject chỉ credential của provider được chọn
  • LiteLLM adapter dịch responses, streaming, tool calls, và compaction traffic giữa hai API styles

Stack công nghệ:

  • Ngôn ngữ: JavaScript 91%, Shell 5.1%, PowerShell 3.9%
  • Node.js 22.19+ (Node.js 24 LTS khuyến cáo)
  • Python 3.10+ (venv hoặc uv)
  • Git cho managed checkout

So Sánh Với Cách Khác

Codex Router khác biệt so với các giải pháp thay thế:

  • vs. Thay thế hoàn toàn provider: Codex Router cho phép coexistence thực sự — external models hiển thị như các mục riêng biệt trong picker, không bị "custom-ify" thành một generic entry
  • vs. Cloud proxy: Tất cả routing cục bộ (127.0.0.1) — API key không bao giờ rời khỏi máy
  • vs. Blind forwarding: Sử dụng LiteLLM adapter để dịch API style, không phải chỉ chuyển tiếp mù quáng
  • vs. Router cũ hơn: Codex Router tự động nhận diện và an toàn migrate từ các phiên bản cũ hơn (io.github.kimi-codex-router, com.ziwenxu.kimi-codex-proxy)

Hạn Chế & Khuôn Khop

Yêu cầu hệ thống:

  • Phải có Codex App hoặc Codex CLI đã cài và đã đăng nhập cho mô hình GPT gốc
  • Node.js 22.19+ (Node.js 24 LTS khuyến cáo)
  • Python 3.10+ với venv hoặc uv
  • Git

Hạn chế công nghệ:

  • Catalog override chỉ load khi app start: Nếu Kimi không hiển thị sau cài đặt, phải fully quit Codex (không chỉ đóng cửa sổ) rồi mở lại
  • Model discovery theo định hướng: Router không publish mô hình nào mà chưa verify live Codex behavior (responses, streaming, tool calls, compaction) — nó yêu cầu compatibility suite billed trước khi thêm mô hình mới vào picker
  • Update constraint: Git checkout phải clean (main branch, origin recognized) mới được update

Độc lập cộng đồng: Codex Router là dự án cộng đồng độc lập, không có affiliation chính thức với OpenAI, Moonshot AI, DeepSeek, hoặc OpenRouter. MIT licensed.

Ai Nên Dùng Ngay

Developers đã dùng Codex mà muốn mở rộng AI toolkit: Nếu bạn là lập trình viên đã ký ChatGPT & dùng Codex cho native GPT models, Codex Router cho phép bạn thêm Kimi hoặc DeepSeek mà không phá vỡ môi trường hiện tại — giữ nguyên settings, profiles, project trust, MCP setup, và ChatGPT login.

Security-conscious teams: Toàn bộ routing cục bộ, credentials được bảo vệ qua file permissions & terminal prompt, không dùng cloud proxy.

Cross-platform devs: Installer hướng dẫn và quản lý state tự động trên macOS, Windows, Linux — không cần thủ công cấu hình cho từng OS.

Users di chuyển từ router cũ hơn: Nếu bạn dùng prototypes cũ hơn, Codex Router tự động phát hiện, snapshot state, và hỗ trợ rollback an toàn.

Tình Hướng & Roadmap

Codex Router là dự án mới được launched hôm qua (21 tháng 7 năm 2026). Bộ sưu tập commit đầu tiên bao gồm installer hướng dẫn, tích hợp Kimi/DeepSeek, và cứng hoá xác thực cục bộ.

Roadmap tập trung vào:

  • Mở rộng registry provider: Registry (`config/providers.json`) sẽ định nghĩa metadata provider, upstream IDs, context windows, request profiles
  • Standard integration: Tất cả providers OpenAI-compatible đều share một credential-isolating forwarder
  • Verification trước picker: Model mới phải qua compatibility suite billed (basic responses, streaming, tool calls, compaction) trước khi được thêm vào picker

Dự án chưa có "official releases" published, nhưng tagged releases sẽ có `.tar.gz` & `.zip` source archives, SHA-256 checksums, & GitHub build-provenance attestations.

Kết Luận

Codex Router giải quyết một vấn đề thực tiễn: cho phép developer dùng Kimi & DeepSeek trực tiếp trong Codex mà không mất GPT gốc, ChatGPT login, hay tình trạng cấu hình hiện tại. Kiến trúc cục bộ, xác thực terminal prompt, & installer hướng dẫn đều chỉ tập trung vào bảo mật & user experience. Nếu bạn muốn mở rộng AI toolkit trong Codex mà giữ nguyên môi trường hiện tại, Codex Router là lựa chọn thực tế & an toàn để thử.

Đọc thêm via GitHub: Codex Router