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

# Kodlama Ajanları

> Claude Code, Cursor, Cline, aider ve Codex'i OmniaKey'e yönlendirin

Her araç zaten konuştuğu protokolü kullanmaya devam eder — yalnızca base URL'i
ve anahtarı değiştirirsiniz. Önce [Dashboard](https://omniakey.com/dashboard/tokens)
üzerinden bir anahtar alın. [Modeller](/tr/models) sayfasındaki herhangi bir
model id'sini seçebilirsiniz.

## Claude Code

Claude Code Anthropic protokolünü kullanır, bu yüzden base URL çıplak host'tur:
`https://api.omniakey.com`.

<CodeGroup>
  ```bash macOS / Linux theme={null}
  export ANTHROPIC_BASE_URL="https://api.omniakey.com"
  export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
  claude
  ```

  ```powershell Windows (PowerShell) theme={null}
  $env:ANTHROPIC_BASE_URL = "https://api.omniakey.com"
  $env:ANTHROPIC_AUTH_TOKEN = "your-omniakey-api-key"
  claude
  ```
</CodeGroup>

Claude Code içinde `/model` ile model değiştirebilirsiniz (örn. `claude-opus-4-8`).

## Codex

Codex OpenAI uyumlu Responses trafiğini kullanır. `~/.codex/config.toml`
dosyasına bir provider ekleyin:

```toml theme={null}
model = "gpt-5.5"
model_provider = "omniakey"

[model_providers.omniakey]
name = "OmniaKey"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.omniakey.com/v1"
```

```bash theme={null}
export OPENAI_API_KEY="your-omniakey-api-key"
codex
```

## Cursor

**Settings → Models → API Keys** bölümünde **OpenAI API Key** seçeneğini açın,
anahtarınızı yapıştırın ve **Override Base URL** alanını
`https://api.omniakey.com/v1` yapın. `claude-opus-4-8` veya `gpt-5.5` gibi model
id'leri ekleyin.

## Cline

**OpenAI Compatible** provider'ını seçin:

* **Base URL:** `https://api.omniakey.com/v1`
* **API Key:** OmniaKey anahtarınız
* **Model kimliği:** örn. `claude-opus-4-8`

## aider

```bash theme={null}
export OPENAI_API_BASE="https://api.omniakey.com/v1"
export OPENAI_API_KEY="your-omniakey-api-key"

aider --model openai/claude-opus-4-8
```

## Gemini CLI

Gemini CLI Google hesabınızla kimlik doğrular ve **üçüncü taraf base URL'e
yönlendirme ayarı sunmaz** — bu yöndeki istek
[not planned olarak kapatıldı](https://github.com/google-gemini/gemini-cli/issues/1679).
Bugün Gemini CLI'nin kendisini OmniaKey üzerinden çalıştıramazsınız.

**Gemini modellerini OmniaKey üzerinden kullanmak** için yukarıdaki herhangi bir
OpenAI uyumlu araç veya SDK'yi kullanın; sadece model id değişir:

```bash theme={null}
export OPENAI_API_BASE="https://api.omniakey.com/v1"
export OPENAI_API_KEY="your-omniakey-api-key"

aider --model openai/gemini-3.1-pro-preview
```

Aynı durum Cursor, Cline, Codex ve OpenAI SDK için de geçerlidir: `/v1` base
URL'ini koruyun ve modeli `gemini-3.1-pro-preview` veya
`gemini-3-flash-preview` olarak ayarlayın. Tam Gemini listesi için
[Modeller](/tr/models) sayfasına bakın.

## Sorun giderme

* **401 / auth hataları** — anahtarın [Dashboard](https://omniakey.com/dashboard/tokens) içinde aktif olduğunu doğrulayın.
* **Yanlış base URL** — aracınızın protokolüyle eşleştirin: Claude Code (Anthropic) için çıplak host `https://api.omniakey.com`, OpenAI uyumlu araçlar için `https://api.omniakey.com/v1`, Gemini yerel SDK için `https://api.omniakey.com/v1beta`. `/v1/messages` gibi bir yolda gelen `404` genelde protokol ekinin yanlış olduğu anlamına gelir.
* **Bilinmeyen model** — model id'sini [Modeller](/tr/models) sayfasından birebir kopyalayın; id'ler büyük/küçük harfe duyarlıdır.
* **İstek reddediliyor** — anahtarın harcama sınırını ve bakiyenizi [Dashboard](https://omniakey.com/dashboard) içinde kontrol edin.