Claude Code nasıl kullanılır — giriş makalesinden sonra yapılacak 4 şey

Claude Code'un nasıl kullanılacağını anlatan çok sayıda yazı var, ancak çoğu “yükle ve ilk çalıştırmayı gerçekleştir” aşamasında bitiyor. Gerçek sorunlar bundan sonra başlıyor — aynı talimatları her seferinde yazmak, çok fazla onay iletişim kutusu görmek ve işin ortasında 5 saatlik kullanım sınırına çarpmak. Bu sayfa başlangıç yazılarının bittiği yerden başlar ve bu üç sorunu sırayla ele alır.

Öncelikle Claude Code, “kodu sohbete yapıştırma aracı” değil, terminalde deponun içinde yaşayan bir aracıdır. Dosyaları okur, değiştirir, testleri çalıştırır ve commit bile oluşturur. Bu yüzden ilk yapılması gereken kullanımını öğrenmek değil, projenin kurallarını aktarmaktır.

İlk 3 adım — başlatma, /init ve somut talep

Kurulumdan hemen sonra yapmaya değer yalnızca bu 3 şey vardır. Özellikle ikinci adım olan /init atlanırsa sonraki tüm oturumlarda aynı açıklamaları tekrarlamanız gerekir.

# 1. プロジェクトのディレクトリで起動する（ここが全ての前提）
cd ~/work/my-app
claude

# 2. 最初の一手は /init — リポジトリを読んで CLAUDE.md を書き出す
> /init

# 3. 以降は普通の日本語で頼む。ファイル名を添えるほど精度が上がる
> src/api/user.ts のバリデーションを zod に置き換えて、テストも直して

/init depoyu okur ve CLAUDE.md oluşturur. Oluşturulan içerik bir taslaktır; olduğu gibi bırakmayın, mutlaka elle düzenleyin. Sonraki bölüm içeriğini açıklar.

CLAUDE.md — her seferinde açıkladıklarınızı yalnızca bir kez yazın

CLAUDE.md proje köküne konan ve her oturumda otomatik olarak okunan bir Markdown dosyasıdır. Buraya yalnızca “kodu okuyarak anlaşılamayacak şeyleri” yazmalısınız.

# CLAUDE.md — プロジェクトのルート、git にコミットする

## コマンド
- テスト: npm test（1 ファイルだけなら npm test -- path/to/file）
- 型チェック: npx tsc --noEmit
- Lint: npm run lint

## 決めごと
- 日付は必ず date-fns。moment は使わない。
- API ハンドラは app/api/**/route.ts のみ。lib に書かない。
- コミットメッセージは日本語、prefix は feat / fix / docs。

## 触ってはいけない場所
- db/migrations/ — 生成物。手で編集しない。

Buna karşılık yazılmaması gerekenler de nettir. Dizin yapısı ve işlev açıklamaları kod okunarak anlaşılabilir, dolayısıyla gereksizdir. CLAUDE.md her isteğe eklendiğinden uzattığınızda kesin olarak token tüketir — kısa tutun, yalnızca kuralları yazın. Git'e commit ederseniz aynı kurallar tüm ekip için geçerli olur.

İzinler — onay sayısını azaltın, ancak fazla atlamayın

Her dosya değişikliğinde ve komut çalıştırmada onay istenir. Bu bir güvenlik mekanizmasıdır; tümünü kaldırmak yerine “yalnızca okuma ve doğrulama amaçlı işlemlere izin vermek” pratik dengedir. Oturum sırasında “her zaman izin ver” seçeneğini belirlediğinizde hatırlanır; .claude/settings.json içine yazarsanız proje bazında sabitlenir.

Tüm onayları atlayan bir bayrak da vardır, ancak silme ve uzak depoya push işlemleri de onaysız hale gelir. Bunu yalnızca bozulsa bile atılabilecek kapsayıcılarda veya geçici çalışma ağaçlarında kullanın. Karar ölçütleri ve güvenli kullanım --dangerously-skip-permissions kullanım alanları bölümünde açıklanmıştır.

