Codex CLI'ı ücretsiz modellerle kullanın
Codex CLI, terminal için OpenAI'nin açık kaynaklı bir kodlama ajanıdır. Özel bir model sağlayıcısı kullanabilir. Bu kılavuz, Codex CLI'ı FreeLLMAPI üzerinden diğer sağlayıcıların ücretsiz modellerine bağlar. Codex, Responses API dilini kullanır ve FreeLLMAPI bunu /v1/responses üzerinden sunar.
Kod, model adları ve canlı katalog etiketleri İngilizce gösterilir.
Nasıl çalışır
Codex CLI, istekleri OpenAI Responses biçiminde gönderir. Codex belgelerine göre responses, desteklenen tek wire_api değeridir. Bu nedenle Codex için bir sağlayıcı /v1/responses adresini sunmalıdır. FreeLLMAPI bu uç noktayı sunar. Her isteği çevirir ve ücretsiz bir modele gönderir, örneğin Gemini, GPT-OSS, Qwen veya GLM.
- Elde ettikleriniz: Codex CLI ajanı, araçları ve düzenleme döngüsü, ücretsiz modellerde.
- Elde edemediğiniz: ChatGPT planınız üzerinden OpenAI'nin kendi GPT modelleri. İstekler, FreeLLMAPI havuzunuzdaki ücretsiz sağlayıcılara gider.
- Sınır:
/v1/responsesüzerinde görüntü girdisi henüz desteklenmiyor. Metin istemleri kullanın.
1. adım: FreeLLMAPI ve Codex CLI'ı kurun
İkisini de kurun
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codexhttp://localhost:3001 adresini açın. Keys sayfasına en az iki ücretsiz sağlayıcı anahtarı ekleyin. Birleşik anahtarınızı aynı sayfadan kopyalayın. macOS'ta Codex'i brew install --cask codex komutuyla da kurabilirsiniz.
2. adım: Codex CLI'ı bağlayın
Kurulum komutu, ~/.codex/config.toml dosyasına bir sağlayıcı ekler. Önce bir yedek oluşturur ve yeni bloğu birleştirir, bu yüzden diğer ayarlarınız korunur.
Tek komut
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codexKomut, canlı kataloğunuzdaki değerlerle bu ayarları yazar. Anahtar dosyada yoktur. Codex anahtarı FREELLMAPI_API_KEY ortam değişkeninden okur, bu yüzden Codex'i çalıştırdığınız her kabukta değişkeni dışa aktarın.
~/.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| Anahtar | Ne yapar |
|---|---|
model_provider | Sağlayıcıyı model_providers içinden seçer. Varsayılan openai. |
env_key | Sağlayıcı API anahtarını tutan ortam değişkeni |
requires_openai_auth | false, Codex'in OpenAI girişi istemediği anlamına gelir |
model_context_window | Etkin modelin bağlam tokenları. Komut değeri canlı kataloğunuzdan alır. |
model_auto_compact_token_limit | Otomatik geçmiş sıkıştırmasını başlatan token sayısı. Komut bunu bağlam penceresinin %90'ına ayarlar. |
tool_output_token_limit | Codex'in geçmişte tuttuğu her araç çıktısı için token bütçesi |
Anahtarı dosyalardan ve kabuk profilinizden uzak tutmak için başlatıcıyı kullanın. Codex'i yalnızca ortamında anahtarla başlatır:
Kalıcılık yapmayan başlatıcı
npx freellmapi launch-codexİsteklerin ağ geçidine gittiğini doğrulamak için npx freellmapi doctor komutunu çalıştırın. Yönlendirilen Authorization üstbilgisini, kataloğu ve canlı bir denemeyi denetler. Panelin istek günlüğü, her Codex çağrısını gösterir. X-Routed-Via yanıt üstbilgisi, yanıtlayan sağlayıcıyı ve modeli adlandırır. Bir istek yedeğe geçtiyse, X-Fallback-Trail başarısız olan her adımı ve nedenini adlandırır.
[profiles.NAME] tablolarını config.toml dosyasından okumaz. Profiller artık ayrı dosyalardır, örneğin ~/.codex/NAME.config.toml. Güncel bir Codex sürümüyle yukarıdaki varsayılan kurulumu kullanın.Model meta veri uyarısını kaldırın
Codex, her çalıştırmada "Model metadata for auto not found" yazdırır. Codex, ağ geçidinin model kimliklerini bilmez. Ona bağlam penceresi ve görüntü desteği gibi gerçek meta veriler vermek için sağlayıcıya bir model kataloğu URL'si ekleyin:
[model_providers.freellmapi] bölümüne ekleyin
model_catalog_url = "http://localhost:3001/v1/codex/models"Katalog, Codex'in kendi varsayılan sistem istemini ve araç ayarlarını korur. Yalnızca uyarı ve bağlam penceresi değişir.
Codex CLI için modelleri seçin
Codex bir ajandır. Araç çağrıları yoluyla kabuk komutları çalıştırır ve dosyaları düzenler. Araç çağırma ve geniş bir bağlam penceresi olan modelleri kullanın. Tablo, bugün her iki kuralı karşılayan ücretsiz modelleri gösterir.
| Model | Ücretsiz olduğu yer | Bağlam | Ücretsiz limitler (en iyi teklif) | Araçlar | Görsel girdi |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 istek/dk 1 req/min per model | Evet | Hayır |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 istek/dk 40 RPM | Evet | Evet |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Evet | Evet |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Evet | Hayır |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Evet | Evet |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Evet | Evet |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 istek/dk 50 istek/gün 50 req/day account-wide (1,000 after a $10 purchase) | Evet | Evet |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 istek/dk 50 istek/gün Shared rate limit | Evet | Hayır |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 istek/dk 250 istek/gün 70,000 jeton/dk ~6M | Evet | Evet |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Evet | Evet |
109 eşleşen ücretsiz modelden 12 tanesi gösteriliyor. Tüm modelleri gör.
Canlı veriler FreeLLMAPI kataloğundan alınır (sürüm 2026.11.19, 2026-11-19 tarihinde kontrol edildi). Ücretsiz limitler sık değişir. Katalog her gün kontrol edilir.
Yönlendiricinin her istek için bir model seçmesi için model = "auto" ayarını koruyun. Tek bir modeli sabitlemek için npx freellmapi setup-codex --url http://localhost:3001 --model <id> komutunu çalıştırın. Ayrıca model = "auto:smart" veya model = "auto:fast" değerini config.toml dosyasında da ayarlayabilirsiniz.
Ücretsiz katmanların dakika ve gün başına sınırları vardır. Bir sağlayıcı 429 hatası gönderdiğinde FreeLLMAPI isteği zincirdeki sonraki modele gönderir. Uzun Codex oturumları için dört veya daha fazla sağlayıcıdan anahtar ekleyin. Codex, model_auto_compact_token_limit değerine ulaştığında geçmişini sıkıştırır. Daha düşük bir değer daha küçük istekler gönderir, bu da dakika başına token sınırı düşük ücretsiz katmanlarda yardımcı olur.
Sorun giderme
| Sorun | Neden | Çözüm |
|---|---|---|
| Codex, ChatGPT ile oturum açmanızı ister | model_provider ayarlı değil, bu yüzden Codex openai kullanır | model_provider = "freellmapi" olarak ayarlayın |
401 "Invalid API key" | FREELLMAPI_API_KEY bu kabukta ayarlı değil | Değişkeni dışa aktarın veya npx freellmapi launch-codex komutunu kullanın |
"auto için model meta verisi bulunamadı" | Codex, ağ geçidinin model kimliklerini bilmez | model_catalog_url ekleyin |
wire_api = "chat" ile hatalar | Codex yalnızca Responses API'yi destekler | wire_api = "responses" olarak ayarlayın |
| Profil ayarları yok sayılır | Codex 0.134.0 ve sonrası [profiles.NAME] tablolarını yok sayar | Varsayılan sağlayıcı kurulumunu veya ayrı bir profil dosyasını kullanın |
| "N denemeden sonra tüm modeller hız sınırında" | Tüm anahtarlar sınırda | Daha fazla sağlayıcıdan anahtar ekleyin veya bekleme sürelerinin bitmesini bekleyin |
Sık sorulan sorular
Codex CLI'ı ücretsiz kullanabilir miyim?
Evet. Codex CLI açık kaynaktır. config.toml dosyasına FreeLLMAPI'yi özel bir model sağlayıcısı olarak ekleyin. Ağ geçidi her isteği ücretsiz sağlayıcı katmanlarına gönderir, bu yüzden çıkarım maliyeti 0 $ olur.
Codex CLI diğer sağlayıcıların modellerini kullanabilir mi?
Evet. base_url, env_key ve wire_api = "responses" içeren bir [model_providers.
Codex CLI, Chat Completions API'sini destekler mi?
Hayır. Codex yapılandırma başvurusu, desteklenen tek wire_api değerinin responses olduğunu söyler. FreeLLMAPI /v1/responses adresini sunar, bu yüzden bir Codex sağlayıcısı olarak çalışır.
Codex CLI için en iyi ücretsiz model hangisi?
Araç çağırma ve en az 128K bağlam sunan bir model kullanın. Bu sayfadaki tablo, bugün her iki kuralı karşılayan en güçlü ücretsiz modelleri gösterir.
'Model metadata for auto not found' hatasını nasıl düzeltirim?
~/.codex/config.toml dosyasındaki sağlayıcı bloğuna model_catalog_url = "http://localhost:3001/v1/codex/models" ekleyin. Codex, ardından ağ geçidi modelleri için gerçek meta verileri okur.
İlgili rehberler
- Claude Code'u ücretsiz nasıl kullanırsınız
- OpenCode'u ücretsiz LLM API ile kullanın
- Aider'ı ücretsiz LLM API ile kullanın
- En iyi ücretsiz kodlama model API'leri
- Ücretsiz bir GPT API var mı?
Kaynaklar
- Codex docs: config reference (20 November 2026 tarihinde kontrol edildi)
- Codex docs: advanced config and profiles (20 November 2026 tarihinde kontrol edildi)
- Codex CLI repository (20 November 2026 tarihinde kontrol edildi)
- FreeLLMAPI docs: coding agents and Codex (20 November 2026 tarihinde kontrol edildi)
- FreeLLMAPI CLI generators (20 November 2026 tarihinde kontrol edildi)