> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex'i CometAPI ile kullanın

> Bu kılavuzu, kullanıcı düzeyindeki config.toml provider ayarlarını düzenleyerek Codex'i CometAPI ile yapılandırmak için kullanın.

Bu kılavuzu, [Codex](https://developers.openai.com/codex/quickstart)'i model provider olarak CometAPI ile çalıştırmak için kullanın.

Resmi başvurular:

* [Codex quickstart](https://developers.openai.com/codex/quickstart)
* [Codex config basics](https://developers.openai.com/codex/config-basic)
* [Codex custom model providers](https://developers.openai.com/codex/config-advanced#custom-model-providers)
* [Codex Authentication](https://developers.openai.com/codex/auth)
* [Codex on Windows](https://developers.openai.com/codex/windows)

## Ön koşullar

| Requirement      | Details                                                                                                                     |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------- |
| OS               | macOS, Linux, Windows yerel PowerShell veya WSL ile Windows                                                                 |
| Git              | 2.23+ önerilir                                                                                                              |
| Codex            | [Codex quickstart](https://developers.openai.com/codex/quickstart) sayfasından Codex uygulamasını veya Codex CLI'ı yükleyin |
| CometAPI API key | Bir tane [CometAPI dashboard](https://www.cometapi.com/console/token) üzerinden alın                                        |
| Model ID         | [Models page](/tr/overview/models) 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.

<CardGroup cols={2}>
  <Card title="Seçenek 1: Codex'i manuel olarak yapılandırın (önerilir)" icon="bolt" href="#configure-codex-manually">
    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.
  </Card>

  <Card title="Seçenek 2: Script ile yapılandırın" icon="puzzle-piece" href="#run-the-setup-script">
    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.
  </Card>
</CardGroup>

## 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.

<Tabs>
  <Tab title="macOS / Linux / WSL">
    CometAPI API key'inizi yerel bir anahtar dosyasında saklayın:

    ```bash theme={null}
    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:

    ```toml theme={null}
    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\""]
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    CometAPI API key'inizi Windows Codex ana dizininde saklayın:

    ```powershell theme={null}
    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:

    ```toml theme={null}
    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()",
    ]
    ```
  </Tab>
</Tabs>

<Note>
  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.
</Note>

## 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:

```toml theme={null}
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"
```

<Warning>
  `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.
</Warning>

## 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:

```bash theme={null}
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:

```bash theme={null}
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 theme={null}
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 theme={null}
powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY"
```

<Warning>
  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.
</Warning>

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

[Models sayfasından](/tr/overview/models) 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:

```bash theme={null}
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 theme={null}
powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY -Model 'your-model-id'"
```

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

## Kurulumu doğrulayın

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

```bash theme={null}
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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Model bulunamadı">
    Kullanılabilir model ID'leri için [Models sayfasını](/tr/overview/models) kontrol edin.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="ChatGPT girişi değişti">
    API-key giriş modunu istemiyorsanız `--force-auth-json` veya `-ForceAuthJson` kullanmayın.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/codex#howto",
        "name": "Codex'i CometAPI ile kullanın",
        "description": "Bu kılavuzu, kullanıcı düzeyindeki config.toml sağlayıcı ayarlarını düzenleyerek Codex'i CometAPI ile yapılandırmak için kullanın.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-1",
            "position": 1,
            "name": "Ön koşulları gözden geçirin",
            "text": "Codex'i CometAPI ile kullanın kılavuzundaki Ön koşulları gözden geçirin adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-2",
            "position": 2,
            "name": "Bir kurulum yolu seçin",
            "text": "Codex'i CometAPI ile kullanın kılavuzundaki Bir kurulum yolu seçin adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-3",
            "position": 3,
            "name": "Codex'i manuel olarak yapılandırın",
            "text": "Codex'i CometAPI ile kullanın kılavuzundaki Codex'i manuel olarak yapılandırın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-4",
            "position": 4,
            "name": "Ortam değişkeni kimlik doğrulamasını kullanın",
            "text": "Codex'i CometAPI ile kullanın kılavuzundaki Ortam değişkeni kimlik doğrulamasını kullanın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-5",
            "position": 5,
            "name": "Kurulum scriptini çalıştırın",
            "text": "Codex'i CometAPI ile kullanın kılavuzundaki Kurulum scriptini çalıştırın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-6",
            "position": 6,
            "name": "Bir model ID seçin veya değiştirin",
            "text": "Codex'i CometAPI ile kullanın kılavuzundaki Bir model ID seçin veya değiştirin adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-7",
            "position": 7,
            "name": "Kurulumu doğrulayın",
            "text": "Codex'i CometAPI ile kullanın kılavuzundaki Kurulumu doğrulayın adımını tamamlayın."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI Belgeleri",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Entegrasyonlar",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Codex'i CometAPI ile kullanın",
            "item": "https://apidoc.cometapi.com/integrations/codex"
          }
        ]
      }
    ]
    }
    `}
</script>