lidge-jun/opencodex

Kết luận: fit · Công nghệ: llm-proxy · ai-gateway · codex-cli · claude-code · openrouter

opencodex là một proxy/gateway đa nhà cung cấp giúp dùng nhiều LLM như Claude, Gemini, Grok, DeepSeek, Ollama với hệ sinh thái OpenAI Codex và Claude Code. Với ~5.9k sao và tập trung vào codex-cli, llm-proxy, openrouter, đây là công cụ thực dụng để chuẩn hóa endpoint/model routing, đặc biệt hữu ích khi muốn đổi backend AI mà không phải sửa nhiều ở client.

📖 Giới thiệu chi tiết

🧩 Nó là gì?

lidge-jun/opencodex là một proxy/gateway chạy trên máy bạn, giúp các công cụ như OpenAI Codex, Codex CLI, Codex App, SDK, Claude Code, Claude Desktop và Grok Build dùng được nhiều LLM khác nhau như Claude, Gemini, Grok, DeepSeek, Kimi, Qwen, Ollama, OpenRouter… mà không cần chờ công cụ đó hỗ trợ trực tiếp.

Nói đơn giản: bạn vẫn dùng giao diện/lệnh quen thuộc của Codex hoặc Claude Code, nhưng “bộ não AI” phía sau có thể đổi sang nhà cung cấp khác.

🎯 Giải quyết vấn đề gì? Dành cho ai?

opencodex giải quyết một vấn đề rất thực tế: mỗi công cụ AI thường chỉ hỗ trợ một số model hoặc nhà cung cấp nhất định. Nếu bạn muốn đổi từ OpenAI sang Claude, Gemini, DeepSeek, Ollama local model, hoặc OpenRouter, bạn thường phải đổi công cụ, đổi cấu hình, hoặc viết lại phần kết nối.

Với opencodex, bạn có thể:

• Dùng nhiều LLM trong cùng một workflow quen thuộc của Codex hoặc Claude Code.
• Đổi provider/model bằng cú pháp rõ ràng như anthropic/claude-opus-5 hoặc ollama/llama3.
• Chạy model cloud hoặc model local thông qua Ollama.
• Quản lý endpoint, API key, model routing ở một nơi.
• Dùng Codex CLI/App/SDK với các provider không phải OpenAI.

Dự án này phù hợp với:

• Người mới muốn thử nhiều model AI mà không phải học quá nhiều công cụ khác nhau.
• Lập trình viên đang dùng codex hoặc Claude Code và muốn linh hoạt chọn model.
• Team muốn chuẩn hóa cách gọi LLM qua một proxy nội bộ.
• Người dùng muốn dùng model local như Ollama nhưng vẫn giữ workflow của Codex.
• Người dùng nâng cao muốn quản lý nhiều tài khoản ChatGPT/Codex, quota và failover.

⚙️ Hoạt động ra sao?

Cơ chế chính của opencodex có thể hiểu như sau:

• opencodex chạy một proxy local tại localhost:10100.
• Codex CLI/App/SDK hoặc Claude Code gửi request đến opencodex thay vì gọi thẳng một provider.
• opencodex nhận request theo kiểu Codex Responses API, rồi “dịch” sang định dạng mà provider phía sau hiểu.
• Provider phía sau có thể là Anthropic, Google, xAI, Kimi, Groq, OpenRouter, Azure, DeepSeek, GLM, Ollama, OpenAI…
• Bạn chọn model bằng cú pháp provider/model, ví dụ google/gemini-3-pro.
• Nếu không ghi provider/, opencodex sẽ dùng provider mặc định hoặc tự đoán dựa trên tên model.
• Dashboard web tại http://localhost:10100 giúp thêm provider, nhập API key, xem model, cấu hình routing.
• Model từ provider có thể được tự phát hiện qua endpoint /v1/models.
• Các tính năng như streaming, tool calls, reasoning tokens và images được proxy hai chiều.
• Với ChatGPT/Codex account pool, opencodex có thể chọn tài khoản ít dùng nhất, giữ phiên cũ gắn với đúng tài khoản ban đầu, và failover khi gặp lỗi quota/auth.

Mô hình đơn giản:

Codex CLI / App / SDK ──/v1/responses──▶ opencodex ──▶ Any provider
                                              │
              Anthropic · Google · xAI · Kimi · Ollama Cloud · Groq
              OpenRouter · Azure · DeepSeek · GLM · …and OpenAI itself

🆚 Khi nào nên dùng / không nên

Nên dùng opencodex khi:

