lidge-jun/opencodex

mở codex!

Proxy nhà cung cấp toàn cầu cho OpenAI Codex, Claude Code, Claude Desktop & Grok Build
Hai lệnh và mỗi lệnh chạy bất kỳ LLM nào mà bạn trỏ vào.

npm install -g @bitkyc08/opencodex
ocx start        # proxy + dashboard on localhost:10100

Claude Code, chạy bất kỳ mô hình nào. Xe nhặt hàng còn hàng Claude Code. Bộ não đằng sau nó thì không.	Codex, chạy bất kỳ mô hình nào. Chọn một nhà cung cấp và bắt đầu - cùng một quy trình làm việc, nhưng bộ não khác nhau.
Claude Máy tính để bàn, chạy mọi model. Opus trả lời, sau đó giao nhiệm vụ cho đại lý phụ GPT-5.6 Sol.	Grok Build, chạy mọi model. Sol điều khiển phiên và gọi tác nhân phụ Kimi K3.

Tiếng Anh · người Pháp · 한국어 · 简体中文 · 繁體中文 · Русский · 日本語 · Türkçe · 📖 Tài liệu đầy đủ →

opencodex là một proxy cục bộ nhẹ giúp dịch Phản hồi của Codex API thành bất cứ điều gì nhà cung cấp của bạn nói — phát trực tuyến, gọi công cụ, mã thông báo lý luận, hình ảnh, theo cả hai hướng. Sử dụng Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, Ollama hoặc bất kỳ LLM nào khác với Codex, Claude Code, Claude Desktop và Grok Build. Nó cũng có thể quản lý một Nhóm tài khoản ChatGPT đối với Codex auth: thêm tài khoản, làm mới hạn ngạch của họ trong bảng điều khiển và cho phép các phiên mới tự động định tuyến đến tài khoản lành mạnh có mức sử dụng thấp nhất trong khi các chuỗi hiện có vẫn được ghim vào tài khoản đã khởi động chúng.

Bắt đầu nhanh

Đối với con người

npm install -g @bitkyc08/opencodex   # Node 18+; the Bun runtime is bundled automatically
ocx start                            # or `ocx service` to run it in the background

curl -fsSL https://bun.sh/install | bash
git clone https://github.com/lidge-jun/opencodex.git
cd opencodex && ~/.bun/bin/bun install
~/.bun/bin/bun run src/cli/index.ts start

irm bun.sh/install.ps1 | iex
git clone https://github.com/lidge-jun/opencodex.git
cd opencodex; bun install
bun run src/cli/index.ts start

Mở HTTP://localhost:10100 và định cấu hình mọi thứ trong trang tổng quan web — thêm nhà cung cấp (hơn 40 phần mềm tích hợp hoặc bất kỳ điểm cuối tương thích OpenAI nào), chọn mô hình, quản lý tài khoản. ocx gui mở lại bảng điều khiển bất kỳ lúc nào. Nó cũng có thể quản lý một Nhóm tài khoản ChatGPT cho xác thực Codex. Thêm nhiều tài khoản ChatGPT / Codex, làm mới hạn ngạch 5h / tuần / 30 ngày của họ trong bảng điều khiển. Theo định tuyến hạn ngạch, các phiên mới có thể sử dụng tài khoản lành mạnh có mức sử dụng thấp nhất; round-robin và fill-first sử dụng chính sách riêng của họ. Các luồng Codex hiện tại thường giữ nguyên mối quan hệ với tài khoản đã khởi động chúng, do đó, các phiên SSH, tmux hoặc kết nối di động kéo dài không chuyển tài khoản giữa cuộc trò chuyện — nhưng việc đánh giá lại hạn ngạch, chuyển đổi dự phòng, loại trừ tài khoản, hết hạn mối quan hệ hoặc khôi phục 401/403 và 429 có thể ràng buộc chúng. Cung cấp thứ tự lựa chọn cho các tài khoản khi một trong số chúng - thường là thông tin đăng nhập Codex Desktop của bạn - chỉ nên truy cập sau khi các tài khoản khác đã cạn kiệt.

Dành cho đại lý

npm install -g @bitkyc08/opencodex
ocx start     # or `ocx service`
ocx init      # interactive setup: writes ~/.opencodex/config.json and wires Codex

ocx init không bao giờ khởi động proxy; bắt đầu trước (hoặc sau - thứ tự nào cũng hoạt động, nhưng các lệnh không có đầu như ocx provider add và ocx combo set nói chuyện với sống proxy và thoát khác 0 khi không thể truy cập được). ocx status / ocx doctor / ocx health báo cáo trạng thái đang chạy.

Đại lý cài đặt hoặc chạy opencodex: đọc AGENTS_INSTALL.md. Một tính tương tác ocx start có thể hỏi một lần xem có gắn dấu sao cho kho lưu trữ này hay không - đó là quyết định của người dùng, không bao giờ là của đại lý. CLI ngăn chặn lời nhắc chạy do tác nhân điều khiển và API từ chối chúng bằng 403 agent_consent_required.

