> ## Documentation Index > Fetch the complete documentation index at: https://docs.harogo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Claude Code > Bu rehber, Harogo destekli Claude Code'u birkaç dakika içinde kullanmaya başlamanıza yardımcı olur. > [!NOTE] > > **Bu kılavuz yalnızca Claude modellerini kullanır.** Claude Code, Claude modellerini (Claude Opus 5.5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Fable 5.1, Claude Haiku 5.5) ve istemci kısıtlaması olmayan modelleri (GLM, Qwen, Kimi, MiniMax, DeepSeek) çalıştırabilir. GPT modelleri Claude Code'da kullanılamaz — bkz. [Codex](https://docs.harogo.ai/tr/codex.md). ### 1. Claude Code'u Kurun #### Yerel Kurulum ```shellscript macOS theme={null} curl -fsSL https://claude.ai/install.sh | bash ``` ```shellscript Windows theme={null} irm https://claude.ai/install.ps1 | iex ``` #### npm ile Kurulum [Node.js 18 veya üzeri](https://nodejs.org/en/download/) gerektirir ```shellscript theme={null} npm install -g @anthropic-ai/claude-code ``` ### 2. Harogo API'sini Yapılandırın Harogo'nun model hizmetine Anthropic uyumlu API üzerinden bağlanmak için aşağıdaki ortam değişkenlerini ayarlayın. 1. `ANTHROPIC_BASE_URL` değerini `https://api.harogo.ai/` olarak ayarlayın 2. `ANTHROPIC_AUTH_TOKEN` değerini [Harogo platformundan](https://console.harogo.ai/keys) aldığınız API anahtarı olarak ayarlayın 3. `ANTHROPIC_MODEL` değerini Harogo'nun desteklediği bir Claude modeli olarak ayarlayın, örneğin `claude-sonnet-5`. > [tab] macOS > > 1. Varsayılan kabuğunuzu kontrol etmek için terminalde aşağıdaki komutu çalıştırın. > > ```shellscript theme={null} > echo $SHELL > ``` > > 2. Ortam değişkenlerini kabuk türünüze göre ayarlayın: > > ```shellscript Zsh theme={null} > # değerini Harogo platformundan aldığınız gerçek anahtarla değiştirin > echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.zshrc > echo 'export ANTHROPIC_AUTH_TOKEN=""' >> ~/.zshrc > echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.zshrc > ``` > > ```shellscript Bash theme={null} > # değerini Harogo platformundan aldığınız gerçek anahtarla değiştirin > echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.bash_profile > echo 'export ANTHROPIC_AUTH_TOKEN=""' >> ~/.bash_profile > echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.bash_profile > ``` > > 3. Ortam değişkenlerini uygulamak için terminalde aşağıdaki komutu çalıştırın. > > ```shellscript Zsh theme={null} > source ~/.zshrc > ``` > > ```shellscript Bash theme={null} > source ~/.bash_profile > ``` > > 4. Yeni bir terminal açın ve ortam değişkenlerinin etkin olduğunu doğrulamak için aşağıdaki komutları çalıştırın. > > ```shellscript theme={null} > echo $ANTHROPIC_BASE_URL > test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set" > echo $ANTHROPIC_MODEL > ``` > [tab] Windows > > Windows'ta Harogo'nun Taban URL'sini ve [API anahtarını](https://console.harogo.ai/keys) CMD veya PowerShell kullanarak ortam değişkeni olarak ayarlayabilirsiniz. > > > [tab] CMD > > > > 1. Ortam değişkenlerini ayarlamak için CMD'de aşağıdaki komutu çalıştırın. > > > > ```shellscript theme={null} > > REM değerini Harogo platformundan aldığınız gerçek anahtarla değiştirin > > setx ANTHROPIC_AUTH_TOKEN "" > > setx ANTHROPIC_BASE_URL "https://api.harogo.ai" > > setx ANTHROPIC_MODEL "claude-sonnet-5" > > ``` > > > > 2. Yeni bir CMD penceresi açın ve ortam değişkenlerinin etkin olduğunu doğrulamak için aşağıdaki komutları çalıştırın. > > > > ```shellscript theme={null} > > if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set > > echo %ANTHROPIC_BASE_URL% > > echo %ANTHROPIC_MODEL% > > ``` > > > [tab] PowerShell > > > > 1. Ortam değişkenlerini ayarlamak için PowerShell'de aşağıdaki komutu çalıştırın. > > > > ```shellscript theme={null} > > # değerini Harogo platformundan aldığınız gerçek anahtarla değiştirin > > [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "", [EnvironmentVariableTarget]::User) > > [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.harogo.ai", [EnvironmentVariableTarget]::User) > > [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5", [EnvironmentVariableTarget]::User) > > ``` > > > > 2. Yeni bir PowerShell penceresi açın ve ortam değişkenlerinin etkin olduğunu doğrulamak için aşağıdaki komutları çalıştırın. > > > > ```shellscript theme={null} > > if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" } > > echo $env:ANTHROPIC_BASE_URL > > echo $env:ANTHROPIC_MODEL > > ``` > [!NOTE] > > Claude Code'u CC Switch üzerinden yönetecekseniz, ayrıca genel `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` veya `ANTHROPIC_MODEL` değerleri ayarlamamanızı öneririz. Sistem veya kullanıcı düzeyindeki ortam değişkenleri, CC Switch'in yazdığı sağlayıcı yapılandırmasını geçersiz kılabilir. Bu durumda arayüzde doğru sağlayıcı seçili görünse de Claude Code aslında hâlâ eski bir anahtar veya modelle çalışır. ### 3. Yapılandırmayı Doğrulayın Ortam değişkenlerini veya CC Switch'i ayarladıktan sonra, uzun bir oturuma başlamadan önce anahtarın, modelin ve Anthropic uyumlu uç noktanın çalıştığını doğrulamak için önce tek bir minimal istek gönderin. ```bash macOS/Linux theme={null} curl https://api.harogo.ai/v1/messages \ -H "content-type: application/json" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \ -d '{ "model": "claude-sonnet-5", "max_tokens": 16, "messages": [{"role": "user", "content": "1+1, output only the answer"}] }' ``` ```powershell Windows theme={null} curl.exe https://api.harogo.ai/v1/messages ` -H "content-type: application/json" ` -H "anthropic-version: 2023-06-01" ` -H "x-api-key: $env:ANTHROPIC_AUTH_TOKEN" ` -d "{\"model\":\"claude-sonnet-5\",\"max_tokens\":16,\"messages\":[{\"role\":\"user\",\"content\":\"1+1, output only the answer\"}]}" ``` ### 4. Claude Code'u Kullanmaya Başlayın Yapılandırma tamamlandıktan sonra çalışma dizininize gidin ve başlamak için terminalde `claude` komutunu çalıştırın. ```bash theme={null} $ cd /path/your-project > claude ``` Başlangıçta `Not logged in · Please run /login` mesajını görüyorsanız veya Anthropic giriş akışına yönlendiriliyorsanız, bu genellikle Claude Code'un çalışan bir Harogo yapılandırmasını algılamadığı ya da ilk kullanım kurulumunun tamamlanmadığı anlamına gelir. Önce bir önceki adımdaki minimal isteğin `2` döndürdüğünü doğrulayın ve `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` veya `ANTHROPIC_MODEL` değerlerinin eski genel ortam değişkenleri tarafından geçersiz kılınıp kılınmadığını kontrol edin. Anahtarın çalıştığından emin olduktan sonra hâlâ giriş akışına yönlendiriliyorsanız, aşağıdaki adımlarla ilk kullanım kurulumunu atlayabilirsiniz: ![Claude Code ilk açılışında giriş yapma veya devam etme istemini gösteren terminal](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/cc-7.avif?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=80bd9b41f8af28fa7679659117d6266c) 1. Ana dizininizdeki `.claude.json` dosyasını bulun: * macOS / Linux: `~/.claude.json` * Windows: `C:\Users\%USERNAME%\.claude.json` 2. `hasCompletedOnboarding` alanını `true` olarak ayarlayın ```json theme={null} { "hasCompletedOnboarding": true } ``` 3. Dosyayı kaydedin, ardından terminalde `claude` komutunu yeniden çalıştırın. #### (İsteğe Bağlı) Modeli Yapılandırmanın Diğer Yolları Claude Code, modeli yapılandırmak için aşağıdaki yolları destekler; bunlar **en yüksek öncelikten en düşüğe doğru sıralanmıştır** — yüksek öncelikli bir ayar, düşük öncelikli olanı geçersiz kılar. 1. **Sohbet sırasında:** modeli değiştirmek için `/model ` komutunu çalıştırın. Tek seferlik geçişler için uygundur. ```text theme={null} /model claude-sonnet-5 ``` 2. **Claude Code'u başlatırken:** bir model belirtmek için `claude --model ` komutunu çalıştırın. Tek bir oturum için uygundur. ```text theme={null} claude --model claude-sonnet-5 ``` 3. **Ortam değişkenlerini ayarlayın:** görev karmaşıklığına göre farklı seviyelerde modeller yapılandırın; Claude Code göreve uygun modeli otomatik olarak seçer. Genel olarak uygulanır. ```shellscript theme={null} export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5" export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5" export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5" ``` Burada: * `ANTHROPIC_DEFAULT_OPUS_MODEL`: karmaşık muhakeme, mimari tasarım ve diğer yüksek zorluktaki görevler için. * `ANTHROPIC_DEFAULT_SONNET_MODEL`: kod yazma, özellik geliştirme ve diğer günlük görevler için. * `ANTHROPIC_DEFAULT_HAIKU_MODEL`: sözdizimi kontrolü, dosya arama ve diğer basit görevler için. 4. **settings.json içinde kalıcı olarak ayarlayın:** model yapılandırmasını Claude Code'un kullanıcı yapılandırma dosyasına (ör. `~/.claude/settings.json` veya Windows'ta `C:\Users\%USERNAME%\.claude\settings.json`) ya da proje düzeyindeki bir yapılandırmaya yazarak kalıcı bir kullanıcı veya proje düzeyi ayar oluşturun. ## CC Switch ile Yapılandırma 1. CC Switch'i açın, soldan **Claude Code**'u seçin ve ardından "Sağlayıcı Ekle" (Add Provider) seçeneğine tıklayın. ![CC Switch ana ekranındaki Sağlayıcı Ekle girişi](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/1.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=3a0a45652c18bbabd158f7e3a17a8dce) 2. Hazır ayarlar listesinden sağlayıcı olarak "Özel Yapılandırma" (Custom Configuration) seçeneğini seçin. ![CC Switch sağlayıcı ön ayar listesinde Custom Configuration seçimi](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_16.51.01.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=2d63af589968a3f94173587919cbf9a2) 3. Sağlayıcı adı, API anahtarı ve uç nokta ([https://api.harogo.ai](https://api.harogo.ai)) gibi bilgileri doldurun. Tüm alanları doldurduktan sonra "Ekle" (Add) seçeneğine tıklayın. ![CC Switch sağlayıcı yapılandırma formuna API anahtarının girilmesi](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_16.55.17.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=37caaae4e1ccd895dbe089f656e55751) 4. Ana ekrana döndüğünüzde sağlayıcı listesinden "harogo"yu seçin ve "Kullan" (Use) seçeneğine tıklayın. ![CC Switch ana ekranında harogo seçilip Use düğmesine tıklanması](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.00.16.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=78acb5f499057ae22c6e97c4d770f499) > ![Claude Code terminalinde status ve models komutlarıyla model yapılandırmasının kontrol edilmesi](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.03.17.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=192f4da074881e069682f2c9da8b3cd9) > > ![I Shot 2026 08 07 17 04 52](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.04.52.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=a8f4c213e6115c8c874979a1d7b0c388) > > İpucu: Claude Code terminalde açıldıktan sonra model kimliğini kontrol etmek için /status, yapılandırılmış başka bir model seçmek için /models yazın. > [!WARNING] > > CC Switch "Sistem ortam değişkeni çakışması algılandı" (System environment variable conflict detected) uyarısı gösterirse, önce `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` ve `ANTHROPIC_MODEL` değişkenleriyle ilgilenin. Bu genel değişkenler mevcut sağlayıcı yapılandırmasını geçersiz kılar — `ANTHROPIC_AUTH_TOKEN=` gibi bir yer tutucu değer kimlik doğrulamanın doğrudan başarısız olmasına neden olur. Genel değişkenlere artık ihtiyacınız olmadığından emin olduğunuzda, çakışan girdileri CC Switch'te kaldırın veya sistem/kullanıcı ortam değişkenlerini elle silip terminalinizi yeniden başlatın. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.