ApiClo Dokümanları
Web sohbeti, IDE'ler, CLI aracıları, SDK'lar ve doğrudan API çağrıları için ApiClo kurun. Gerçek müşteriler için tek denge, tek anahtar, net rotalar ve hazır parçalar.
Neyi bağlamak istiyorsunuz?
Aracı değil senaryoyu seçin. Emin değilseniz Web Chat veya Hermes ile başlayın; VS Kodu için Cline/Kilo/Roo'yu kullanın ve terminal kullanımı için Claude Code veya Codex kullanın.
Tarayıcı sohbetini kullanın, kullanıcı arayüzünden bir model seçin ve Ücretsiz modelleri yalnızca mevcut oldukları sürece burada kullanın.
Sohbeti aç Hermes TemsilcisiApiClo'da hafıza, web içeriği, dosyalar ve uzun süreli çalışmalar içeren görevler için.
Hermes'i aç Masaüstü KöprüsüBir IDE veya aracının yerel bir yönlendiriciye, klasör erişimine ve bilgisayar dosyalarına ihtiyacı olduğunda köprüyü indirin.
.exe'yi indirin Düzenleyicideki kodBir projede aracı çalışması için en iyi yol: araçlar, dosya düzenlemeleri ve içerik kontrolü.
Eklentiyi seçin Terminal acentesiKabuk tabanlı çalışmalar için: Claude Code, Codex, OpenCode, Qwen Code, Aider.
CLI kılavuzlarını aç CursorÖzel temel URL aracılığıyla sohbet/planlama için çalışır. Tam kodlama aracısı iş akışları için Hermes, Cline, Kilo, Roo, Claude Code veya Codex'i tercih edin.
İmleci Ayarla Kendi uygulamasıSDK'lar, arka uçlar, hizmetler ve doğrudan HTTP istekleri için OpenAI uyumlu /v1.
API'yi açURL ve anahtar nereye koyulmalı
Kısa uyumluluk haritası. İstemci OpenAI uyumlu bir URL isterse /v1 kullanın. Bir Anthropic/Claude istemcisi /v1/messages'ı kendisi eklerse, /v1 olmadan kökü kullanın.
| Client | En iyi yol | Temel URL / anahtar | Model | Durum |
|---|---|---|---|---|
| İnternet Sohbetinormal kullanıcı | ApiClo'da sohbeti aç | API anahtarına gerek yok | kullanıcı arayüzünde seçildi | tavsiye edilen |
| Hermeshesap temsilcisi | Temsilciler → Hermes | ApiClo hesabı | kullanıcı arayüzünde seçildi | tavsiye edilen |
| Masaüstü Köprüsüyerel yönlendirici | Windows .exe'yi indirin | http://127.0.0.1:18441/v1istemci anahtarı herhangi bir yerel değer olabilir |
Fetch modellerinden | tavsiye edilen |
| Cline / Roo / KiloVS Kodu | OpenAI uyumlu profil | https://apiclo.com/v1sk-hub-... |
claude-sonnet-5 |
tavsiye edilen |
| Claude CodeCLI | ANTHROPIC_AUTH_TOKEN |
https://apiclo.comsk-hub-... |
claude-sonnet-5 |
CLI |
| CodexMasaüstü / CLI | ~/.codex/config.toml |
https://apiclo.com/v1APICLAUDE_API_KEY |
claude-sonnet-5 |
CLI |
| Cursorchat/plan | OpenAI-compatible | https://apiclo.com/v1sk-hub-... |
claude-sonnet-5 |
sınırlı |
| API / SDKHTTP | OpenAI SDK'sı | https://apiclo.com/v1Authorization: Bearer sk-hub-... |
claude-sonnet-5 |
API |
Ana yol: Hermes ve Masaüstü
Kullanıcının manuel SDK kurulumu olmayan çalışan bir aracıya ihtiyacı varsa buradan başlayın: Hermes, ApiClon içinde açılır ve yerel yönlendirici, dosyalar ve izinler için Masaüstü Köprüsü bilgisayara indirilir.
Yerleşik ApiClo aracısı: denge, modeller, bellek, web bağlamı ve geçmiş hesapta kalır.
Yerel yönlendirici ve bilgisayar bağlantısı için Windows uygulaması. IDE/CLI ve yerel dosyalar için anahtar indirme.
Bağlantı değerleri
Bu değerler hemen hemen her IDE ve SDK tarafından kullanılmaktadır. Her proje için ayrı bir anahtar oluşturun.
https://apiclo.com/v1
İmleç, Continue, Kilo, Codex, OpenCode, SDK'lar ve ham HTTP için.
https://apiclo.com
Claude Code, ham Anthropic SDK ve /v1/messages'ı kendileri ekleyen istemciler için.
sk-hub-...
Anahtarın tamamı API Anahtarları sayfasında bir kez gösterilir.
claude-sonnet-5
Sohbet ve kod için dengeli ücretli rota.
Ücretsiz Opus/Sonnet/Fable/GPT takma adları, promosyon kapasitesi mevcut olduğu sürece web sohbeti içindir. Ücretsiz* modelleri IDE'lere, aracılara veya harici API istemcilerine koymayın; aşağıdaki ücretli model kimliklerini kullanın.
Hızlı başlangıç
Kayıttan ilk IDE veya API yanıtına kadar olan en kısa yol.
- 1
Hazır temsilci çalışmasına ihtiyacınız varsa Hermes'i Temsilciler'de açın. Bu, bellek, web içeriği ve yönetilen görevler için ana yoldur.
- 2
IDE/CLI veya yerel dosyalara ihtiyacınız varsa ApiClo Desktop Bridge'i indirin: /downloads/ApiCloDesktopBridge.exe.
- 3
Bir hesap oluşturun ve bakiye ekleyin. Web sohbeti, API, Telegram ve yönetilen aracılar için tek bakiye işe yarar.
- 4
API Anahtarlarını açın ve belirli IDE veya proje için ayrı bir anahtar oluşturun.
- 5
Temel URL'yi, API anahtarını ve model kimliğini istemciye yapıştırın. OpenAI uyumlu istemciler için https://apiclo.com/v1; Masaüstü yönlendiricisi için http://127.0.0.1:18441/v1 adresini kullanın.
- 6
Bağlantıyı kısa bir istemle test edin: Yalnızca yanıtla Tamam. Daha sonra dosyaları değiştirmeden mevcut klasörü okumayı test edin.
- 7
Uzun kodlama görevleri için proje başına bir anahtar tutun, gereksiz model değişiminden kaçının ve node_modules, dist, log'ları ve dökümleri bağlamdan hariç tutun.
IDE agents such as Cline, Kilo, Roo, and Continue often send a system prompt, tool schema, diff, terminal output, and file list. This is normal for coding-agent mode, but these requests cost more than plain chat.
- Start regular coding with Sonnet; use Opus for hard reasoning, architecture review, and difficult bugs.
- Ask the agent to read specific files and folders instead of the whole project. Keep node_modules, dist, logs, dumps, huge JSON/CSV files, and binaries out of context.
- In Continue, keep maxTokens around 1800-4096 for normal chat/edit/apply, and raise it only when a long answer is actually needed.
- For Hermes, keep long work in one chat and avoid unnecessary model switching: memory, cache, and task history work better that way.
In Continue, SDKs, curl, and raw OpenAI-compatible API calls, use the exact id from /v1/models, such as claude-sonnet-5 or claude-opus-4-8. Do not add apiclaude/ before the model id when the client asks for model. Some UIs, such as Kilo, may show provider/model inside their own interface; that is not always the string for direct API calls.
VS Code eklentileri
Cline, Roo ve Kilo için varsayılan olarak /v1 Temel URL'sine sahip OpenAI uyumlu bir profil kullanın. İstemci açıkça /v1/messages'ı çağırdığında Anthropic Mesajları yalnızca yerel/gelişmiş mod olarak kullanın.
Cline
VS Kodu'da otonom kodlama görevleri için iyidir. ApiClo iki şekilde bağlanabilir.
Seçenek A: OpenAI Uyumlu
- 1
VS Code Marketplace'ten Cline'ı yükleyin ve Ayarlar / API Yapılandırmasını açın.
- 2
API Sağlayıcı olarak OpenAI Uyumlu'yu seçin.
- 3
Tam Temel URL'yi /v1 ile ayarlayın: https://apiclo.com/v1.
- 4
API Anahtarı: sk-hub anahtarınız. Model Kimliği: Claude-sonnet-5 veya Claude-opus-4-8.
- 5
Profili kaydedin ve önce testi gönderin: Yalnızca yanıtla Tamam.
API Provider: OpenAI Compatible
Base URL: https://apiclo.com/v1
API Key: sk-hub-...
Model: claude-sonnet-5
Seçenek B: Yerel mod için Anthropic Mesajlar
- 1
Cline yapınız Anthropic sağlayıcıyı gerektiriyorsa Özel temel URL kullan seçeneğini etkinleştirin.
- 2
Özel Temel URL: https://apiclo.com . Buraya /v1 eklemeyin; Cline /v1/messages'ın kendisini çağırır.
- 3
API Anahtarı: sk-hub anahtarınız. Model: Claude-sonnet-5 veya Claude-opus-4-8.
- 4
Anthropic yerel mod kararsızsa OpenAI uyumlu Seçenek A'ya dönün.
Provider: Anthropic
Custom Base URL: https://apiclo.com
Model: claude-sonnet-5
Kaydettikten sonra şunu gönderin: Yalnızca yanıtla Tamam. İkinci test: Mevcut klasöre bakın ve README.md dosyasının mevcut olup olmadığını söyleyin; hiçbir şeyi değiştirmeyin.
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
Roo Kodu
Roo Code, Cline ile hemen hemen aynı kurulumu kullanır ancak sağlayıcı profil etiketleri farklı olabilir.
- 1
Roo Kodu'u VS Code Extensions'tan yükleyin ve Roo Code panelini açın.
- 2
ApiClo'da API Anahtarları altında bir API anahtarı oluşturun.
- 3
API Yapılandırması / Sağlayıcı / Profili açın.
- 4
Varsayılan olarak OpenAI uyumlu bir profil seçin: Temel URL https://apiclo.com/v1 ve bir ApiClo model kimliği.
- 5
Yalnızca yerel/gelişmiş mod için /v1 olmadan Anthropic + özel temel URL https://apiclo.com'u kullanın.
- 6
Profili kaydedin, Tamam'ı doğrulayın ve ardından bir dosya görevi çalıştırın.
- 7
İkinci test: Roo'dan mevcut klasörü okumasını ve dosyaları düzenlemeden README.md dosyasının mevcut olup olmadığını söylemesini isteyin.
OpenAI Compatible Base URL: https://apiclo.com/v1
Anthropic Custom Base URL: https://apiclo.com
Model: claude-opus-4-8
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
Kilo Kodu
Kilo için Özel Sağlayıcıyı kullanın. Cline/Roo'dan farklı olarak Temel URL genellikle /v1 ile girilir.
- 1
Kilo Kodu'u VS Code Extensions'tan yükleyin ve Ayarlar / API Yapılandırmasını açın.
- 2
ApiClo -> API Anahtarları'ndan bir sk-hub API anahtarı alın.
- 3
Özel Sağlayıcı Oluşturun: Sağlayıcı Kimliği apiclaude, Görünen Ad ApiClo.
- 4
Claude modelleri için varsayılan olarak Sağlayıcı API'si: OpenAI Uyumlu ve Temel URL https://apiclo.com/v1'i seçin.
- 5
Sağlayıcı API'sini kullanın: Anthropic Mesajlar yalnızca Kilo'nun açıkça yerel Mesajlar moduna ihtiyacı olduğunda.
- 6
Model Kimliği: Claude-sonnet-5, Claude-opus-4-8 veya Claude-fable-5.
- 7
Sağlayıcıyı kaydedin ve iki test çalıştırın: Yalnızca yanıtla Tamam; daha sonra proje dosyası listesini düzenleme yapmadan okuyun.
Provider ID: apiclaude
Provider API: OpenAI Compatible
Base URL: https://apiclo.com/v1
Model ID: claude-sonnet-5
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
Devam et
Continue, config.yaml aracılığıyla yapılandırılır. Model sohbetini verin, rolleri düzenleyin, uygulayın ve özetleyin.
- 1
Devam et'ı yükleyin ve yapılandırmayı açın: Continue -> Ayarlar -> config.yaml'ı açın.
- 2
Zaten özel modelleriniz varsa, değiştirmeden önce eski config.yaml dosyasını kaydedin.
- 3
Aşağıdaki bloğu yapıştırın ve YOUR_API_KEY'inizi sk-hub anahtarınızla değiştirin.
- 4
Yeniden başlatın Continue edin veya IDE'de Yeniden Yükleme Penceresini çalıştırın.
- 5
Ağır bir görevden önce sohbeti test edin, düzenleyin ve küçük bir dosya üzerinde uygulayın.
~/.continue/config.yaml
name: ApiClo
version: 1.0.0
schema: v1
models:
- name: Claude Sonnet 5
provider: openai
model: claude-sonnet-5
apiBase: https://apiclo.com/v1
apiKey: YOUR_API_KEY
capabilities:
- tool_use
roles:
- chat
- edit
- apply
- summarize
defaultCompletionOptions:
temperature: 0
context:
- provider: code
- provider: docs
- provider: diff
- provider: terminal
- provider: problems
- provider: folder
- provider: codebase
This example does not impose hard contextLength or maxTokens values. Continue uses the selected model's capabilities and shows the active configuration in Continue Console → Options.
In a long Agent session, click Compact conversation, the converging-arrows icon under the latest response. Once context reaches 60%, the same action is available from the context indicator beside the input. Continue keeps a technical summary and sends it with only the newer turns. This compacts history rather than truncating the active task. After compaction, inspect the next request in Continue Console: it should contain the summary and only newer turns, not hundreds of old tool_result blocks.
If Continue rejects provider: openai, use its OpenAI-compatible/custom provider with the same apiBase/apiKey/model. For model, use claude-sonnet-5 or claude-opus-4-8 without the apiclaude/ prefix.
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
VS Kodu yerel BYOK
VS Code yerleşik Özel Uç Nokta için modelleri kullanıcı yapılandırma dosyasına ekleyin.
- 1
VS Code Kullanıcı ayarları klasörünü açın ve mevcut değilse chatLanguageModels.json dosyasını oluşturun.
- 2
JSON'u aşağıya yapıştırın ve YOUR_API_KEY'inizi sk-hub anahtarınızla değiştirin.
- 3
URL'nin /v1/chat/completions ile bitip bitmediğini kontrol edin.
- 4
Geliştiriciyi Çalıştır: Pencereyi Yeniden Yükle.
- 5
VS Code sohbetinde Claude Sonnet 5'i seçin ve testi Yalnızca yanıtla Tamam'ı gönderin.
%APPDATA%\Code\User\chatLanguageModels.json
[
{
"name": "ApiClo",
"vendor": "customendpoint",
"apiKey": "YOUR_API_KEY",
"apiType": "chat-completions",
"models": [
{
"id": "claude-sonnet-5",
"name": "Claude Sonnet 5",
"url": "https://apiclo.com/v1/chat/completions",
"toolCalling": true,
"vision": true,
"maxInputTokens": 184000,
"maxOutputTokens": 8000,
"streaming": true
},
{
"id": "claude-opus-4-8",
"name": "Claude Opus 4.8",
"url": "https://apiclo.com/v1/chat/completions",
"toolCalling": true,
"vision": true,
"maxInputTokens": 184000,
"maxOutputTokens": 8000,
"streaming": true
}
]
}
]
Developer: Reload Window
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
IDE ve masaüstü istemcileri
OpenAI uyumlu ayarlara sahip istemciler aynı Temel URL + API anahtar çiftini kullanır.
Cursor
En basit akış: ApiClo OpenAI uyumlu bir uç nokta olarak bağlayın.
- 1
İmleç Ayarlarını, Modellerini veya API Anahtarlarını açın.
- 2
OpenAI uyumlu özel bir uç noktayı etkinleştirin.
- 3
Temel URL: https://apiclo.com/v1. API anahtarı: sk-hub anahtarınız.
- 4
Model kimliğini ekleyin: düzenli çalışma için Claude-sonnet-5, yoğun muhakeme/kodlama için Claude-opus-4-8.
- 5
Ayarları kaydedin, İmleç sohbetinde modeli seçin ve Yalnızca yanıtla Tamam'ı gönderin.
- 6
İmleç /v1'in kendisini eklerse, kök URL'yi ikinci /v1 olmadan bırakın.
OpenAI Base URL: https://apiclo.com/v1
OpenAI API Key: sk-hub-...
Model: claude-sonnet-5
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
Trae
Trae, Ayarlar -> Modeller -> Model Ekle -> Özel Yapılandırma yoluyla bağlanır.
- 1
Trae'yi yükleyin ve oturum açın; aksi takdirde Modeller bölümü gizlenebilir.
- 2
Ayarlar -> Modeller -> Model Ekle -> Özel Yapılandırma'yı açın.
- 3
Trae tam /v1 uç noktasını isterse Claude için API Formatı Anthropic Mesajlar, URL https://apiclo.com veya https://apiclo.com/v1 seçeneğini seçin.
- 4
OpenAI Tamamlamaları için https://apiclo.com/v1 adresini ve claude-sonnet-5 model kimliğini kullanın.
- 5
API Anahtarını yapıştırın, modeli kaydedin ve Yalnızca yanıtla Tamam testini çalıştırın.
- 6
Trae boş bir yanıt gösterirse maksimum çıktıyı azaltın ve tam API Formatını kontrol edin.
API Format: OpenAI Completions
Custom Request URL: https://apiclo.com/v1
Model ID: claude-sonnet-5
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
WebUI / LibreChat'i açın
ApiClo OpenAI uyumlu bir sağlayıcı olarak bağlayın.
- 1
Şirket içinde barındırılan kullanıcı arayüzünüz için sağlayıcı yönetici ayarlarını veya env yapılandırmasını açın.
- 2
OpenAI uyumlu bir sağlayıcı seçin.
- 3
OPENAI_API_BASE_URL=https://apiclo.com/v1 ve OPENAI_API_KEY=sk-hub-...'ı ayarlayın.
- 4
DEFAULT_MODEL=claude-sonnet-5 ekleyin veya kullanıcı arayüzünde modeli seçin.
- 5
Kullanıcı arayüzü kapsayıcısını/işlemini yeniden başlatın ve kısa bir test gönderin.
OPENAI_API_BASE_URL=https://apiclo.com/v1
OPENAI_API_KEY=sk-hub-...
DEFAULT_MODEL=claude-sonnet-5
Kullanıcı arayüzü /v1'in kendisini ekliyorsa https://apiclo.com kökünü kullanın veya fazladan /v1'i ayardan kaldırın.
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
CLI ve terminal aracıları
CLI araçları için OpenAI uyumlu ve Anthropic uyumlu değişkenlerin karıştırılmaması özellikle önemlidir.
Claude Code
Claude Code genellikle /v1 içermeyen Anthropic uyumlu bir temel URL bekler.
- 1
Node.js 18+ sürümünü kontrol edin: node --version.
- 2
Claude Codenu yükleyin: npm install -g @anthropic-ai/claude-code@latest.
- 3
Kurulumu kontrol edin: Claude --version.
- 4
ApiClo için ANTHROPIC_AUTH_TOKEN + ANTHROPIC_BASE_URL'yi kullanın; ANTHROPIC_API_KEY yalnızca x-api anahtarı gerektiren istemciler içindir.
- 5
Set CLAUDE_CODE_AUTO_COMPACT_WINDOW=180000 so Claude Code summarizes a long session before the 200k boundary. This does not limit response size.
- 6
Öncelikle doğrudan /v1/messages isteğiyle ağ geçidini doğrulayın, ardından Claude'u aynı kabuk oturumundan başlatın.
- 7
Claude Code'da /status komutunu çalıştırın ve bunun ApiClo temel URL'sini ve etkin belirteç kaynağını gösterdiğini doğrulayın.
npm install -g @anthropic-ai/claude-code@latest
# macOS / Linux
export ANTHROPIC_AUTH_TOKEN="sk-hub-..."
export ANTHROPIC_BASE_URL="https://apiclo.com"
export ANTHROPIC_MODEL="claude-sonnet-5"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="180000"
claude
# Windows PowerShell
$env:ANTHROPIC_AUTH_TOKEN="sk-hub-..."
$env:ANTHROPIC_BASE_URL="https://apiclo.com"
$env:ANTHROPIC_MODEL="claude-sonnet-5"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="180000"
claude
~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://apiclo.com",
"ANTHROPIC_AUTH_TOKEN": "sk-hub-...",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "180000"
}
}
curl /v1/messages smoke
# macOS / Linux
curl -X POST "https://apiclo.com/v1/messages" \
-H "Authorization: Bearer sk-hub-..." \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":1,"messages":[{"role":"user","content":"."}]}'
# Windows PowerShell
Invoke-RestMethod -Method Post -Uri "https://apiclo.com/v1/messages" `
-Headers @{ "Authorization" = "Bearer sk-hub-..."; "anthropic-version" = "2023-06-01" } `
-ContentType "application/json" `
-Body '{"model":"claude-sonnet-5","max_tokens":1,"messages":[{"role":"user","content":"."}]}'
Duman msg_ ile JSON'u döndürürse, URL ve anahtar çalışır. Eğer 401 değerini döndürürse, istemci anahtarı yanlış başlıkla göndermiştir; ANTHROPIC_API_KEY'i yalnızca bir x-api-key senaryosu için kullanın.
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
Codex
Codex, config.toml'deki özel bir sağlayıcı aracılığıyla ApiClo'a yönlendirilebilir.
- 1
Codex Masaüstü / IDE'de dişliye tıklayın, ardından Codex Ayarları → config.toml'u açın; CLI aynı ~/.codex/config.toml dosyasını kullanır.
- 2
Sağlayıcıyı kullanıcı düzeyindeki yapılandırmaya ekleyin çünkü .codex/config.toml projesi sağlayıcı/auth'u tanımlamamalıdır.
- 3
APICLAUDE_API_KEY'i sk-hub anahtarınıza ayarlayın. Bu değişken adı aşağıdaki env_key tarafından seçilir.
- 4
Wire_api = Answers'ı koruyun: mevcut Codex'te bu, desteklenen sağlayıcı protokolüdür.
- 5
Codex bir test klasöründe çalıştırın ve Yalnızca yanıtla Tamam seçeneğini doğrulayın.
~/.codex/config.toml
model = "claude-sonnet-5"
model_provider = "apiclaude"
[model_providers.apiclaude]
name = "ApiClo"
base_url = "https://apiclo.com/v1"
env_key = "APICLAUDE_API_KEY"
wire_api = "responses"
APICLAUDE_API_KEY env
# macOS / Linux
export APICLAUDE_API_KEY="sk-hub-..."
codex
# Windows PowerShell
$env:APICLAUDE_API_KEY="sk-hub-..."
codex
Codex sağlayıcı yapılandırmasını reddederse önce Codex'i güncelleyin. Wire_api'yi Sohbet Tamamlamalarına değiştirmeyin: mevcut Codex belgeleri, yanıtları desteklenen sağlayıcı protokolü olarak tanımlar.
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
OpenCode
OpenCode, opencode.json aracılığıyla sağlayıcı yapılandırmasını destekler.
- 1
Bir test projesine gidin: cd ~/Desktop/my-project.
- 2
OpenCode'u yükleyin: curl -fsSL https://opencode.ai/install | bash veya npm kurulumu -g opencode-ai.
- 3
Kurulumu kontrol edin: opencode --version ve opencode --help.
- 4
Proje kökünde opencode.json oluşturun ve yapılandırmayı aşağıya yapıştırın.
- 5
Anahtarı açık kod sağlayıcıları oturum açma --provider apiclaude ile kaydedin.
- 6
Açık kodu çalıştırın ve Tamam/salt okunur testini gerçekleştirin.
npm install -g opencode-ai
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"apiclaude": {
"npm": "@ai-sdk/openai-compatible",
"name": "ApiClo",
"options": {
"baseURL": "https://apiclo.com/v1"
},
"models": {
"claude-sonnet-5": {
"name": "claude-sonnet-5"
}
}
}
},
"model": "apiclaude/claude-sonnet-5"
}
opencode providers login --provider apiclaude
opencode
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
OpenClaw
OpenClaw, models.json aracılığıyla iki sağlayıcı moduyla bağlanabilir.
- 1
Platformunuz için OpenClaw'ı yükleyin ve openclaw --version'ı kontrol edin.
- 2
OpenClaw modelleri dosyasını bulun veya yapılandırma klasöründe models.json dosyasını oluşturun.
- 3
Claude Mesajları modu için, baseUrl https://apiclo.com ile sağlayıcı apiclaude-messages'ı kullanın.
- 4
OpenAI Tamamlamalar modu için, baseUrl https://apiclo.com/v1 ile apiclaude-openai sağlayıcısını kullanın.
- 5
apiKey'i sk-hub anahtarınızla değiştirin ve bir projede salt okunur bir test çalıştırın.
{
"models": {
"mode": "merge",
"providers": {
"apiclaude-messages": {
"baseUrl": "https://apiclo.com",
"apiKey": "sk-hub-...",
"auth": "token",
"api": "anthropic-messages",
"models": [
{
"id": "claude-sonnet-5",
"name": "claude-sonnet-5",
"contextWindow": 184000,
"maxTokens": 8000
}
]
},
"apiclaude-openai": {
"baseUrl": "https://apiclo.com/v1",
"apiKey": "sk-hub-...",
"auth": "token",
"api": "openai-completions",
"models": [
{ "id": "claude-opus-4-8", "name": "claude-opus-4-8" }
]
}
}
}
}
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
Qwen Kodu
Qwen Code OpenAI uyumlu bir istemci olarak kurulursa OPENAI_* değişkenleri yeterlidir.
- 1
Node.js'yi kontrol edin: node --version.
- 2
Qwen Kodunu yükleyin: npm install -g @qwen-code/qwen-code@latest.
- 3
qwen --version ve qwen --help'i kontrol edin.
- 4
OpenAI uyumlu mod için OPENAI_API_KEY, OPENAI_BASE_URL ve OPENAI_MODEL'i ayarlayın.
- 5
Qwen Code derlemeniz Anthropic env'yi destekliyorsa Claude modelleri için ANTHROPIC_AUTH_TOKEN + https://apiclo.com kullanabilirsiniz.
- 6
Qwen'i çalıştırın ve Tamam/salt okunur testini gerçekleştirin.
npm install -g @qwen-code/qwen-code@latest
export OPENAI_API_KEY="sk-hub-..."
export OPENAI_BASE_URL="https://apiclo.com/v1"
export OPENAI_MODEL="claude-sonnet-5"
qwen
$env:OPENAI_API_KEY="sk-hub-..."
$env:OPENAI_BASE_URL="https://apiclo.com/v1"
$env:OPENAI_MODEL="claude-sonnet-5"
qwen
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
Aider
Aider, OpenAI uyumlu değişkenler aracılığıyla çalışır.
- 1
Aider'ı yükleyin: python -m pip install -U aider-chat.
- 2
Git projesinde test düzenlemelerinin güvenli olduğu bir terminal açın.
- 3
OPENAI_API_BASE ve OPENAI_API_KEY'i ayarlayın.
- 4
Aider --model openai/claude-sonnet-5'i çalıştırın.
- 5
Öncelikle bir dosyayı açıklamasını isteyin; yalnızca bağlantı doğrulandıktan sonra düzenlemelere izin verin.
python -m pip install -U aider-chat
OPENAI_API_BASE=https://apiclo.com/v1
OPENAI_API_KEY=sk-hub-...
aider --model openai/claude-sonnet-5
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
Pi
Pi, bir model dosyası aracılığıyla bağlanır ve Anthropic Mesajları veya OpenAI uyumlu modu kullanabilir.
- 1
Pi'yi bir macOS/Linux/WSL ortamına yükleyin ve pi --version'ı kontrol edin.
- 2
~/.pi/agent ve bir models.json dosyası oluşturun.
- 3
OpenAI uyumlu mod için baseUrl https://apiclo.com/v1 ve claude-sonnet-5 modelini ayarlayın.
- 4
Anthropic Mesajlar modu için baseUrl https://apiclo.com ve claude-sonnet-5 modelini kullanın.
- 5
Anahtarı APICLAUDE_API_KEY aracılığıyla veya doğrudan yerel yapılandırmada iletin, ardından pi'yi çalıştırın ve Tamam/salt okunur testini gerçekleştirin.
mkdir -p ~/.pi/agent
{
"providers": {
"apiclaude-openai": {
"baseUrl": "https://apiclo.com/v1",
"apiKey": "${APICLAUDE_API_KEY}",
"api": "openai-completions",
"models": [
{ "id": "claude-sonnet-5", "name": "claude-sonnet-5" }
]
}
},
"defaultModel": "apiclaude-openai/claude-sonnet-5"
}
export APICLAUDE_API_KEY="sk-hub-..."
pi
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
İkizler CLI
Yapınız özel bir OpenAI/Anthropic uç nokta belirlemenize izin vermediği sürece Gemini CLI şu anda iyi bir doğrudan ApiClo hedefi değildir.
- 1
Öncelikle Gemini CLI sürümünüzün özel bir temel URL ayarına sahip olup olmadığını kontrol edin.
- 2
Özel uç nokta kullanılamıyorsa Google sistem değişkenlerini geçersiz kılmaya çalışmayın: Cline, Roo, Kilo veya Qwen Code'u kullanın.
- 3
OpenAI uyumlu özel bir uç nokta mevcutsa https://apiclo.com/v1 Temel URL'sini, sk-hub API anahtarını ve claude-sonnet-5 modelini kullanın.
- 4
Kurulumdan sonra yalnızca salt okunur bir test çalıştırın. İstemci hâlâ Google uç noktasını arıyorsa desteklenen bir CLI'ye geçin.
Recommended alternative: Qwen Code, Cline, Roo Code, Kilo Code
Aracılar ve yerel yönlendirici
Yönetilen aracılar için harici API'deki ücretsiz modeller yerine ApiClo arayüzünü kullanın.
Hermes Temsilcisi
Yerleşik Hermes, ApiClon içinde yaşar: denge, model, bellek ve geçmiş, Aracılar tarafından yönetilir.
- 1
Ajanlar'ı açın ve Hermes'i seçin.
- 2
Ücretli listeden bir model seçin: Claude-sonnet-5, Claude-opus-4-8, Claude-sonnet-4-6.
- 3
Web sayfaları için sohbette web içeriğini etkinleştirin; URL, ApiClo okuyucu/tarayıcı geri dönüşü aracılığıyla okunacaktır.
- 4
Hermes'in bilgisayarınızla çalışmasına izin vermek için Desktop Bridge'i indirin, bir eşleştirme kodu oluşturun ve yalnızca gerekli dosya veya klasör izinlerini verin.
- 5
Uzun görevler için zincirin ortasında sebepsiz yere model değiştirmekten kaçının; önbelleğe ve bağlama yardımcı olur.
ApiClo Masaüstü / Yerel Yönlendirici
Yerel yönlendirici, bir istemci yalnızca localhost ile konuştuğunda veya anahtarı makinede merkezileştirmek istediğinizde kullanışlıdır.
- 1
ApiClo Masaüstü Köprüsü'i indirin ve IDE/CLI ile aynı makinede çalıştırın.
- 2
Yukarı akış sk-hub anahtarını Masaüstü Köprüsü'ne yapıştırın.
- 3
Modelleri getir'e tıklayın ve model listesinin yüklendiğinden emin olun.
- 4
Yönlendiriciyi başlat'a tıklayın.
- 5
IDE/CLI'de Yerel Temel URL http://127.0.0.1:18441/v1'i ve boş olmayan herhangi bir istemci API anahtarını ayarlayın.
- 6
Yalnızca Test Yanıtı Tamam; yanıt vermezse, yerel yönlendiricinin çalıştığını ve 18441 numaralı bağlantı noktasının boş olduğunu kontrol edin.
Download Windows: https://apiclo.com/downloads/ApiCloDesktopBridge.exe
Python app: https://apiclo.com/downloads/desktop-bridge-app.pyw
Python script: https://apiclo.com/downloads/desktop-bridge.py
Local Base URL: http://127.0.0.1:18441/v1
Client API Key: any non-empty value
Upstream key in Desktop Bridge: sk-hub-...
Önce Modelleri getir'e, ardından Yönlendiriciyi başlat'a tıklayın. IDE'de genel URL'yi değil, yerel Temel URL'yi kullanın.
Modeller 14 Model ID
Kopyala Model ID.
Claude
GPT
Ham API ve SDK'lar
ApiClo, genel /v1 aracılığıyla OpenAI uyumlu, Anthropic uyumlu ve Yanıt tarzı istekleri kabul eder.
OpenAI-compatible
IDE'ler, SDK'lar ve çoğu kendi kendine barındırılan arayüz için ana yol.
curl https://apiclo.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hi"}],
"max_tokens": 512,
"stream": true
}'
Anthropic-compatible
Claude Mesajlar API'sini bekleyen müşteriler için bunu kullanın.
curl https://apiclo.com/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 512,
"messages": [{"role": "user", "content": "Hi"}]
}'
Yanıtlar API'sı
Responses wire API'sine ihtiyaç duyan istemciler için bunu kullanın.
curl https://apiclo.com/v1/responses \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"input": "Write a short checklist for release QA."
}'
Python SDK'sı
Komut dosyaları, arka uç işleri ve testler için iyidir.
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://apiclo.com/v1",
)
response = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Hi"}],
max_tokens=512,
)
print(response.choices[0].message.content)
JavaScript / TypeScript
Ön uç destekli API rotaları ve Node.js hizmetleri için iyidir.
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.APICLAUDE_API_KEY,
baseURL: "https://apiclo.com/v1",
});
const response = await client.chat.completions.create({
model: "claude-sonnet-5",
messages: [{ role: "user", content: "Hi" }],
max_tokens: 512,
});
console.log(response.choices[0].message.content);
Verify before real work
First prove that the client is connected correctly. This takes a minute and saves money on broken IDE requests.
Open the model list with the same key used by the client. If it does not open, fix the key or Base URL first.
https://apiclo.com/v1/models
Send a short non-stream request: Reply only OK. This checks the key, model, and base chat route.
Reply only OK
If the client supports streaming, repeat the same short test with stream. This catches SSE issues before a large task.
stream: true
For an IDE agent, ask it to read the current folder and say whether README.md exists, without editing files.
Look at the current folder and say whether README.md exists. Do not change anything.
If the client uses tools, run a small read-only tool task before heavy coding. Success should include a normal answer, not an empty tool result.
Test long context only after basic checks pass. Start with specific files, not the whole repository.
Keys, usage, and logs
One balance can serve many clients, but separate keys by project make debugging and cost control easier.
Create a separate API key for each IDE, CLI, backend, or test environment. Then Usage and Logs show exactly what spent tokens.
Balance and top-up are in Dashboard. Detailed requests, tokens, cost, status, and errors are in Logs.
Coding extensions often send tool schemas, terminal output, diffs, history, file maps, and a large system prompt. This is normal agent behavior. To reduce spend, ask for specific files, exclude node_modules/dist/logs/dumps, and do not raise maxTokens without a reason.
If you stop a stream after the model has started replying, part of the request may already be counted. Do not blindly retry file-changing tool calls; check Logs and file state first.
Modeller
IDE ve API için ücretli model kimliklerini kullanın. Web sohbetine ücretsiz takma adlar bırakın.
| Model ID | Recommended for | Context | Çıkış | Araclar | Vision | Notes |
|---|---|---|---|---|---|---|
gpt-5-6-sol |
hard coding and deep reasoning | 128k | 8k | yes | client-dependent | preview; select the exact model ID |
gpt-5-6-terra |
everyday coding and reasoning | 128k | 8k | yes | client-dependent | preview; balanced GPT route |
gpt-5-6-luna |
fast tasks and short iterations | 128k | 8k | yes | client-dependent | preview; fast GPT route |
claude-sonnet-5 |
regular IDE/API work | 184k | 8k | yes | yes | default Claude model for coding |
claude-opus-4-8 |
hard coding and reasoning | 184k | 8k | yes | yes | more expensive than Sonnet; use for hard tasks |
claude-fable-5 |
review, writing, design audit | 184k | 8k | yes | yes | use after a short OK test in the client |
gpt-5-4 |
fast GPT tasks | 128k | 8k | yes | client-dependent | good for CLI/API work when explicitly selected |
gpt-5-5 |
strong GPT tasks | 128k | 8k | yes | client-dependent | select explicitly when you want the GPT route |
gpt-5-6-sol
flagship preview route · 128000 input · 8000 output
gpt-5-6-terra
balanced preview route · 128000 input · 8000 output
gpt-5-6-luna
fast preview route · 128000 input · 8000 output
claude-sonnet-5
dengeli ücretli rota · 184000 giriş · 8000 çıkış
claude-opus-4-8
güçlü kodlama ve muhakeme · 184000 giriş · 8000 çıkış
claude-opus-4-7
güçlü kodlama ve muhakeme · 184000 giriş · 8000 çıkış
claude-fable-5
yeni test rotası · 184000 giriş · 8000 çıkış
claude-sonnet-4-6
kararlı varsayılan · 184000 giriş · 8000 çıkış
claude-sonnet-4-5
kararlı geri dönüş · 184000 giriş · 8000 çıkış
claude-opus-4-6
eski güçlü rota · 184000 giriş · 8000 çıkış
claude-opus-4-5
eski güçlü rota · 184000 giriş · 8000 çıkış
claude-haiku-4-5
hızlı ve daha ucuz · 184000 giriş · 8000 çıkış
gpt-5-5
GPT ücretli rota · 128000 giriş · 8000 çıkış
gpt-5-4
hızlı GPT rotası · 128000 giriş · 8000 çıkış
İstemci Model bulunamadı mesajını gösteriyorsa, önce anahtarınızla /models dosyasını açın ve tam kimliği kontrol edin.
https://apiclo.com/v1/models
Troubleshooting
Yaygın hatalar neredeyse her zaman anahtar, temel URL, model kimliği veya protokol uyumsuzluğundan kaynaklanır.
Tam sk-hub anahtarının boşluksuz yapıştırıldığını kontrol edin. Anahtar bir kez gösterildiyse ve kaybolduysa yeni bir tane oluşturun.
Model kimliğini /models ile karşılaştırın. Kimlik yerine görünen ad kullanmayın.
Most often this is the wrong model id for the client. In Continue, SDKs, and raw API calls, use claude-sonnet-5, not apiclaude/claude-sonnet-5.
İstemcinin ikinci bir /v1 ekleyip eklemediğini kontrol edin. OpenAI uyumlu ihtiyaçlar /v1; Anthropic Mesajlar/özel taban genellikle /v1 olmadan köke ihtiyaç duyar.
node_modules, dist, log'lar, ikili dosyalar ve uzun dökümleri hariç tutun. Uzun görevler için bir devir özeti oluşturun.
Geri alma ile yeniden deneyin. Bu bir IDE ise oturum benzeşimini korumak için aynı anahtarı ve model kimliğini koruyun.
Bazı IDE'ler uyumlu modda görüşü sınırlandırır. Önce düz metin isteğini test edin, ardından görüntüleri ayrı ayrı test edin.