• Bạn thích dùng Codex CLI, Codex App, SDK, Claude Code, Claude Desktop hoặc Grok Build nhưng muốn chọn nhiều model khác nhau.
• Bạn muốn thử nhanh Claude, Gemini, Grok, DeepSeek, Kimi, Qwen, Ollama… trong cùng một luồng làm việc.
• Bạn cần một nơi trung gian để quản lý provider, API key, model routing.
• Bạn muốn chạy local model qua Ollama nhưng vẫn dùng lệnh codex.
• Bạn có nhiều tài khoản ChatGPT/Codex và muốn hỗ trợ quota, affinity, cooldown, failover.

Không nên dùng hoặc chưa cần dùng khi:

• Bạn chỉ dùng đúng một provider và công cụ hiện tại đã hỗ trợ tốt.
• Bạn không muốn chạy thêm proxy local trên máy.
• Bạn cần một giải pháp chính thức 100% từ từng provider, không qua lớp trung gian.
• Bạn chưa quen với việc cấu hình API key, endpoint, model id.
• Bạn đang ở môi trường công ty có chính sách bảo mật nghiêm ngặt và chưa được phép dùng proxy local.

So với việc gọi thẳng API của từng provider, opencodex tiện hơn vì gom nhiều provider vào một cách dùng chung. Đổi lại, bạn có thêm một lớp trung gian cần cài đặt, cấu hình và theo dõi.

🚀 Bắt đầu nhanh

Yêu cầu cơ bản:

• Cần Node 18+.
• Không cần cài Bun riêng, vì Bun runtime được bundle tự động khi cài qua npm.
• Hỗ trợ macOS, Linux và Windows.
• Nên dùng Node thuộc user như nvm hoặc fnm, hạn chế sudo npm install -g … nếu không cần.

Cài đặt và chạy:

# Cài opencodex
npm install -g @bitkyc08/opencodex

# Thiết lập tương tác: ghi config, inject vào Codex,
# và gợi ý cài autostart shim
ocx init

# Chạy proxy + dashboard tại localhost:10100
ocx start

# Nếu bỏ qua autostart shim lúc init, có thể cài sau
ocx codex-shim install

# Dùng Codex như bình thường
codex "Write a hello world in Rust"

Mở dashboard để thêm provider:

ocx gui

Sau đó trong dashboard tại http://localhost:10100:

1. Click "Add Provider"
2. Chọn provider có sẵn hoặc nhập OpenAI-compatible endpoint tùy chỉnh
3. Dán API key hoặc đăng nhập OAuth nếu provider hỗ trợ
4. Chờ opencodex tự phát hiện models từ /v1/models

Ví dụ chọn model cụ thể:

# Dùng Claude Opus qua Anthropic
codex -m "anthropic/claude-opus-5" "Explain this stack trace"

# Dùng Gemini qua Google
codex -m "google/gemini-3-pro" "Write unit tests for auth.ts"

# Dùng GLM qua Ollama Cloud
codex -m "ollama-cloud/glm-5.2" "Write a SQL migration"

# Dùng local model qua Ollama
codex -m "ollama/llama3" "Refactor this function"

Nếu gặp lỗi "bundled Bun runtime is missing" do npm chặn install script của Bun, cài lại như sau:

npm install -g --allow-scripts=bun @bitkyc08/opencodex

✅ Điểm mạnh & ⚠️ Hạn chế

Điểm mạnh:

• Hỗ trợ nhiều provider/model trong cùng một workflow Codex hoặc Claude Code.
• Cài nhanh bằng npm install -g @bitkyc08/opencodex.
• Có dashboard web dễ dùng tại http://localhost:10100.
• Có thể dùng model cloud lẫn local model qua Ollama.
• Hỗ trợ model routing bằng cú pháp dễ nhớ provider/model.
• Không cần chờ Codex hoặc Claude Code chính thức hỗ trợ từng provider.
• Có thể quản lý ChatGPT/Codex account pool, quota, affinity, cooldown và failover.
• Hỗ trợ macOS, Linux, Windows; không cần WSL trên Windows.

Hạn chế:

• Cần chạy thêm một proxy local, nên hệ thống có thêm một lớp cấu hình.
• Người mới vẫn cần hiểu cơ bản về API key, provider và model id.
• Một số model hoặc tính năng có thể phụ thuộc vào việc provider upstream có thật sự hỗ trợ hay chưa.
• Nếu provider đổi API hoặc giới hạn quota, opencodex vẫn bị ảnh hưởng.
• Với môi trường doanh nghiệp, cần kiểm tra kỹ chính sách bảo mật trước khi đưa request qua proxy local.
• Việc quản lý nhiều tài khoản/API key tiện lợi nhưng cũng cần cẩn thận để tránh nhầm cấu hình.