Codex'i CometAPI ile kullanın

Bu kılavuzu, Codex’i model provider olarak CometAPI ile çalıştırmak için kullanın. Resmi başvurular:

Ön koşullar

Requirement	Details
OS	macOS, Linux, Windows yerel PowerShell veya WSL ile Windows
Git	2.23+ önerilir
Codex	Codex quickstart sayfasından Codex uygulamasını veya Codex CLI’ı yükleyin
CometAPI API key	Bir tane CometAPI dashboard üzerinden alın
Model ID	Models page sayfasından bir model ID kullanın

Bir kurulum yolu seçin

Codex’i hızlıca yapılandırmanıza yardımcı olmak için iki seçenek sunuyoruz.

Seçenek 1: Codex'i manuel olarak yapılandırın (önerilir)

Kullanıcı düzeyindeki ~/.codex/config.toml dosyasını doğrudan düzenleyin. Özellikle Windows ve WSL kullanıcıları için bu en güvenilir yoldur.

Seçenek 2: Script ile yapılandırın

Kısayol olarak kurulum script’ini çalıştırın. Aynı provider yapılandırmasını yazar ve CometAPI API key’i Codex için saklar.

Codex’i manuel olarak yapılandırın

Codex, kullanıcı düzeyindeki ~/.codex/config.toml dosyasından kişisel provider varsayılanlarını okur. CometAPI provider’ını proje .codex/config.toml dosyasında değil, burada yapılandırın. Codex, proje config dosyalarındaki provider ve provider-auth ayarlarını yok sayar. Önerilen kurulum, adlı bir cometapi provider ve komut destekli kimlik doğrulama kullanır. Bu, CometAPI’yi yerleşik OpenAI provider’ından ayrı tutar, shell ortamı devralmayı gerektirmez ve ~/.codex/auth.json dosyasının yerine geçmez.

macOS / Linux / WSL
Windows PowerShell

CometAPI API key’inizi yerel bir anahtar dosyasında saklayın:

mkdir -p "$HOME/.codex"
printf "%s\n" "$COMETAPI_KEY" > "$HOME/.codex/cometapi_key"
chmod 600 "$HOME/.codex/cometapi_key"

Bu yapılandırmayı ~/.codex/config.toml dosyasına ekleyin:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"

[model_providers.cometapi.auth]
command = "sh"
args = ["-c", "cat \"$HOME/.codex/cometapi_key\""]

CometAPI API key’inizi Windows Codex ana dizininde saklayın:

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Content -NoNewline -Path "$HOME\.codex\cometapi_key" -Value $env:COMETAPI_KEY

Bu yapılandırmayı $HOME\.codex\config.toml dosyasına ekleyin:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"

[model_providers.cometapi.auth]
command = "powershell.exe"
args = [
  "-NoProfile",
  "-Command",
  "$p=Join-Path $HOME '.codex/cometapi_key'; (Get-Content -Raw $p).Trim()",
]

Windows yerel Codex, genellikle C:\Users\<user>\.codex olan $HOME\.codex dizinini kullanır. WSL ise Linux dağıtımının ~/.codex dizinini kullanır. Codex agent’ın çalıştığı ortamla eşleşen dizini düzenleyin.

Ortam değişkeni kimlik doğrulamasını kullanın

CometAPI API key’i bir ortam değişkeninde tutmayı tercih ediyorsanız, [model_providers.cometapi.auth] bloğu yerine env_key kullanın. Bu provider yapılandırmasını yalnızca COMETAPI_KEY, Codex’i başlatan ortamda kullanılabilir olduğunda kullanın:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"
env_key = "COMETAPI_KEY"

env_key ile [model_providers.cometapi.auth] öğesini birlikte kullanmayın. Codex, her özel provider için tek bir kimlik doğrulama yöntemini destekler.

Kurulum script’ini çalıştırın

Kurulum script’i isteğe bağlıdır. Aynı cometapi provider yapılandırmasını ~/.codex/config.toml dosyasına yazar, CometAPI API anahtarınızı ~/.codex/cometapi_key içinde saklar, dosya değişikliklerinden önce yedekler oluşturur ve Codex CLI mevcut olduğunda yapılandırmayı codex exec ile doğrular. macOS, Linux veya WSL için etkileşimli yükleyiciyi çalıştırın:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh)"

Etkileşimsiz kurulum için API anahtarını açıkça iletin:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY"

