Kết nối OpenAI Codex CLI / App với LaRouter

Dùng một API key LaRouter cho các tài khoản được cấu hình. Mỗi tài khoản giữ hạn mức riêng.

Cách 1: Dùng nút Cấu hình

Đăng nhập, chọn tệp cấu hình trên máy rồi bấm Áp dụng LaRouter. Công cụ tự điền API key và model, sau đó ghi ngay vào tệp. Nút Đặt lại thiết lập mặc định cũng ghi trực tiếp. Nếu trình duyệt không hỗ trợ, hãy cấu hình thủ công.

Xem hướng dẫn thủ công

Vị trí tệp cấu hình

macOS: ~/.codex/config.toml
Linux: ~/.codex/config.toml
Windows: %USERPROFILE%\.codex\config.toml

Đây là đường dẫn mặc định. Nếu chạy công cụ trong WSL, dùng đường dẫn Linux bên trong WSL. Nếu đã đổi thư mục cấu hình, chọn tệp thực tế của công cụ. Trình duyệt chỉ đọc hoặc ghi tệp bạn chọn.

Cách 2: Cấu hình thủ công

Sao lưu tệp rồi thay các giá trị mẫu theo hướng dẫn. Riêng Codex đã có sẵn model gpt-5.6-sol. Tên model không dùng tiền tố định tuyến như cx/. Giữ phần định danh nhà cung cấp mà công cụ yêu cầu, chẳng hạn larouter/ nếu có trong mẫu, và giữ nguyên các thiết lập khác.

Trước khi bắt đầu

Lấy API key được cấp trong trang quản lý và đảm bảo đã kết nối tài khoản Codex. Codex dùng model mặc định gpt-5.6-sol. Ví dụ lệnh dùng Bash hoặc zsh trên macOS/Linux. Thay YOUR_API_KEY bằng API key được cấp cho bạn.

Biến môi trường

export LAROUTER_API_KEY="YOUR_API_KEY"

Model có thể sử dụng

curl https://i-larouter.lapage.vn/v1/models \
  -H "Authorization: Bearer $LAROUTER_API_KEY"

1. Kết nối công cụ lập trình và agent CLI

Với Codex CLI đã cài trên máy, sao lưu ~/.codex/config.toml rồi hợp nhất các thiết lập dưới đây. Đặt model và model_provider ở đầu tệp, trước các khối [section]. Thay YOUR_API_KEY; model đã được đặt là gpt-5.6-sol, không có tiền tố router.

~/.codex/config.toml

model = "gpt-5.6-sol"
model_provider = "larouter"

[model_providers.larouter]
name = "LaRouter"
base_url = "https://i-larouter.lapage.vn/v1"
wire_api = "responses"
requires_openai_auth = false
supports_standalone_web_search = true
experimental_bearer_token = "YOUR_API_KEY"
http_headers = { "x-openai-actor-authorization" = "larouter" }

Mở phiên Codex mới

codex

Mở một phiên Codex mới và gửi yêu cầu ngắn để kiểm tra. Codex dùng Responses, không cấu hình endpoint /chat/completions cho CLI. Với agent CLI khác, kiểm tra công cụ có hỗ trợ endpoint tùy chỉnh, Bearer API key và giao thức tương thích hay không. Đặt experimental_bearer_token trong [model_providers.larouter], chỉ điền API key, không thêm tiền tố Bearer. Đặt http_headers dạng inline trong cùng phần cấu hình nhà cung cấp. Thay khối [model_providers.larouter.http_headers] cũ bằng dòng này, bỏ Authorization và giữ các header tùy chỉnh khác trong bảng inline.