Nền tảng được hỗ trợ

Yêu cầu Nút 18+. Thời gian chạy Bun được gói trên npm install — không cần cài đặt Bun riêng biệt, không cần WSL trên Windows. Nếu npm chặn các tập lệnh cài đặt của thời gian chạy đi kèm, hãy xem phần tài liệu cài đặt.

Điểm nổi bật

• Sử dụng bất kỳ LLM nào với Codex, Claude Code, Claude Desktop và Grok Build — Hơn 40 nhà cung cấp có sẵn, mỗi nhà cung cấp đều giữ giao diện người dùng gốc của riêng mình.

• Nhóm trò chuyệnGPT tài khoản - mối quan hệ luồng, tự động chuyển đổi nhận biết hạn ngạch, thời gian hồi chiêu và xử lý xác thực đóng không thành công.

  Lưu ý về chính sách của nhà cung cấp: Việc gộp tài khoản chỉ nhằm mục đích định tuyến và phục hồi hoạt động; nó không đảm bảo sự bảo vệ khỏi các giới hạn tỷ lệ của nhà cung cấp, việc thực thi, đình chỉ hoặc các hành động tài khoản khác. OpenCodex không xác nhận việc sử dụng các tài khoản bổ sung để vượt qua giới hạn của nhà cung cấp hoặc chia sẻ thông tin xác thực tài khoản giữa mọi người. Bạn có trách nhiệm tuân thủ các điều khoản hiện tại của từng nhà cung cấp. Xem Hướng dẫn về nhóm tài khoản Codex Auth và Điều khoản sử dụng hiện tại của OpenAI.

• Combo — một id mô hình ảo có chuyển đổi dự phòng hoặc luân chuyển có trọng số giữa các nhà cung cấp. Xem hướng dẫn kết hợp.

• Đại lý phụ trên mọi mô hình — mô tả các mô hình được định tuyến trong bộ chọn tác nhân phụ của Codex, với chuỗi dự phòng và điều khiển bề mặt v1/v2. Xem hướng dẫn đại lý phụ.

• Đăng nhập một lần, bỏ qua phím API — OAuth cho xAI, Anthropic và Kimi; hoặc chuyển tiếp codex login, dán một phím hoặc sử dụng ${ENV_VAR} tài liệu tham khảo.

• Tìm kiếm trên web và xe sidecar tầm nhìn — các mô hình không phải OpenAI nhận được sự hiểu biết về hình ảnh và tìm kiếm trên web thực sự thông qua một sidecar qua thông tin đăng nhập ChatGPT của bạn.

• Xem chuyện gì đang xảy ra — trang tổng quan hiển thị nhà cung cấp, trạng thái OAuth, lựa chọn mô hình và nhật ký yêu cầu trực tiếp với số lượng mã thông báo bộ nhớ đệm.

• Lối ra sạch sẽ, không có cặn — ocx stop khôi phục Codex về cấu hình ban đầu của nó.

• Quyền sở hữu bộ nhớ bị giới hạn — mọi bộ đệm tồn tại lâu dài, bộ đệm vòng và kho lưu trữ dịch giao thức đều có giới hạn hữu hạn, ngân sách byte hoặc điều chỉnh hoạt động. Không có giới hạn Map hoặc Set sống sót sau khi tải lại cấu hình.

Định tuyến mô hình

Nhắm mục tiêu bất kỳ nhà cung cấp và mô hình đã định cấu hình nào bằng provider/model cú pháp:

codex -m "anthropic/claude-opus-5" "Explain this stack trace"
codex -m "google/gemini-3-pro" "Write unit tests for auth.ts"
codex -m "ollama/llama3" "Refactor this function"

Bỏ qua provider/ tiền tố để sử dụng nhà cung cấp mặc định hoặc tự động khớp theo mẫu tên mẫu. Id mô hình nhà cung cấp có chứa / được hiển thị bằng dấu gạch chéo bên trong được đặt bí danh là -; dạng dấu gạch chéo đầy đủ thô vẫn tiếp tục hoạt động. Chi tiết: tài liệu định tuyến mô hình.

Nhà cung cấp & bộ điều hợp

OpenAI (thông tin đăng nhập ChatGPT hoặc khóa API), Anthropic, Google Gemini, xAI, Kimi, Azure OpenAI, Ollama (cục bộ + Đám mây), Cursor (thử nghiệm) và mọi điểm cuối tương thích với OpenAI — cộng với DeepSeek, Groq, OpenRouter, Together, Fireworks, Cerebras, Mistral, Hugging Face, NVIDIA NIM, MiniMax, Qwen Cloud, SiliconFlow, v.v. Danh sách đầy đủ: ocx init hoặc tài liệu của nhà cung cấp.

CLI

