Dùng DeepSeek, GLM, Qwen với Codex

OpenCodex là proxy chạy trên máy của bạn. Nó chuyển request của Codex sang định dạng mà DeepSeek, GLM, Qwen và các API tương thích OpenAI SDK có thể xử lý.

node --version
codex --version

npm install -g @openai/codex

npm install -g @bitkyc08/opencodex
ocx --version

ocx start

ocx gui

ocx sync --restart-codex

ocx status
ocx models live
codex -m "provider/model-id"

Cấu hình thủ công bằng CLI

Dùng cách này khi dashboard không mở hoặc bạn đang setup trên máy không có giao diện. Proxy phải đang chạy trước khi dùng các lệnh quản lý provider:

ocx start

Provider có preset

Ví dụ với DeepSeek:

ocx provider add deepseek --api-key "<API_KEY>" --set-default --sync
ocx provider test deepseek
ocx models live --provider deepseek

Thay deepseek bằng ID preset hiển thị trong ocx provider presets. Không thêm --adapter hoặc --base-url khi dùng preset vì OpenCodex đã cấu hình sẵn.

API tương thích OpenAI SDK

ocx provider add my-provider --adapter openai-chat --base-url "https://example.com/v1" --api-key "<API_KEY>" --default-model "model-id" --set-default --sync
ocx provider test my-provider
ocx models live --provider my-provider
ocx models enable "my-provider/model-id"
ocx sync --restart-codex

Thay URL, key và model ID bằng thông tin thật của dịch vụ. Nếu key đã được lưu trong file cấu hình và máy có keychain đang mở khóa, có thể chuyển key sang kho bí mật của hệ điều hành:

ocx provider keychain my-provider store

Chẩn đoán nhanh

Chạy lần lượt các lệnh sau trước khi thay đổi cấu hình:

ocx status
ocx health
ocx ready --wait --timeout 30
ocx doctor
ocx provider test <provider>
ocx models live --provider <provider>

ocx doctor thường ghi rõ nguyên nhân và hành động cần làm. Không gửi API key hoặc toàn bộ file config.json khi nhờ hỗ trợ.

Lỗi thường gặp

ocx: command not found

Mở terminal mới sau khi cài. Nếu vẫn lỗi, kiểm tra npm global bin đã nằm trong PATH:

npm config get prefix
npm list -g @bitkyc08/opencodex

Bun runtime bị thiếu hoặc npm chặn install script

Nếu lúc cài có cảnh báo install-scripts ... blocked, cài lại và cho phép script của Bun:

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

connection refused hoặc stream disconnected before completion

Proxy đã dừng hoặc chưa sẵn sàng:

ocx status
ocx start

Muốn tự khởi động lại khi proxy crash hoặc khi đăng nhập máy:

ocx service install

Port 10100 đang được sử dụng

ocx start sẽ báo process đang giữ port. Dừng process đó hoặc chọn port khác, rồi đồng bộ lại:

ocx start --port 10101
ocx sync --restart-codex

Lỗi 401 hoặc 403

API key sai, hết hạn hoặc tiến trình service không đọc được biến môi trường chứa key. Kiểm tra đúng provider trước:

ocx provider test <provider>
ocx provider show <provider> --json

Cập nhật key trong dashboard. Nếu key được tham chiếu bằng ${ENV_VAR}, biến đó phải tồn tại trong môi trường của chính proxy/service, không chỉ trong terminal đang mở.

Lỗi 404 model not found

Model ID không đúng hoặc tài khoản chưa được cấp quyền. Lấy ID mà provider thực sự công bố:

ocx models live --provider <provider>

Sau đó chọn đúng chuỗi provider/model-id; không dùng tên hiển thị của model thay cho ID.

Model không xuất hiện trong Codex

Model có thể đang tắt hoặc Codex vẫn giữ catalog cũ:

ocx models enable "provider/model-id"
ocx sync --restart-codex

Nếu vẫn chưa thấy, thoát hoàn toàn Codex App rồi mở lại và tạo task mới.

Chat chạy nhưng terminal hoặc tool không hoạt động

Provider đang dùng sai adapter hoặc model không hỗ trợ function calling. Với API tương thích OpenAI SDK thông thường, dùng openai-chat; ưu tiên preset nếu có và kiểm tra lại bằng:

ocx provider test <provider>

Nếu provider chỉ hỗ trợ chat văn bản, cần đổi sang model/endpoint có tool calling; OpenCodex không thể tự bổ sung khả năng mà model không có.

Muốn quay lại cấu hình Codex ban đầu

ocx stop       # dừng proxy và tự khôi phục Codex
ocx restore    # dùng riêng nếu proxy đã dừng nhưng config chưa được khôi phục

OpenCodex chỉ gỡ phần cấu hình do nó thêm; không cần xóa thư mục ~/.codex.

Lệnh thường dùng

Xem thêm tài liệu OpenCodex và danh sách provider.