Özel komutlar — aynı talebi her seferinde yazmayın

İnceleme, sürüm öncesi kontrol ve commit mesajı biçimlendirme gibi her seferinde neredeyse aynı şekilde talep edilen işler komuta dönüştürülebilir. .claude/commands/ içine Markdown koymanız yeterlidir.

# .claude/commands/review.md — 置くだけで /review として使える
指定されたファイルをレビューして、次の 3 点だけ指摘してください。

1. 実際に落ちる条件があるバグ（再現手順を添える）
2. 既存のユーティリティで置き換えられる重複
3. テストが無い分岐

スタイルの好みは指摘しないでください。

Böylece /review src/api/user.ts yazdığınızda aynı ölçütlerle bir inceleme döner. Git'e commit ederseniz ekip içinde paylaşabilir ve inceleme standardının kendisini depoya koyabilirsiniz. Pratikte etkili komut kalıpları Claude Code workflows bölümünde İngilizce olarak ayrıntılı biçimde açıklanmıştır.

5 saatlik pencere kapandığında çalışmaya devam etme

Abonelik kullanım kotası 5 saatlik kayan bir pencereyle yönetilir ve öğleden sonra, tam işe hız vermişken kapanır. Üst plana geçseniz bile o anda açılmaz. Gerçekte üç seçeneğiniz vardır.

Üçüncü seçenek aboneliği iptal etmeden uygulanabilir. Aşağıdaki 2 satır ayarlı olduğu sürece kullandıkça öde ücretlendirmesi uygulanır; değişkenleri kaldırdığınızda aboneliğe dönersiniz.

# 5 時間ウィンドウが閉じても作業を続けるための 2 行。
# この変数が設定されている間だけ従量課金になり、消せば元のサブスクに戻る。
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# Claude Code の既定モデルと opus エイリアスは最新の Opus を、sonnet エイリアスは
# Kunavo が提供していない Sonnet 5.5 を指す。/model sonnet や opusplan の実行
# フェーズ、sonnet 指定のサブエージェントが 404 にならないようモデルを固定する。
# opus は Opus 5.5 に固定（Claude Code v2.1.280 以降が必要。古ければ claude update）。
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5

# 補助的な処理を一番安いモデルに逃がす 1 行（毎セッション効く）
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Tarifeler doğrudan katalogdan yüklenir: Claude Sonnet 5 için 1 milyon token başına $1,40 / $7,00, Claude Haiku 4.5 için $0,70 / $3,50. Ücret ön ödemeli bakiyeden düşüldüğü için kullanılmayan aylarda fatura 0 olur. Abonelik ile kullandıkça öde modelinden hangisinin daha ucuz olduğu, adım başına gerçek tutar ve başa baş noktası Claude Code fiyatları bölümünde hesaplanır. Pencerenin nasıl çalıştığı Claude Pro limitleri bölümünde, varsayılan model seçimi ise Opus ve Sonnet arasındaki farklar bölümünde açıklanır.

Doğruluğu artıran ve azaltan talep biçimleri

Son olarak, kullanım becerisinin en çok fark yarattığı bölüm budur. Dosya adını ve yolu eklemek keşif için kullanılan token sayısını azaltır ve sonucu daha hızlı, daha doğru yapar — “doğrulamayı düzelt” yerine “src/api/user.ts içindeki doğrulamayı zod ile değiştir” deyin.

Ayrıca büyük bir talebi tek seferde göndermeyin. Değişiklik → test → sonraki değişiklik şeklinde bölerseniz başarısızlık durumunda geri dönülecek yer net olur. Hataları ayırarak inceleme, Claude Code 401 hatası gibi ayrı sayfalarda ele alınmıştır.

Aynı yaklaşımı OpenAI tarafındaki bir aracıyla denemek isterseniz, ChatGPT planı olmadan API anahtarıyla çalıştırma adımları Codex kullanımı bölümünde açıklanmıştır.

Sık sorulan sorular