Tích hợp với Codex

Codex là coding agent của OpenAI. Codex CLI, ứng dụng desktop và extension cho VS Code dùng chung một file cấu hình ~/.codex/config.toml, nên chỉ cần cấu hình một lần.

Codex gọi API theo chuẩn Responses (/v1/responses). Gateway hỗ trợ chuẩn này cho cả model OpenAI, Gemini và DeepSeek, kể cả khi agent gọi tool.

1. Cài đặt

npm install -g @openai/codex

2. Đặt API key vào biến môi trường

Codex đọc key từ biến môi trường, không ghi key vào file cấu hình.

# macOS / Linux: thêm vào ~/.zshrc hoặc ~/.bashrc
export THUCCHIEN_API_KEY="<your_api_key>"

# Windows PowerShell (lưu vĩnh viễn, mở lại terminal sau khi chạy)
setx THUCCHIEN_API_KEY "<your_api_key>"

3. Khai báo gateway trong ~/.codex/config.toml

Tạo (hoặc sửa) file ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml):

~/.codex/config.toml

model = "gpt-6-luna"
model_provider = "thucchien"
model_reasoning_effort = "medium"

[model_providers.thucchien]
name = "AI Thực Chiến"
base_url = "https://api.thucchien.ai/v1"
env_key = "THUCCHIEN_API_KEY"
wire_api = "responses"

• model_provider trỏ tới khối [model_providers.thucchien]. Không đặt tên provider là openai, ollama hay lmstudio vì đây là tên dành riêng của Codex.
• wire_api = "responses" là giá trị duy nhất Codex còn hỗ trợ.
• model_reasoning_effort: low, medium, high hoặc xhigh cho model OpenAI.

4. Chạy thử

cd du-an-cua-ban
codex

Gõ yêu cầu, ví dụ "Đọc README và tóm tắt cấu trúc dự án". Nếu Codex trả lời và đọc được file, cấu hình đã đúng. Trong ứng dụng desktop và extension VS Code, model gpt-6-luna sẽ xuất hiện sẵn vì dùng chung file cấu hình.

Khung đầu phiên hiện model gpt-6-luna, nghĩa là Codex đang đi qua gateway.

Khi agent muốn sửa file hoặc chạy lệnh, Codex hiện diff và hỏi trước. Đọc diff rồi mới chọn Yes, proceed.

Codex đề xuất patch cho todo.py và chờ bạn duyệt.

Chọn model

Model	Khi nào dùng
gpt-6-luna	Mặc định: rẻ, nhanh, đủ tốt cho phần lớn tác vụ
gpt-6.1-sol, gpt-6-sol	Tác vụ khó, refactor lớn
gemini-3.5-flash	Ngữ cảnh dài, đọc nhiều file
deepseek-flash	Rẻ nhất

Đổi model ngay trong phiên bằng lệnh /model, hoặc khi khởi động: codex -m gemini-3.5-flash. Giá từng model xem ở Bảng giá model.

Dùng nhiều cấu hình

Muốn giữ cả cấu hình ChatGPT cá nhân lẫn gateway, hãy tạo profile: đặt nội dung ở bước 3 vào ~/.codex/thucchien.config.toml rồi chạy codex --profile thucchien. Cấu hình riêng cho một dự án đặt ở .codex/config.toml trong thư mục dự án.

Xử lý lỗi thường gặp

• 401: sai key, hoặc chưa mở lại terminal sau khi đặt biến môi trường.
• 429 Budget has been exceeded: đội đã dùng hết budget. Xem Kiểm tra chi tiêu.
• Codex vẫn yêu cầu đăng nhập ChatGPT: kiểm tra dòng model_provider = "thucchien" nằm ở đầu file, trước mọi khối [...].