Trang chủ / Hướng dẫn / Dùng Codex CLI với mô hình miễn phí

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/responses chư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/codex

Mở 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
codex

Lệ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óaChức năng
model_providerChọn nhà cung cấp từ model_providers. Mặc định là openai.
env_keyBiến môi trường chứa khóa API của nhà cung cấp
requires_openai_authfalse nghĩa là Codex không yêu cầu đăng nhập OpenAI
model_context_windowSố 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_limitSố 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_limitNgâ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.

Hồ sơ: Tài liệu Codex nói rằng Codex 0.134.0 trở lên không còn đọc bảng [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í cho Codex CLI: gọi công cụ và ngữ cảnh 128K trở lên
Mô hìnhMiễn phí trênNgữ cảnhGiới hạn miễn phí (ưu đãi tốt nhất)Công cụThị giác
GLM 5.3UnoRouter1M1 yêu cầu/phút
1 req/min per model
CóKhông
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 yêu cầu/phút
40 RPM
CóCó
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaCóCó
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceCóKhông
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditCóCó
Gemini 3.7 FlashGoogle AI Studio1M10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditCóCó
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 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 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 yêu cầu/phút
50 yêu cầu/ngày
Shared rate limit
CóKhông
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 yêu cầu/phút
250 yêu cầu/ngày
70,000 token/phút
~6M
CóCó
Gemini 3.6 FlashGoogle AI Studio1M10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayCó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ânCách khắc phục
Codex yêu cầu bạn đăng nhập bằng ChatGPTmodel_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àyExport 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 gatewayThê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ỏ quaCodex 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ạnThêm khóa từ nhiều nhà cung cấp hơn, hoặc chờ hết thời gian nghỉ
Dùng tất cả các mô hình này qua một khóa duy nhất. FreeLLMAPI là bộ định tuyến mã nguồn mở, tự lưu trữ. Nó đặt tất cả các gói miễn phí này sau một endpoint duy nhất tương thích OpenAI, và tự chuyển sang nhà cung cấp khác khi một nhà cung cấp bị giới hạn tốc độ. Xem danh mục hoặc bắt đầu.

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.] với base_url, env_key và wire_api = "responses", rồi đặt model_provider. Nhà cung cấp phải phục vụ Responses API.

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

Nguồn

Tất cả hướng dẫn · Xem tất cả mô hình miễn phí