Hướng dẫn chi tiết sử dụng CLI Proxy API cho Codex

CLIProxyAPI (hay còn gọi là CLI Proxy API) là một công cụ open-source cực kỳ hữu ích dành cho developer và cộng đồng AI coding. Đây là proxy server được phát triển bởi router-for-me, giúp “wrap” các AI CLI tools như Gemini CLI, ChatGPT Codex (OpenAI Codex), Claude Code, Qwen Code, iFlow… và expose ra dưới dạng OpenAI / Gemini / Claude / Codex compatible API.

Bạn có thể dùng subscription Codex (GPT-5.4, gpt-5.3-codex…) một cách miễn phí hoặc flat-rate qua OAuth, load balancing đa tài khoản, streaming, function calling, multimodal, và dễ dàng kết nối với Cursor, Continue.dev, Cline, VS Code extensions, Amp CLI… mà không cần trả tiền theo token.

Bài viết này sẽ hướng dẫn chi tiết từng bước cách cài đặt, cấu hình và sử dụng CLIProxyAPI dành riêng cho Codex (OpenAI Codex CLI).

CLIProxyAPI là gì và lợi ích khi dùng với Codex?

Hỗ trợ OAuth cho OpenAI Codex (device code flow hoặc browser login).
Multi-account load balancing: Dùng nhiều tài khoản Codex cùng lúc, round-robin hoặc fill-first.
Compatible API: Dùng được với bất kỳ tool nào hỗ trợ OpenAI format (/v1/chat/completions, /v1/models…).
Tích hợp sâu với Codex CLI: Có thể cấu hình Codex CLI chính thức trỏ thẳng về proxy local của bạn.
An toàn & tiện lợi: Không cần expose API key thật, hỗ trợ management API + dashboard.

Lợi ích cụ thể với Codex:

Dùng gpt-5.4 / gpt-5.3-codex trong Cursor, Continue, Roo Code… mà chỉ cần subscription Codex CLI.
Tránh giới hạn rate-limit của OpenAI trực tiếp.
Dễ scale với nhiều tài khoản.

Repo chính thức: github.com/router-for-me/CLIProxyAPI

Yêu cầu hệ thống

Go 1.21+ (nếu build từ source) hoặc Docker.
Git.
Tài khoản OpenAI có subscription Codex / ChatGPT (để OAuth).
Port 8317 (mặc định) chưa bị chiếm.

Cài đặt CLIProxyAPI

Cách 1: Dùng Docker (Khuyến nghị cho server/VPS)

Tạo file docker-compose.yml:

services:
  cliproxy:
    image: ghcr.io/router-for-me/cliproxyapi:latest  # hoặc build local
    container_name: cliproxyapi
    ports:
      - "8317:8317"
    volumes:
      - ./config.yaml:/app/config.yaml
      - ./data:/app/data
    environment:
      - TZ=Asia/Ho_Chi_Minh
    restart: unless-stopped

Chạy: docker compose up -d

Cách 2: Build từ source (Mac/Windows/Linux)

git clone https://github.com/router-for-me/CLIProxyAPI.git
cd CLIProxyAPI
go build -o cliproxyapi .

Hoặc dùng pre-built binary từ Releases.

Cấu hình cơ bản (config.yaml)

Copy file mẫu:

cp config.example.yaml config.yaml

Thêm phần Codex (ví dụ):

server:
  port: 8317
  host: 0.0.0.0

# Codex provider
codex:
  enabled: true
  # Multi-account load balancing
  accounts:
    - id: codex-acc1
      # OAuth sẽ tự động lưu sau login

Bạn có thể thêm OpenAI-compatible upstream (OpenRouter, v.v.) nếu cần.

Login OAuth cho Codex

CLIProxyAPI hỗ trợ device code flow hoặc browser OAuth cho Codex.

Chạy lệnh:

./cliproxyapi --codex-login
# Hoặc với Docker: docker exec -it cliproxyapi ./cliproxyapi --codex-login

Mở link trên trình duyệt → Login tài khoản OpenAI.
Xác nhận quyền → Copy code về terminal nếu cần.
CLIProxyAPI sẽ lưu session OAuth vào data/ hoặc volume.

Bạn có thể login nhiều tài khoản (multi-account).

Chạy server CLIProxyAPI

./cliproxyapi
# Hoặc docker compose up -d

Server sẽ chạy tại http://localhost:8317

Kiểm tra models:

curl http://localhost:8317/v1/models \
  -H "Authorization: Bearer dummy-key"

Cấu hình Codex CLI để sử dụng CLIProxyAPI (dành cho Codex)

Đây là phần quan trọng nhất mà nhiều người tìm kiếm.

Cài Codex CLI chính thức (nếu chưa có):

npm install -g @openai/codex
codex auth  # login lần đầu nếu cần

Tạo / chỉnh sửa 2 file config của Codex:

~/.codex/config.toml

profile = "cliproxy"

[model_providers.cliproxy]
name = "CLI Proxy"
base_url = "http://localhost:8317/v1"
env_key = "CLIPROXY_API_KEY"
wire_api = "responses"

[profiles.cliproxy]
model_provider = "cliproxy"
model = "gpt-5.4"
models = [
  "gpt-5.4",
  "gpt-5.4-mini",
  "gpt-5.3-codex",
  "gpt-5.2-codex",
  "gpt-4o",
  "gpt-4o-mini"
]

~/.codex/auth.json (dummy key, proxy sẽ xử lý thực)

{
  "auth_mode": "apikey",
  "CLIPROXY_API_KEY": "dammy-api-key" # thay bằng API Key bạn tạo trong CLIProxy API
}

Khởi động Codex CLI bình thường:

codex

Bây giờ Codex CLI sẽ gửi request qua CLIProxyAPI → sử dụng session OAuth của bạn, hỗ trợ multi-account, quota monitoring…

Sử dụng với các tool khác (Cursor, Continue.dev, VS Code…)

Ví dụ với Cursor / Continue:

Base URL: http://localhost:8317/v1
API Key: bất kỳ (thường dùng sk-dummy hoặc key bạn set trong config)
Model: gpt-5.3-codex hoặc alias bạn tạo

Test nhanh bằng curl:

curl http://localhost:8317/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-dummy" \
  -d '{
    "model": "gpt-5.3-codex",
    "messages": [{"role": "user", "content": "Viết một function Python tính Fibonacci"}],
    "stream": true
  }'

Tính năng nâng cao

Management API: http://localhost:8317/management (xem quota, logs, reload config).
Dashboard: Một số cộng đồng có UI quản lý (tìm “CLIProxyAPI Management Center” trên GitHub).
Model alias & fallback: Rất hữu ích khi một model bị rate-limit.
Hot reload: Chỉnh config.yaml mà không cần restart.
Amp CLI / IDE extensions: Hỗ trợ native provider routing.

Troubleshooting thường gặp

OAuth fail: Xóa folder data/ và login lại.
Port conflict: Đổi port trong config.yaml và config.toml của Codex.
Model not found: Kiểm tra /v1/models và alias.
Rate limit: Thêm nhiều account Codex và bật load balancing.
Docker permission: Mount volume đúng cách.

Lưu ý an toàn:

Chỉ chạy trên localhost hoặc VPS riêng.
Không public port 8317 ra internet trừ khi có auth layer.
Backup folder data chứa OAuth session.

—

Với CLIProxyAPI, bạn đã biến subscription Codex (hoặc Gemini/Claude) thành một OpenAI-compatible API server cực mạnh, tiết kiệm và linh hoạt. Đây là giải pháp lý tưởng cho developer Việt Nam muốn dùng AI coding tools mạnh mẽ mà không tốn kém.