CODEX-AUTH KOMUTLARI VE KULLANIM AÇIKLAMALARI
ÖNEMLİ NOTLAR
- Komutların başında mutlaka codex-auth yazılmalıdır.
- Sadece list, login veya switch yazmak çalışmaz.
- Codex App kullanıyorsan, hesap değiştirdikten sonra Codex uygulamasını tamamen kapatıp tekrar açman gerekir.
- Senin sisteminde görünen sürüm: codex-auth 0.2.10
- Güncel GitHub dokümanlarında bazı komutların v0.3.x / @next sürümleri için olabileceği belirtiliyor.
- Bir komut sende çalışmazsa yardım komutlarıyla kontrol edebilirsin.
Yardım komutları:
codex-auth --help
codex-auth <komut> --help
Örnek:
codex-auth list --help
KURULUM
Node.js/npm kuruluysa global kurulum:
npm install -g @loongphy/codex-auth
Kurulumdan sonra sürüm kontrolü:
codex-auth --version
Global kurmadan geçici çalıştırma:
npx @loongphy/codex-auth list
Kaldırma:
npm uninstall -g @loongphy/codex-auth
1) HESAPLARI LİSTELEME
Komut:
codex-auth list
Açıklama:
- Kayıtlı Codex hesaplarını listeler.
- Aktif hesabı gösterir.
- Plan bilgisini gösterir.
- 5 saatlik kullanım durumunu gösterir.
- Haftalık kullanım durumunu gösterir.
- Son aktivite bilgisini gösterir.
Sadece aktif hesabı yenileyerek listeleme:
codex-auth list --active
Açıklama:
- Sadece aktif hesabın kullanım bilgisini yenileyerek listeler.
- Diğer hesaplarda kayıtlı/eski bilgiler görünebilir.
Canlı listeleme:
codex-auth list --live
Açıklama:
- Liste ekranını canlı yeniler.
- Terminal ekranında açık kalır.
API destekli listeleme:
codex-auth list --api
Açıklama:
- Kullanım/kota bilgisini API ile yenilemeyi dener.
API kullanmadan listeleme:
codex-auth list --skip-api
Açıklama:
- Uzak API çağrısı yapmadan yerel Codex dosyalarından kullanım bilgisini okumaya çalışır.
- Daha güvenli olabilir ama kullanım bilgisi eski veya eksik görünebilir.
2) YENİ HESAP EKLEME
Komut:
codex-auth login
Açıklama:
- Yeni Codex/OpenAI hesabı eklemek için kullanılır.
- Giriş yapılan hesabı codex-auth kayıtlarına ekler.
- Eklenen hesabı aktif hesap yapabilir.
Cihaz kodu ile giriş:
codex-auth login --device-auth
Açıklama:
- Tarayıcı ile giriş sorun çıkarıyorsa cihaz kodu ile giriş yapmayı sağlar.
Codex CLI kurulu değilse önerilen kurulum:
npm install -g @openai/codex
3) HESAP DEĞİŞTİRME
İnteraktif hesap değiştirme:
codex-auth switch
Açıklama:
- Kayıtlı hesaplar arasında seçim ekranı açar.
- Hesabı seçip Enter ile geçiş yaparsın.
Numara ile doğrudan geçiş:
codex-auth switch 02
Açıklama:
- Listede 02 numarasıyla görünen hesaba geçer.
E-posta parçasıyla geçiş:
codex-auth switch gmail
Açıklama:
- E-posta, alias veya hesap adında gmail geçen hesabı bulup geçmeye çalışır.
Alias ile geçiş:
codex-auth switch work
Açıklama:
- Alias/takma adı work olan hesaba geçer.
Önceki hesaba dönme:
codex-auth switch -
Kısa kullanım:
codex-auth -
Açıklama:
- Bir önceki aktif hesaba geri döner.
Canlı seçim ekranı:
codex-auth switch --live
Açıklama:
- Hesap seçim ekranını açık tutar.
- Birden fazla geçiş yaparken işe yarar.
API destekli geçiş:
codex-auth switch --api
API kullanmadan geçiş:
codex-auth switch --skip-api
Önemli:
- Hesap değiştirdikten sonra Codex uygulamasını kapatıp tekrar açman gerekir.
4) HESAP SİLME
İnteraktif hesap silme:
codex-auth remove
Açıklama:
- Kayıtlı hesapları silmek için seçim ekranı açar.
Numara ile hesap silme:
codex-auth remove 02
Açıklama:
- Listede 02 numarasıyla görünen hesabı siler.
E-posta parçasıyla silme:
codex-auth remove gmail
Alias ile silme:
codex-auth remove work
Birden fazla hesabı aynı anda silme:
codex-auth remove 02 03
Tüm hesapları silme:
codex-auth remove --all
Açıklama:
- codex-auth içinde kayıtlı tüm hesapları temizler.
- Dikkatli kullanılmalıdır.
Canlı silme ekranı:
codex-auth remove --live
API destekli silme ekranı:
codex-auth remove --api
API kullanmadan silme ekranı:
codex-auth remove --skip-api
5) DURUM GÖRÜNTÜLEME
Komut:
codex-auth status
Açıklama:
- Yerel çalışma durumunu gösterir.
- Auto-switch ayarlarını gösterebilir.
- Servis/zamanlanmış görev durumunu gösterebilir.
- Live refresh aralığını gösterebilir.
- Ayar değiştirmez, sadece bilgi verir.
6) AUTH.JSON İÇE AKTARMA
Tek auth.json dosyası içe aktarma:
codex-auth import C:\path\to\auth.json
Örnek:
codex-auth import C:\Users\Kullanici\Desktop\auth.json
Alias ile içe aktarma:
codex-auth import C:\Users\Kullanici\Desktop\auth.json --alias personal
Açıklama:
- Var olan auth.json dosyasını codex-auth hesabı olarak ekler.
- --alias ile hesaba takma ad verilebilir.
Klasörden toplu içe aktarma:
codex-auth import C:\Users\Kullanici\Desktop\auth-exports
Açıklama:
- Belirtilen klasördeki .json dosyalarını içe aktarır.
- Alt klasörleri taramaz.
7) CLIPROXYAPI TOKEN İÇE AKTARMA
Varsayılan CPA token klasöründen içe aktarma:
codex-auth import --cpa
Belirli CPA klasöründen içe aktarma:
codex-auth import --cpa C:\path\to\cpa-folder
Belirli CPA token dosyasını içe aktarma:
codex-auth import --cpa C:\path\to\token.json
Alias ile CPA token içe aktarma:
codex-auth import --cpa C:\path\to\token.json --alias bob
8) REGISTRY ONARMA / YENİDEN OLUŞTURMA
Komut:
codex-auth import --purge
Açıklama:
- registry.json bozulduysa veya hesaplar eksik görünüyorsa kayıtları mevcut auth dosyalarından yeniden oluşturmaya çalışır.
Belirli klasörden onarma:
codex-auth import --purge C:\path\to\auth-exports
9) HESAPLARI DIŞA AKTARMA
Varsayılan klasöre dışa aktarma:
codex-auth export
Belirli klasöre dışa aktarma:
codex-auth export C:\backup\codex-auth
CLIProxyAPI formatında dışa aktarma:
codex-auth export --cpa
Belirli klasöre CPA formatında dışa aktarma:
codex-auth export --cpa C:\backup\codex-auth-cpa
Not:
- export komutu yeni dokümanlarda yer alır.
- 0.2.10 sürümünde çalışmazsa daha yeni sürüm gerekebilir.
10) ALIAS / TAKMA AD VERME
Komut yapısı:
codex-auth alias set <hesap-secici> <alias>
Numara ile alias verme:
codex-auth alias set 02 personal
E-posta parçasıyla alias verme:
codex-auth alias set gmail work
Açıklama:
- Hesaba daha kolay hatırlanacak bir takma ad verir.
- Sonrasında bu alias ile switch/remove işlemi yapılabilir.
Örnek geçiş:
codex-auth switch personal
Alias kuralları:
- Boş alias kabul edilmez.
- Sadece rakamlardan oluşan alias kabul edilmeyebilir.
- Çünkü rakamlar hesap satır numarası olarak kullanılır.
11) ALIAS SİLME
Komut yapısı:
codex-auth alias clear <hesap-secici>
Numara ile alias silme:
codex-auth alias clear 02
E-posta parçasıyla alias silme:
codex-auth alias clear gmail
Not:
- Alias komutları yeni dokümanlarda yer alır.
- Sürümünde var mı diye kontrol etmek için:
codex-auth alias --help
12) ESKİ / KULLANILMAYAN DOSYALARI TEMİZLEME
Komut:
codex-auth clean
Açıklama:
- ~/.codex/accounts/ altındaki eski veya kullanılmayan yönetilen dosyaları temizler.
- Aktif registry içinde kullanılan hesap dosyalarını korur.
13) ESKİ BACKGROUND KAYITLARINI TEMİZLEME
Komut:
codex-auth clean background
Açıklama:
- Eski sürümlerin oluşturduğu background / auto-switch kayıtlarını temizler.
- Windows tarafında eski CodexAuthAutoSwitch scheduled task kaydını temizlemeye yönelik olabilir.
14) LIVE YENİLEME ARALIĞI AYARLAMA
Komut yapısı:
codex-auth config live --interval <saniye>
Örnek:
codex-auth config live --interval 30
Açıklama:
- --live kullanılan ekranların yenileme aralığını saniye cinsinden ayarlar.
15) API KULLANIM YENİLEMEYİ AÇMA / KAPATMA
API kullanım yenilemeyi açma:
codex-auth config api enable
Açıklama:
- Kullanım/kota bilgisini API üzerinden yenilemeyi açar.
API kullanım yenilemeyi kapatma:
codex-auth config api disable
Açıklama:
- Uzak API çağrısını kapatır.
- Yerel Codex dosyalarından kullanım bilgisi okumaya çalışır.
Durumu kontrol etmek:
codex-auth status
16) AUTO-SWITCH AÇMA / KAPATMA
Auto-switch açma:
codex-auth config auto enable
Auto-switch kapatma:
codex-auth config auto disable
Açıklama:
- Deneysel otomatik hesap değiştirme sistemini açar/kapatır.
- Kullanım limiti belirli eşiklerin altına düşünce hesap değiştirmeye çalışabilir.
17) AUTO-SWITCH EŞİKLERİNİ AYARLAMA
5 saatlik limit eşiği:
codex-auth config auto --5h 10
Açıklama:
- 5 saatlik kullanım kalan oranı %10 altına düşünce otomatik geçiş için eşik belirler.
Haftalık limit eşiği:
codex-auth config auto --weekly 5
Açıklama:
- Haftalık kullanım kalan oranı %5 altına düşünce otomatik geçiş için eşik belirler.
İkisini birlikte ayarlama:
codex-auth config auto --5h 10 --weekly 5
18) CODEX APP BAŞLATMA
Komut:
codex-auth app
Açıklama:
- Codex App'i özel ortam değişkenleriyle başlatmayı dener.
- Deneysel bir komuttur.
Windows App ID ile başlatma:
codex-auth app --id OpenAI.Codex
Farklı CODEX_HOME ile başlatma:
codex-auth app --codex-home C:\Users\Kullanici\.codex
Belirli Codex CLI yolu ile başlatma:
codex-auth app --codex-cli-path C:\path\to\codex.exe
Windows platformuyla başlatma:
codex-auth app --platform win
WSL platformuyla başlatma:
codex-auth app --platform wsl
macOS platformuyla başlatma:
codex-auth app --platform mac
Debug/log için stdout-stderr bağlı başlatma:
codex-auth app --std
Not:
- Bu komut deneysel olabilir.
- Codex App güncellemeleriyle bozulabilir.
- 0.2.10 sürümünde yoksa daha yeni sürüm gerekebilir.
19) GENEL YARDIM
Komut:
codex-auth --help
Açıklama:
- Mevcut kurulu sürümde kullanılabilir komutları gösterir.
20) KOMUT BAZLI YARDIM
Komut yapısı:
codex-auth <komut> --help
Örnekler:
codex-auth list --help
codex-auth switch --help
codex-auth remove --help
codex-auth import --help
codex-auth alias --help
Açıklama:
- Belirli bir komutun desteklediği seçenekleri gösterir.
- Sürüm farklarını kontrol etmek için en güvenilir yöntemdir.
21) SÜRÜM GÖRÜNTÜLEME
Komut:
codex-auth --version
Açıklama:
- Kurulu codex-auth sürümünü gösterir.
PRATİK KULLANIM SENARYOLARI
Senaryo 1: Hesapları kontrol etme
codex-auth list
Senaryo 2: Yeni hesap ekleme
codex-auth login
Sonra:
codex-auth list
Senaryo 3: Hesap değiştirme
codex-auth list
codex-auth switch
Sonra Codex uygulamasını kapatıp tekrar aç.
Senaryo 4: Doğrudan ikinci hesaba geçme
codex-auth switch 02
Sonra Codex uygulamasını kapatıp tekrar aç.
Senaryo 5: Önceki hesaba geri dönme
codex-auth switch -
veya:
codex-auth -
Senaryo 6: Hesap silme
codex-auth list
codex-auth remove
veya doğrudan:
codex-auth remove 02
Senaryo 7: Tüm hesapları silme
codex-auth remove --all
Senaryo 8: Hesaba takma ad verme
codex-auth alias set 02 is-hesabi
Sonra geçiş:
codex-auth switch is-hesabi
Senaryo 9: auth.json dosyasını içe aktarma
codex-auth import C:\Users\Kullanici\Desktop\auth.json --alias personal
Senaryo 10: API çağrısı olmadan listeleme
codex-auth list --skip-api
SIK KARŞILAŞILAN HATALAR VE ÇÖZÜMLER
1) npm tanınmıyor
Açıklama:
- Node.js/npm kurulu değildir veya PATH'e eklenmemiştir.
- Node.js LTS kurulmalıdır.
Node.js LTS winget kurulumu:
winget install -e --id OpenJS.NodeJS.LTS
2) running scripts is disabled hatası
Açıklama:
- PowerShell execution policy nedeniyle npm.ps1 çalışmıyordur.
Çözüm:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
Alternatif:
- PowerShell yerine CMD kullanılabilir.
3) codex-auth komutları çalışmıyor
Kontrol:
codex-auth --version
Terminali kapatıp tekrar açmayı dene.
4) Hesap değişti ama Codex uygulamasında eski hesap görünüyor
Çözüm:
- Codex uygulamasını tamamen kapatıp yeniden aç.
5) Kullanım bilgileri güncel değil
API destekli listeleme:
codex-auth list --api
API çağrısı istemiyorsan:
codex-auth list --skip-api
EN ÇOK KULLANILACAK KISA KOMUT LİSTESİ
codex-auth list
Kayıtlı hesapları ve aktif hesabı gösterir.
codex-auth login
Yeni hesap ekler.
codex-auth switch
Hesap değiştirir.
codex-auth switch 02
02 numaralı hesaba geçer.
codex-auth switch -
Önceki hesaba döner.
codex-auth remove
Hesap silme ekranını açar.
codex-auth remove 02
02 numaralı hesabı siler.
codex-auth remove --all
Tüm kayıtlı hesapları siler.
codex-auth status
Yerel durum/ayar bilgilerini gösterir.
codex-auth import C:\path\to\auth.json --alias personal
auth.json dosyasını alias ile içe aktarır.
codex-auth list --skip-api
API çağrısı yapmadan listelemeyi dener.
codex-auth --help
Yardım ekranını gösterir.
codex-auth --version
Kurulu sürümü gösterir.
GÜVENLİK NOTU
codex-auth, Codex hesaplarına ait auth.json / token bilgileriyle çalışır.
Bu bilgiler hesap oturumu açısından hassastır.
Dikkat edilmesi gerekenler:
- Aracı yalnızca kendi bilgisayarında kullan.
- auth.json dosyalarını kimseyle paylaşma.
- auth.json dosyalarını forumlara, GitHub'a veya herkese açık alanlara yükleme.
- API kullanım yenileme açıkken araç, kullanım/kota bilgisi için OpenAI/ChatGPT endpointlerine token ile istek gönderebilir.
- API çağrısı istemiyorsan --skip-api kullanabilirsin.
Örnek:
codex-auth list --skip-api
Desteklenen sürümde API kullanımını kapatma:
codex-auth config api disable
KISA ÖZET
codex-auth, Codex hesaplarını terminalden yönetmek için kullanılır.
En temel 3 komut:
codex-auth list
codex-auth login
codex-auth switch
Hesap değiştirdikten sonra Codex App kullanıyorsan uygulamayı kapatıp tekrar açman gerekir.
