Yazılar Depo 🔍 Ara
Depoya Dön
D-001

Ücretsiz Claude Code

Claude Code Alternatif Model Kurulumu

Bu kurulumda Claude Code normal şekilde kullanılmaya devam eder. Ancak Claude Code doğrudan kendi varsayılan model servisine bağlanmak yerine bilgisayarınızda çalışan yerel bir aracı servise bağlanır.

Bağlantı yapısı şu şekildedir:

Claude Code
↓
Yerel aracı servis — localhost:8082
↓
OpenRouter / NVIDIA NIM / Ollama

Başlamadan Önce

Bilgisayarınızda şunların bulunması gerekiyor:

1. UV ve Python Kurulumu

Mac veya Linux

Terminali açın ve sırasıyla şu komutları çalıştırın:

curl -LsSf https://astral.sh/uv/install.sh | sh
uv self update
uv python install 3.14

Windows

PowerShell’i açın ve şu komutları çalıştırın:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv python install 3.14

Burada uv isimli yardımcı araç kuruluyor ve ardından aracı servisin çalışması için Python yükleniyor.

2. Aracı Programı İndirin

Terminalde şu komutları sırasıyla çalıştırın:

git clone https://github.com/alishahryarr/free-claude-code.git
cd free-claude-code
cp .env.example .env

Bu işlemler:

  1. free-claude-code projesini bilgisayarınıza indirir.
  2. Proje klasörüne girer.
  3. .env isimli ayar dosyasını oluşturur.

Önemli: Bundan sonraki komutların free-claude-code klasörünün içerisindeyken çalıştırılması gerekiyor.

Terminali kapatıp tekrar açarsanız yeniden:

cd free-claude-code

komutuyla klasöre girmeniz gerekir.

OpenRouter ile Kurulum

En kolay seçenek olarak OpenRouter kullanılabilir.

3. OpenRouter API Anahtarı Oluşturun

OpenRouter sitesine girip hesap oluşturun.

Ardından:

  1. Hesap menüsünden API Keys bölümüne girin.
  2. Create butonuna basın.
  3. Anahtarın adını örneğin:
claude-code-local

olarak belirleyin.

  1. Oluşturulan API anahtarını kopyalayın.

API anahtarınızı kimseyle paylaşmayın.

4. .env Dosyasını Düzenleyin

free-claude-code klasörünün içerisindeki .env dosyasını açın.

Dosya görünmüyorsa:

Mac:

Command + Shift + .

Windows:

Dosya Gezgini → Görünüm → Gizli öğeler

.env dosyasının içerisine OpenRouter API anahtarınızı ve kullanacağınız modeli yazın:

OPENROUTER_API_KEY=buraya_api_anahtarınız

MODEL=openrouter/deepseek/deepseek-v4-flash

buraya_api_anahtarınız bölümünü kendi OpenRouter API anahtarınızla değiştirin.

Aracı Servisi Çalıştırma

Bu aşamadan sonra iki ayrı terminal penceresi kullanmanız gerekiyor.

5. Birinci Terminal: Aracı Servisi Başlatın

İlk terminalde free-claude-code klasörüne girin.

Doğru klasörde olduğunuzu kontrol etmek için:

pwd

Dosyaları kontrol etmek için:

ls -a

Ardından aracı servisi başlatın:

uv run uvicorn server:app --host 0.0.0.0 --port 8082

Terminalde buna benzer bir ifade görürseniz servis çalışıyor demektir:

Uvicorn running on 0.0.0.0:8082

Bu terminal penceresini kapatmayın.

Aracı servis çalıştığı sürece açık kalması gerekiyor.

6. İkinci Terminal: Claude Code’u Başlatın

Yeni bir terminal penceresi açın.

Mac veya Linux

ANTHROPIC_AUTH_TOKEN=anything \
ANTHROPIC_BASE_URL=http://localhost:8082/claude \
claude

Windows PowerShell

$env:ANTHROPIC_AUTH_TOKEN="anything"
$env:ANTHROPIC_BASE_URL="http://localhost:8082"
claude

