Ana sayfa / Rehberler / Codex CLI'ı ücretsiz modellerle kullanın

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/codex

http://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
codex

Komut, 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
AnahtarNe yapar
model_providerSağlayıcıyı model_providers içinden seçer. Varsayılan openai.
env_keySağlayıcı API anahtarını tutan ortam değişkeni
requires_openai_authfalse, Codex'in OpenAI girişi istemediği anlamına gelir
model_context_windowEtkin modelin bağlam tokenları. Komut değeri canlı kataloğunuzdan alır.
model_auto_compact_token_limitOtomatik geçmiş sıkıştırmasını başlatan token sayısı. Komut bunu bağlam penceresinin %90'ına ayarlar.
tool_output_token_limitCodex'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.

Profiller: Codex belgelerine göre Codex 0.134.0 ve sonrası artık [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.

Codex CLI için ücretsiz modeller: araç çağırma ve 128K+ bağlam
ModelÜcretsiz olduğu yerBağlamÜcretsiz limitler (en iyi teklif)AraçlarGörsel girdi
GLM 5.3UnoRouter1M1 istek/dk
1 req/min per model
EvetHayır
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 istek/dk
40 RPM
EvetEvet
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaEvetEvet
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceEvetHayır
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditEvetEvet
Gemini 3.7 FlashGoogle AI Studio1M10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditEvetEvet
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 istek/dk
50 istek/gün
50 req/day account-wide (1,000 after a $10 purchase)
EvetEvet
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 istek/dk
50 istek/gün
Shared rate limit
EvetHayır
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 istek/dk
250 istek/gün
70,000 jeton/dk
~6M
EvetEvet
Gemini 3.6 FlashGoogle AI Studio1M10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayEvetEvet

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

SorunNedenÇözüm
Codex, ChatGPT ile oturum açmanızı istermodel_provider ayarlı değil, bu yüzden Codex openai kullanırmodel_provider = "freellmapi" olarak ayarlayın
401 "Invalid API key"FREELLMAPI_API_KEY bu kabukta ayarlı değilDeğ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 bilmezmodel_catalog_url ekleyin
wire_api = "chat" ile hatalarCodex yalnızca Responses API'yi desteklerwire_api = "responses" olarak ayarlayın
Profil ayarları yok sayılırCodex 0.134.0 ve sonrası [profiles.NAME] tablolarını yok sayarVarsayı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ırdaDaha fazla sağlayıcıdan anahtar ekleyin veya bekleme sürelerinin bitmesini bekleyin
Bunların hepsini tek bir anahtarla kullanın. FreeLLMAPI, açık kaynaklı ve kendi sunucunuzda çalışan bir yönlendiricidir. Tüm bu ücretsiz katmanları tek bir OpenAI uyumlu uç noktanın arkasında toplar ve bir sağlayıcı hız limitine takıldığında otomatik olarak başka birine geçer. Kataloğa göz atın veya canlı olarak incele.

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.] bloğu ekleyin, sonra model_provider değerini ayarlayın. Sağlayıcı Responses API'yi sunmalıdır.

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

Kaynaklar

Tüm rehberler · Tüm ücretsiz modelleri incele