Windows yerel PowerShell için etkileşimli yükleyiciyi çalıştırın:

powershell -c "irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1' | iex"

Etkileşimsiz Windows kurulumu için API anahtarını açıkça iletin:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY"

Varsayılan olarak script ~/.codex/auth.json dosyasını değiştirmez ve bir ChatGPT girişini kaldırmaz. Script’in auth.json üzerinden Codex API-key girişini yönetmesini istiyorsanız yalnızca --force-auth-json veya -ForceAuthJson kullanın.

Bir model ID seçin veya değiştirin

Models sayfasından bir model ID kullanın. Manuel yapılandırmada, ~/.codex/config.toml içindeki model değerini değiştirin. macOS, Linux veya WSL için kurulum script’ini çalıştırırken --model parametresini iletin:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY" --model your-model-id

Windows yerel PowerShell için kurulum script’ini çalıştırırken -Model parametresini iletin:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY -Model 'your-model-id'"

Script, ayarlandığında CODEX_HOME kullanır. Aksi halde mevcut ortamın ~/.codex konumuna yazar.

Kurulumu doğrulayın

Kurulumu Codex CLI ile doğrulamak için herhangi bir yerel projeden şu salt okunur komutu çalıştırın:

codex exec --ephemeral --skip-git-repo-check --sandbox read-only --color never "Reply exactly with: COMETAPI_CODEX_OK"

Codex CLI PATH içinde mevcut değilse Codex uygulamasını açın ve yerel bir projeden kısa bir Prompt gönderin.

Sorun giderme

Codex hâlâ varsayılan OpenAI sağlayıcısını kullanıyor

Kullanıcı düzeyindeki ~/.codex/config.toml dosyasında model_provider = "cometapi" bulunduğunu doğrulayın.

API anahtarı değişti

~/.codex/cometapi_key dosyasını güncelleyin veya güncellenmiş $COMETAPI_KEY değeriyle kurulum scriptini yeniden çalıştırın.

PowerShell scripti ön kontrol denetimleri sırasında başarısız oluyor

Windows yerel PowerShell için manuel adımları kullanın, ardından doğrulama komutunu çalıştırın.

Pipe edilen shell kurulumu API anahtarı istemiyor

--key "$COMETAPI_KEY" kullanın, COMETAPI_KEY ayarlayın veya etkileşimli sh -c "$(curl ...)" komutunu çalıştırın.

Bağlantı zaman aşımına uğruyor veya yanlış base URL kullanılıyor

~/.codex/config.toml içinde base_url değerinin https://api.cometapi.com/v1 olduğunu doğrulayın.

Model bulunamadı

Kullanılabilir model ID’leri için Models sayfasını kontrol edin.

Windows kurulumu yanlış ortamı etkiliyor

Windows yerel modu için $HOME\.codex dosyasını düzenleyin veya WSL agent modu için WSL içindeki ~/.codex dosyasını düzenleyin.

ChatGPT girişi değişti

API-key giriş modunu istemiyorsanız --force-auth-json veya -ForceAuthJson kullanmayın.

Genel Bakış

AI kodlama ajanları

AI ajanları

AI sohbet istemcileri

Çeviri ve dil

Otomasyon platformları

Gözlemlenebilirlik ve değerlendirme

AI framework'leri

Ön koşullar

Bir kurulum yolu seçin

Seçenek 1: Codex'i manuel olarak yapılandırın (önerilir)

Seçenek 2: Script ile yapılandırın

Codex’i manuel olarak yapılandırın

Ortam değişkeni kimlik doğrulamasını kullanın

Kurulum script’ini çalıştırın

Bir model ID seçin veya değiştirin

Kurulumu doğrulayın

Sorun giderme

​Ön koşullar

​Bir kurulum yolu seçin

Seçenek 1: Codex'i manuel olarak yapılandırın (önerilir)

Seçenek 2: Script ile yapılandırın

​Codex’i manuel olarak yapılandırın

​Ortam değişkeni kimlik doğrulamasını kullanın

​Kurulum script’ini çalıştırın

​Bir model ID seçin veya değiştirin

​Kurulumu doğrulayın

​Sorun giderme

Ön koşullar

Bir kurulum yolu seçin

Codex’i manuel olarak yapılandırın

Ortam değişkeni kimlik doğrulamasını kullanın

Kurulum script’ini çalıştırın

Bir model ID seçin veya değiştirin

Kurulumu doğrulayın

Sorun giderme