Buradaki:

anything

gerçek bir API anahtarı değildir. Claude Code ilgili değişkenin boş olmamasını beklediği için örnek bir değer girilmektedir.

Claude Code artık yerel aracı servis üzerinden çalışacaktır.

Kurulumu Test Etme

Claude Code açıldıktan sonra:

Hello

yazın.

Birinci terminal penceresinde hareket veya istek kayıtları görüyorsanız bağlantı kurulmuş demektir.

Kurulum tamamlanmıştır.

NVIDIA NIM Kullanmak İsterseniz

OpenRouter yerine NVIDIA NIM de kullanılabilir.

NVIDIA’nın geliştirici platformunda hesap açıp bir API anahtarı oluşturun.

Ardından .env dosyasını şöyle değiştirin:

NVIDIA_NIM_API_KEY=buraya_api_anahtarınız

MODEL=nvidia_nim/z-ai/glm-4.7

.env dosyasında değişiklik yaptıktan sonra aracı servisi yeniden başlatmanız gerekir.

Birinci terminalde:

Ctrl + C

ile servisi durdurun.

Ardından tekrar:

uv run uvicorn server:app --host 0.0.0.0 --port 8082

komutunu çalıştırın.

Sonrasında Claude Code’u tekrar açın.

Ollama ile Bilgisayarda Çalıştırma

Modeli tamamen kendi bilgisayarınızda çalıştırmak için Ollama kullanılabilir.

Bu yöntemde API anahtarına ihtiyaç yoktur.

Ollama Kurulumu

Mac/Linux için:

curl -fsSL https://ollama.com/install.sh | sh
ollama --version

Alternatif olarak Ollama normal masaüstü uygulaması olarak da kurulabilir.

Model İndirme

Terminalde:

ollama pull gemma4

Ardından:

ollama serve

komutunu çalıştırın.

port already in use veya benzeri bir mesaj görürseniz Ollama zaten arka planda çalışıyor olabilir.

.env Dosyasını Ollama İçin Değiştirin

MODEL=ollama/gemma4:latest

API anahtarı girmenize gerek yoktur.

Daha sonra aracı servisi yeniden başlatın ve Claude Code’u tekrar açın.

Sorun Yaşarsanız Kontrol Edin

Kurulum çalışmıyorsa sırasıyla şunları kontrol edin:

Connection Refused

Aracı servis büyük ihtimalle kapanmıştır.

Tekrar:

uv run uvicorn server:app --host 0.0.0.0 --port 8082

komutunu çalıştırın.

Fast / Hızlı Mod Hatası

Claude Code içerisinde:

/fast

komutuyla hızlı modu kapatın.

.env Dosyası Görünmüyor

Mac:

Command + Shift + .

Windows:

Dosya Gezgini → Gizli öğeler

Model Kendini Claude Olarak Tanıtıyor

Kılavuza göre Claude Code içerisinde model ismiyle ilgili sabit bilgiler bulunabileceğinden, farklı bir model kullanılsa bile kendisini Claude olarak tanıtabilir.

Hangi modelin gerçekten kullanıldığını sağlayıcının kullanım kayıtlarından kontrol etmek gerekir.

En Kısa Kurulum Özeti

Terminal 1:

git clone https://github.com/alishahryarr/free-claude-code.git
cd free-claude-code
cp .env.example .env

.env:

OPENROUTER_API_KEY=API_KEYINIZ
MODEL=openrouter/deepseek/deepseek-v4-flash

Terminal 1:

uv run uvicorn server:app --host 0.0.0.0 --port 8082

Terminal 2 — Mac/Linux:

ANTHROPIC_AUTH_TOKEN=anything \
ANTHROPIC_BASE_URL=http://localhost:8082/claude \
claude

Terminal 2 — Windows:

$env:ANTHROPIC_AUTH_TOKEN="anything"
$env:ANTHROPIC_BASE_URL="http://localhost:8082"
claude

Ardından Claude Code’a bir mesaj gönderin. Birinci terminalde istek görünüyorsa sistem çalışıyor demektir.