Cấu hình Codex

1. Giới thiệu OpenAI Codex CLI và yêu cầu hệ thống

OpenAI Codex CLI là agent lập trình cục bộ do OpenAI cung cấp. Công cụ này có thể hiểu repository, sửa mã và thực thi lệnh trong terminal, đồng thời có thể dùng cùng các editor như VS Code, Cursor, Windsurf.

Trước khi bắt đầu, hãy chuẩn bị:

• Môi trường terminal hoạt động bình thường
• Node.js 16 trở lên
• API key được tạo trong console RouteAPI
• Mô hình giao thức OpenAI khả dụng trong console RouteAPI

Giải thích giao thức

Codex hiện sử dụng giao thức Responses tương thích OpenAI. Khi tích hợp RouteAPI, hãy dùng https://www.routeapi.ai/v1 và chọn mô hình hỗ trợ giao thức OpenAI trong console.

2. Cài đặt OpenAI Codex CLI

Cài đặt toàn cục

npm install -g @openai/codex

Nếu bạn dùng Homebrew, cũng có thể cài đặt:

brew install --cask codex

Kiểm tra cài đặt

codex --version

Nếu hiển thị số phiên bản, nghĩa là cài đặt thành công.

3. Cấu hình RouteAPI

Tệp cấu hình cấp người dùng của Codex mặc định là ~/.codex/config.toml. Trên Windows, thường tương ứng với %USERPROFILE%\.codex\config.toml.

3.1 Cấu hình biến môi trường API key

Nếu bạn dùng bash, zsh hoặc sh trên macOS / Linux / WSL:

export ROUTEAPI_KEY="khóa RouteAPI của bạn"

Nếu bạn dùng Windows PowerShell:

$env:ROUTEAPI_KEY="khóa RouteAPI của bạn"

3.2 Ghi vào config.toml

model = "tên mô hình của bạn"
model_provider = "routeapi"

[model_providers.routeapi]
name = "RouteAPI"
base_url = "https://www.routeapi.ai/v1"
env_key = "ROUTEAPI_KEY"
wire_api = "responses"

Trong cấu hình trên:

• model: điền tên mô hình giao thức OpenAI khả dụng trong console RouteAPI.
• model_provider: chỉ định phiên hiện tại dùng provider tùy chỉnh routeapi.
• base_url: luôn điền https://www.routeapi.ai/v1.
• env_key: cho biết Codex đọc khóa từ biến môi trường ROUTEAPI_KEY.

Khuyến nghị tích hợp

Tích hợp RouteAPI bằng provider tùy chỉnh trực tiếp hơn và phù hợp hơn cho nhóm quản lý thống nhất. Khi đó Codex sẽ đọc trực tiếp ROUTEAPI_KEY đã cấu hình, không cần đi qua quy trình đăng nhập tài khoản OpenAI.

3.3 Khởi động Codex

codex

Nếu muốn chạy mặc định theo cách thận trọng hơn, bạn cũng có thể bổ sung hai mục sau vào config.toml:

approval_policy = "on-request"
sandbox_mode = "workspace-write"

4. Cấu hình tích hợp IDE

Sau khi hoàn tất config.toml ở trên, extension IDE của Codex thường có thể tái sử dụng cùng cấu hình, nên không cần nhập lại địa chỉ RouteAPI và khóa trong editor.

VS Code / Cursor / Windsurf

1. Cài đặt extension IDE chính thức của Codex.
2. Khởi động lại editor.
3. Mở dự án và khởi động Codex.
4. Nếu extension chưa đọc ngay cấu hình mới, hãy mở lại workspace hoặc khởi động lại editor một lần.

JetBrains IDE

Nếu bạn dùng Codex trong IntelliJ IDEA, PyCharm, WebStorm, GoLand hoặc các JetBrains IDE khác, nên hoàn tất cấu hình CLI ở trên trước, rồi làm theo wizard Codex trong IDE để liên kết. Như vậy terminal và IDE sẽ dùng cùng một cấu hình RouteAPI, không cần thiết lập lại khi chuyển công cụ.