Dùng Codex CLI với mô hình miễn phí
Codex CLI là agent lập trình mã nguồn mở của OpenAI, chạy trong terminal. Nó có thể dùng một nhà cung cấp mô hình tùy chỉnh. Hướng dẫn này kết nối Codex CLI với mô hình miễn phí của nhà cung cấp khác qua FreeLLMAPI. Codex dùng Responses API, và FreeLLMAPI phục vụ API này tại /v1/responses.
Mã, tên mô hình và nhãn danh mục trực tiếp được hiển thị bằng tiếng Anh.
Cách hoạt động
Codex CLI gửi yêu cầu theo định dạng Responses của OpenAI. Tài liệu Codex nói rằng responses là giá trị wire_api duy nhất được hỗ trợ. Vì vậy, nhà cung cấp dành cho Codex phải phục vụ /v1/responses. FreeLLMAPI phục vụ điểm cuối này. Nó chuyển đổi từng yêu cầu và gửi đến một mô hình miễn phí, ví dụ Gemini, GPT-OSS, Qwen hoặc GLM.
- Bạn nhận được: agent Codex CLI, các công cụ và vòng lặp chỉnh sửa của nó, trên mô hình miễn phí.
- Bạn không nhận được: các mô hình GPT của chính OpenAI qua gói ChatGPT của bạn. Yêu cầu được gửi đến các nhà cung cấp miễn phí trong nhóm FreeLLMAPI của bạn.
- Giới hạn: đầu vào hình ảnh trên
/v1/responseschưa được hỗ trợ. Hãy dùng prompt văn bản.
Bước 1: Cài FreeLLMAPI và Codex CLI
Cài cả hai
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codexMở http://localhost:3001. Thêm ít nhất hai khóa nhà cung cấp miễn phí ở trang Keys. Sao chép khóa thống nhất của bạn từ cùng trang đó. Trên macOS, bạn cũng có thể cài Codex bằng brew install --cask codex.
Bước 2: Kết nối Codex CLI
Lệnh thiết lập thêm một nhà cung cấp vào ~/.codex/config.toml. Lệnh tạo bản sao lưu trước và gộp khối mới, nên các thiết lập khác của bạn được giữ nguyên.
Một lệnh
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codexLệnh ghi các thiết lập này, với giá trị lấy từ danh mục trực tiếp của bạn. Khóa không nằm trong tệp. Codex đọc khóa từ biến môi trường FREELLMAPI_API_KEY, nên hãy export biến này trong mỗi shell nơi bạn chạy Codex.
~/.codex/config.toml
model = "auto"
model_provider = "freellmapi"
model_context_window = 128000
model_auto_compact_token_limit = 115200
tool_output_token_limit = 20000
[model_providers.freellmapi]
name = "FreeLLMAPI"
base_url = "http://localhost:3001/v1"
wire_api = "responses"
env_key = "FREELLMAPI_API_KEY"
requires_openai_auth = false| Khóa | Chức năng |
|---|---|
model_provider | Chọn nhà cung cấp từ model_providers. Mặc định là openai. |
env_key | Biến môi trường chứa khóa API của nhà cung cấp |
requires_openai_auth | false nghĩa là Codex không yêu cầu đăng nhập OpenAI |
model_context_window | Số token ngữ cảnh của mô hình đang dùng. Lệnh lấy giá trị này từ danh mục trực tiếp của bạn. |
model_auto_compact_token_limit | Số token khiến Codex bắt đầu nén lịch sử tự động. Lệnh đặt 90% cửa sổ ngữ cảnh. |
tool_output_token_limit | Ngân sách token cho mỗi đầu ra công cụ mà Codex giữ trong lịch sử |
Để giữ khóa ngoài tệp và ngoài hồ sơ shell, hãy dùng trình khởi chạy. Nó khởi động Codex với khóa chỉ nằm trong môi trường của tiến trình:
Trình khởi chạy không lưu trữ
npx freellmapi launch-codexĐể chắc chắn yêu cầu đi đến gateway, chạy npx freellmapi doctor. Lệnh kiểm tra header Authorization được định tuyến, danh mục và một lần thăm dò trực tiếp. Nhật ký yêu cầu trên bảng điều khiển sau đó hiển thị từng lệnh gọi Codex. Header phản hồi X-Routed-Via cho biết nhà cung cấp và mô hình đã trả lời. Nếu một yêu cầu được chuyển dự phòng, X-Fallback-Trail cho biết từng bước thất bại và lý do.
[profiles.NAME] từ config.toml. Hồ sơ giờ là các tệp riêng, ví dụ ~/.codex/NAME.config.toml. Hãy dùng thiết lập mặc định ở trên với phiên bản Codex hiện tại.Xóa cảnh báo siêu dữ liệu mô hình
Codex in ra "Model metadata for auto not found" trong mỗi lần chạy. Codex không biết mã mô hình của gateway. Để cung cấp siêu dữ liệu thật, chẳng hạn cửa sổ ngữ cảnh và hỗ trợ hình ảnh, hãy thêm URL danh mục mô hình vào nhà cung cấp:
Thêm vào [model_providers.freellmapi]
model_catalog_url = "http://localhost:3001/v1/codex/models"Danh mục giữ nguyên system prompt mặc định và thiết lập công cụ của Codex. Chỉ cảnh báo và cửa sổ ngữ cảnh thay đổi.
Chọn mô hình cho Codex CLI
Codex là một agent. Nó chạy lệnh shell và chỉnh sửa tệp qua lệnh gọi công cụ. Hãy dùng mô hình có gọi công cụ và cửa sổ ngữ cảnh lớn. Bảng cho thấy các mô hình miễn phí đáp ứng cả hai điều kiện hiện nay.
| Mô hình | Miễn phí trên | Ngữ cảnh | Giới hạn miễn phí (ưu đãi tốt nhất) | Công cụ | Thị giác |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 yêu cầu/phút 1 req/min per model | Có | Không |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 yêu cầu/phút 40 RPM | Có | Có |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Có | Có |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Có | Không |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Có | Có |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Có | Có |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 yêu cầu/phút 50 yêu cầu/ngày 50 req/day account-wide (1,000 after a $10 purchase) | Có | Có |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 yêu cầu/phút 50 yêu cầu/ngày Shared rate limit | Có | Không |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 yêu cầu/phút 250 yêu cầu/ngày 70,000 token/phút ~6M | Có | Có |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Có | Có |
Đang hiển thị 12 trong số 109 mô hình miễn phí phù hợp. Xem tất cả mô hình.
Dữ liệu trực tiếp từ danh mục FreeLLMAPI (phiên bản 2026.11.19, đã kiểm tra 2026-11-19). Giới hạn miễn phí thay đổi thường xuyên. Danh mục được kiểm tra mỗi ngày.
Giữ model = "auto" để bộ định tuyến chọn mô hình cho mỗi yêu cầu. Để cố định một mô hình, chạy npx freellmapi setup-codex --url http://localhost:3001 --model <id>. Bạn cũng có thể đặt model = "auto:smart" hoặc model = "auto:fast" trong config.toml.
Gói miễn phí có giới hạn theo phút và theo ngày. Khi một nhà cung cấp gửi lỗi 429, FreeLLMAPI gửi yêu cầu đến mô hình tiếp theo trong chuỗi. Thêm khóa từ bốn nhà cung cấp trở lên cho các phiên Codex dài. Codex nén lịch sử khi đạt model_auto_compact_token_limit. Giá trị thấp hơn gửi yêu cầu nhỏ hơn, giúp ích với gói miễn phí có giới hạn token mỗi phút thấp.
Xử lý sự cố
| Vấn đề | Nguyên nhân | Cách khắc phục |
|---|---|---|
| Codex yêu cầu bạn đăng nhập bằng ChatGPT | model_provider chưa được đặt, nên Codex dùng openai | Đặt model_provider = "freellmapi" |
401 "Invalid API key" | FREELLMAPI_API_KEY chưa được đặt trong shell này | Export biến này, hoặc dùng npx freellmapi launch-codex |
"Model metadata for auto not found" | Codex không biết mã mô hình của gateway | Thêm model_catalog_url |
Lỗi với wire_api = "chat" | Codex chỉ hỗ trợ Responses API | Đặt wire_api = "responses" |
| Thiết lập hồ sơ bị bỏ qua | Codex 0.134.0 trở lên bỏ qua bảng [profiles.NAME] | Dùng thiết lập nhà cung cấp mặc định, hoặc một tệp hồ sơ riêng |
| "Tất cả mô hình bị giới hạn tốc độ sau N lần thử" | Mọi khóa đều đạt giới hạn | Thêm khóa từ nhiều nhà cung cấp hơn, hoặc chờ hết thời gian nghỉ |
Câu hỏi thường gặp
Tôi có thể dùng Codex CLI miễn phí không?
Có. Codex CLI là mã nguồn mở. Thêm FreeLLMAPI như một nhà cung cấp mô hình tùy chỉnh trong config.toml. Gateway gửi mỗi yêu cầu đến gói miễn phí của nhà cung cấp, nên chi phí suy luận là $0.
Codex CLI có thể dùng mô hình của nhà cung cấp khác không?
Có. Thêm một khối [model_providers.
Codex CLI có hỗ trợ Chat Completions API không?
Không. Tài liệu cấu hình Codex nói rằng responses là giá trị wire_api duy nhất được hỗ trợ. FreeLLMAPI phục vụ /v1/responses, nên nó hoạt động như một nhà cung cấp cho Codex.
Mô hình miễn phí nào tốt nhất cho Codex CLI?
Dùng mô hình có gọi công cụ và ít nhất 128K ngữ cảnh. Bảng trên trang này liệt kê các mô hình miễn phí mạnh nhất đáp ứng cả hai điều kiện hiện nay.
Làm sao sửa lỗi 'Model metadata for auto not found'?
Thêm model_catalog_url = "http://localhost:3001/v1/codex/models" vào khối nhà cung cấp trong ~/.codex/config.toml. Khi đó Codex đọc siêu dữ liệu thật cho các mô hình của gateway.
Hướng dẫn liên quan
- Cách dùng Claude Code miễn phí
- Dùng OpenCode với API LLM miễn phí
- Dùng Aider với API LLM miễn phí
- API model lập trình miễn phí tốt nhất
- Có API GPT miễn phí không?
Nguồn
- Codex docs: config reference (đã kiểm tra 20 November 2026)
- Codex docs: advanced config and profiles (đã kiểm tra 20 November 2026)
- Codex CLI repository (đã kiểm tra 20 November 2026)
- FreeLLMAPI docs: coding agents and Codex (đã kiểm tra 20 November 2026)
- FreeLLMAPI CLI generators (đã kiểm tra 20 November 2026)