ocx init                       # interactive setup (writes config, wires Codex, offers the shim)
ocx start [--port 10100]       # start the proxy in the foreground
ocx stop                       # stop + restore native Codex
ocx service [install|repair|restart|start|stop|status|uninstall|remove]  # background service
ocx codex-shim install         # start the proxy on demand whenever `codex` launches
ocx health [--json]            # check immediate proxy liveness
ocx ready [--json] [--wait [--timeout <seconds>]]  # check post-sync readiness
ocx status                     # is the proxy running?
ocx gui                        # open the web dashboard
ocx provider <...>             # manage providers (list/add/edit/test/remove)
ocx account <...>              # manage ChatGPT accounts & API-key pools
ocx combo <...>                # manage failover / round-robin combos
ocx v2 <...>                   # multi-agent v1/v2 surface controls
ocx update [--tag preview]     # update opencodex

Các lần khởi động không được ghim có thể chọn một cổng trống khác nếu cổng ưa thích đang bận; một cách rõ ràng --port không bao giờ nhảy. Tham khảo đầy đủ: CLI tài liệu.

Sức khỏe và sự sẵn sàng

GET /healthz báo cáo hoạt động proxy ngay lập tức. Không được xác thực GET /readyz điểm cuối báo cáo mức độ sẵn sàng sau đồng bộ hóa với danh tính JSON đã được làm sạch {service, version, uptime, pid, port, status}. Nó trở lại 200 khi nào status là ready; pending và thiết bị đầu cuối failed trở về 503 với Retry-After: 1.

ocx ready [--json] [--wait [--timeout <seconds>]] thực hiện một thăm dò theo mặc định. --wait bỏ phiếu trong tối đa 45 giây theo mặc định, nhưng thoát ngay lập tức khi quan sát thiết bị đầu cuối failed; --timeout <seconds> đặt giới hạn 1–300 giây, yêu cầu --waitvà chỉ chấp nhận số nguyên dương. CLI --json đầu ra là {ready, status, pid, port}, ở đâu status là ready, pending, failedhoặc unreachable.

Một proxy cũ hơn không có /readyz không đóng được như unreachable với lối ra 1, trong khi ocx health vẫn tương thích.

Tự khởi động: dịch vụ vs shim

Sử dụng dịch vụ (ocx service) cho proxy luôn bật khởi động lại khi gặp sự cố. Sử dụng miếng chêm (ocx codex-shim install) để khởi động nhẹ, theo yêu cầu mà không cần nền nền. Loại bỏ chúng với ocx service uninstall / ocx codex-shim uninstall.

Gỡ cài đặt

ocx uninstall                  # stop, remove service/shim, restore native Codex, clean up state
npm uninstall -g @bitkyc08/opencodex

Truy cập từ xa

Theo mặc định, opencodex liên kết với 127.0.0.1 và không cần xác thực thêm. Ràng buộc ngoài loopback ("hostname": "0.0.0.0") yêu cầu mã thông báo mang - proxy từ chối bắt đầu mà không có OPENCODEX_API_AUTH_TOKENvà mọi yêu cầu của khách hàng phải mang nó dưới dạng x-opencodex-api-key. Chi tiết: tham khảo cấu hình.

Tài liệu

Các tài liệu công khai — cài đặt, nhà cung cấp, định tuyến, tổ hợp, tác nhân phụ, sidecar, tích hợp và tham chiếu CLI/config/management-API — được xây dựng từ docs-site/ và xuất bản tới opencodex.me.

Người duy trì ghi chú nguồn gốc của sự thật sống dưới structure/, thiết lập cộng tác viên trong CONTRIBUTING.mdvà báo cáo bảo mật trong SECURITY.md. Báo cáo các lỗ hổng chưa được tiết lộ một cách riêng tư thông qua Báo cáo lỗ hổng bảo mật riêng tư GitHub, không phải là vấn đề công cộng.

Phát triển

Việc phát triển nguồn đòi hỏi bun CLI trên của bạn PATH. Điều này tách biệt với thời gian chạy Bun đi kèm của gói npm đã xuất bản, chỉ được sử dụng bởi những người đã cài đặt ocx lệnh.

git clone https://github.com/lidge-jun/opencodex.git
cd opencodex
bun install
bun run typecheck
bun run test

Xem Đóng góp.

Tuyên bố miễn trừ trách nhiệm

opencodex là một dự án độc lập, được cộng đồng duy trì và được không được liên kết hoặc xác nhận bởi OpenAI, Anthropic hoặc bất kỳ nhà cung cấp nào khác.

Một số nhà cung cấp — đặc biệt là Anthropic (Claude) — có thể tạm dừng hoặc hạn chế các tài khoản định tuyến lưu lượng truy cập API thông qua proxy của bên thứ ba. Sử dụng có nguy cơ của riêng bạn (UAYOR). Trước khi kết nối nhà cung cấp, hãy xem lại Điều khoản dịch vụ của nhà cung cấp đó để xác nhận rằng quyền truy cập dựa trên proxy được cho phép. Những người duy trì opencodex không chịu trách nhiệm về bất kỳ hành động tài khoản nào được thực hiện bởi các nhà cung cấp thượng nguồn.

Giấy phép

MIT