Hướng dẫn cấu hình Codex CLI
📌 Về Codex CLI Codex CLI là tác nhân lập trình terminal chính thức của OpenAI, được viết bằng Rust, có thể đọc, sửa và chạy mã cục bộ (mã nguồn mở). Mặc định nó kết nối với OpenAI, nhưng hỗ trợ
model_providertùy chỉnh, vì vậy có thể kết nối liền mạch với cổng LLMoxy và dùng các mô hình như Grok 4.7.
Các bước cài đặt
1. Cài đặt Node.js
Truy cập trang chủ Node.js, khuyến nghị tải bản LTS ở bên trái; đây là bản hỗ trợ dài hạn, ổn định hơn.
2. Cài đặt Codex CLI
Mở dòng lệnh và cài đặt toàn cục bằng npm:
Người dùng macOS cũng có thể dùng Homebrew:
Xác minh cài đặt:
Codex CLI hỗ trợ macOS, Linux và Windows. Trên Windows, nên chạy trực tiếp trong PowerShell, hoặc dùng WSL2 để có môi trường Linux nguyên bản.
Các bước cấu hình
Tệp cấu hình của Codex CLI nằm ở ~/.codex/config.toml (trên Windows là %USERPROFILE%\.codex\config.toml). Để kết nối LLMoxy, chỉ cần hai bước: đăng ký một nhà cung cấp tùy chỉnh + cung cấp API Key.
1. Lấy khóa API
Vào bảng điều khiển LLMoxy → Quản lý API Key → sao chép khóa bí mật.
Lưu ý: hãy dùng token thuộc nhóm auto.
2. Ghi vào config.toml
Thêm nội dung sau vào ~/.codex/config.toml (nếu tệp chưa tồn tại thì tạo mới):
Giải thích các cấu hình:
model— tên mô hình mặc định, điền mô hình được LLMoxy hỗ trợ (ví dụgrok-4.7)model_provider— trỏ tới ID nhà cung cấp được định nghĩa bên dướibase_url— địa chỉ cổng LLMoxy, có/v1wire_api— điềnresponsesđể dùng/v1/responses. Codex chỉ hỗ trợ giá trị này, điềnchatsẽ báo lỗienv_key— tên biến môi trường lưu API Key, sẽ được thiết lập ở bước tiếp theo
MẸO Khác với Claude Code,
base_urlcủa Codex CLI bắt buộc phải có/v1.
3. Thiết lập biến môi trường API Key
Biến môi trường do env_key chỉ định cần được thiết lập trong hệ thống với khóa thật.
Windows (PowerShell, có hiệu lực vĩnh viễn):
Sau khi thiết lập, hãy đóng PowerShell và mở lại một cửa sổ mới để tải biến môi trường.
macOS / Linux:
Xác minh:
Bạn phải thay API Key LLMoxy của bạn bằng khóa thật sao chép từ bảng điều khiển LLMoxy.
4. Khởi chạy
Vào thư mục dự án của bạn và khởi động phiên tương tác:
Nếu có thể trò chuyện và thực thi tác vụ bình thường, nghĩa là bạn đã kết nối thành công với LLMoxy.
Các thao tác thường dùng
Chuyển mô hình và mức độ suy luận
Trong phiên, nhập /model để đổi mô hình hoặc điều chỉnh mức độ suy luận (reasoning effort). Bạn cũng có thể chỉ định lúc khởi động bằng -m:
Chế độ phê duyệt
Codex sẽ yêu cầu xác nhận trước khi sửa tệp hoặc chạy lệnh. Có thể đổi trong phiên bằng /approvals, hoặc chỉ định khi khởi động:
💡 Gợi ý Lần đầu chạy trong một thư mục dự án nào đó, Codex sẽ hỏi bạn có tin cậy thư mục đó hay không.
Chạy theo kịch bản (không tương tác)
Dùng lệnh con exec để giao tác vụ một lần cho Codex, phù hợp cho script hoặc CI:
Đầu vào hình ảnh
Bạn có thể đính kèm ảnh chụp màn hình hoặc bản thiết kế để Codex hiểu yêu cầu cùng với hình ảnh:
Tìm kiếm trên web
Bật Web Search để lấy thông tin mới nhất:
Kết nối công cụ MCP
Trong config.toml, đăng ký dịch vụ MCP qua [mcp_servers.*] để cung cấp cho Codex các công cụ và ngữ cảnh bên thứ ba. Cấu hình này có thể dùng chung với cấu hình nhà cung cấp LLMoxy:
Câu hỏi thường gặp
npm install -g báo lỗi quyền truy cập
Đừng dùng sudo npm install -g. Khuyến nghị dùng nvm để quản lý Node.js, hoặc đổi thư mục toàn cục của npm:
Sau đó thêm ~/.npm-global/bin vào PATH. Người dùng macOS cũng có thể cài Node.js bằng Homebrew (không cần sudo).
Sau khi khởi chạy vẫn yêu cầu đăng nhập tài khoản OpenAI
Xác nhận model_provider = "llmoxy" trong config.toml đã có hiệu lực và biến môi trường LLMOXY_API_KEY đã được thiết lập. Khi đã cấu hình nhà cung cấp tùy chỉnh, Codex sẽ xác thực bằng API Key, không cần đăng nhập ChatGPT.
Báo lỗi 404 / mô hình không tồn tại
- Kiểm tra
base_urlcó kèm/v1:https://llmoxy.com/v1 - Kiểm tra
modelcó phải là tên mô hình mà LLMoxy hỗ trợ hay không - Kiểm tra
wire_api = "responses": Codex không còn hỗ trợchat, vàwire_api = "chat"trong hướng dẫn cũ sẽ báo lỗi
Biến môi trường chưa có hiệu lực
- Windows:
SetEnvironmentVariable(...,"User")cần mở lại terminal - macOS / Linux: chạy
source ~/.zshrc(hoặc~/.bashrc), hoặc mở lại terminal, rồi dùngecho "$LLMOXY_API_KEY"để xác minh
Gọi API thất bại / vấn đề số dư
- Kiểm tra API Key không có khoảng trắng thừa
- Vào bảng điều khiển LLMoxy để kiểm tra số dư tài khoản và nhóm token (khuyến nghị dùng nhóm auto)
Kết nối máy chủ từ xa bị timeout (Linux)
- Kiểm tra mạng:
curl -I https://llmoxy.com - Nếu cần proxy, cấu hình biến môi trường
HTTPS_PROXY
