opencodex — proxy cục bộ cho phép dùng bất kỳ LLM nào với Codex

Codex chỉ hỗ trợ các mô hình của OpenAI. Nếu muốn dùng Claude thì sao? Nếu muốn code với GLM-5.2 thì sao? Bạn sẽ phải chờ đến khi OpenAI bổ sung.

opencodex là một proxy cục bộ giải quyết vấn đề này. Nó đứng giữa Codex và nhà cung cấp LLM, rồi dịch giao thức theo thời gian thực. Streaming, gọi công cụ, token suy luận, hình ảnh — tất cả đều hoạt động hai chiều.

Trong bộ chọn mô hình của ứng dụng Codex, CLI và SDK,
nó được đăng ký bình thường
và trong cùng một phiên có thể sử dụng cả GPT lẫn tất cả các mô hình đã đăng ký.

npm install -g @bitkyc08/opencodex  
ocx init      # chọn nhà cung cấp  
ocx start     # khởi động proxy  
codex -m "anthropic/claude-opus-4-8" "Sửa lỗi này giúp tôi"  

Cách nó hoạt động

Codex chỉ dùng giao thức riêng là Responses API (/v1/responses). Phần lớn LLM không triển khai giao thức này. opencodex sẽ dịch thông qua 5 adapter giao thức (Anthropic Messages, Google Gemini, Azure, OpenAI passthrough, OpenAI-compatible Chat Completions). Hơn 40 nhà cung cấp đã được tích hợp sẵn.

Các mô hình được định tuyến sẽ xuất hiện trong bộ chọn mô hình của Codex như mô hình native. Chỉ cần chỉ định theo định dạng provider/model.

Những khó khăn khi xây dựng

Thiết kế proxy có nhiều dự án mã nguồn mở tham khảo nên việc triển khai khá dễ,
nhưng để mang lại trải nghiệm native cho Codex thì việc mổ xẻ codex-rs là điều bắt buộc.

Ánh xạ reasoning effort. Mỗi nhà cung cấp dùng tên effort khác nhau. GLM dùng "max", còn Codex gọi là "xhigh". Kimi thì từ chối hẳn tham số này. Cuối cùng phải tạo bảng chuyển đổi riêng theo từng mô hình.

Lịch sử phiên. Codex lưu model_provider của từng thread vào DB. Khi chuyển sang opencodex thì toàn bộ phiên cũ đều không còn hiển thị. Vì vậy đã phải mở trực tiếp SQLite và tạo một migrator đổi thẻ model_provider khi inject/restore. Mtime của file cũng được giữ nguyên để thứ tự khôi phục không bị xáo trộn.

Sidecar. Các mô hình không phải OpenAI không thể tìm kiếm web hay hiểu hình ảnh. Tính năng này được định tuyến qua sidecar gpt-5.4-mini bằng đăng nhập ChatGPT, để Claude hay GLM cũng có thể thực hiện tìm kiếm web thực sự.

Tắt đi là trở về như cũ

Khi chạy ocx stop, toàn bộ cấu hình Codex, catalog và lịch sử phiên sẽ được khôi phục về bản gốc. Không để lại dấu vết. Nút Stop trên dashboard hoặc ocx service uninstall cũng cho kết quả tương tự.

Giấy phép MIT. Native trên macOS/Linux/Windows (không cần WSL).

GitHub: https://github.com/lidge-jun/opencodex
npm: npm install -g @bitkyc08/opencodex