Claude Code nasıl kullanılır — başlangıç rehberinin bittiği yerden sonrası

Claude Code'u kullanmayı anlatan çok sayıda yazı var, ancak çoğu “kurulum ve ilk yanıtı alma” aşamasında biter. Asıl tıkanan kısım bundan sonrasıdır — aynı açıklamaları her seferinde tekrarlamak, onay pencerelerinin çok sık açılması ve işin ortasında 5 saatlik kullanım penceresinin kapanması. Bu yazı, başlangıç yazılarının bittiği yerden başlar ve bu üç konuyu sırayla ele alır.

Önce bir varsayımı netleştirelim. Claude Code, sohbet penceresine kod yapıştırdığınız bir araç değil, terminalde deponun içinde çalışan bir ajandır. Dosyaları okur ve değiştirir, testleri çalıştırır, hatta commit oluşturur. Bu nedenle ilk iş nasıl kullanılacağını ezberlemek değil, projenin kurallarını aktarmaktır.

İlk üç adım — çalıştırma, /init ve somut bir istek

Kurulumdan hemen sonra yapılmaya değer yalnızca bu üç şey vardır. Özellikle ikinci adım olan /init komutunu atlarsanız, bundan 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 dosyasını oluşturur. Oluşturulan içerik bir taslak olduğundan olduğu gibi bırakmayın; mutlaka elle düzenleyin. Sonraki bölüm bu içerikle ilgilidir.

CLAUDE.md — Her seferinde açıkladığınız şeyi bir kez yazın

CLAUDE.md, proje kökünde bulunan ve her oturumda otomatik olarak okunan bir Markdown dosyasıdır. Buraya yalnızca “kodu okuyarak anlaşılamayan şeyleri” yazın.

# CLAUDE.md — 프로젝트 루트에 두고 git에 커밋합니다

## 명령어
- 테스트: npm test (파일 하나만: npm test -- path/to/file)
- 타입 검사: npx tsc --noEmit
- 린트: npm run lint

## 규칙
- 날짜는 date-fns만 사용. moment 금지.
- API 핸들러는 app/api/**/route.ts에만 둔다.
- 커밋 메시지는 한국어, prefix는 feat / fix / docs.

## 건드리면 안 되는 곳
- db/migrations/ — 생성물. 직접 수정 금지.

Buna karşılık yazılmaması gerekenler de açıktır. Dizin yapısı ve işlev açıklamaları kod okunarak anlaşılabildiği için gereksizdir. CLAUDE.md, her isteğe eklendiğinden uzadıkça token tüketir — kısa tutun, yalnızca kuralları yazın. Git'e commit ederseniz aynı kurallar tüm ekibe uygulanır.

İzinler — Onay pencerelerini azaltın, ancak tamamen kapatmayın

Bir dosyayı değiştirirken veya komut çalıştırırken her seferinde bir onay penceresi açılır. Bu bir güvenlik önlemidir; tümünü kapatmak yerine yalnızca okuma ve doğrulama işlemlerine izin vermek pratik bir dengedir. Oturum sırasında “Her zaman izin ver” seçeneğini belirlerseniz seçim hatırlanır; .claude/settings.json dosyasına yazarsanız proje düzeyinde sabitlenir.

Tüm onayları atlayan bir bayrak da vardır; ancak silme ve uzak depoya push işlemleri de onaysız hâle gelir. Bunu yalnızca bozulduğunda atılabilecek kapsayıcılarda veya tek kullanımlık çalışma ağaçlarında kullanın. Karar ölçütleri --dangerously-skip-permissions ne zaman kullanılır? başlığında açıklanmıştır.

Özel komutlar — Aynı isteği her seferinde yazmamak

İnceleme, sürüm öncesi kontrol veya commit mesajını düzenleme gibi her seferinde neredeyse aynı şekilde talep ettiğiniz işler komut hâline getirilebilir. .claude/commands/ dizinine bir Markdown dosyası koymanız yeterlidir.

# .claude/commands/review.md — 파일만 두면 /review로 쓸 수 있습니다
지정된 파일을 리뷰하고 다음 세 가지만 지적하세요.

1. 실제로 실패하는 조건이 있는 버그 (재현 방법 포함)
2. 기존 유틸리티로 대체 가능한 중복
3. 테스트가 없는 분기

스타일 취향은 지적하지 마세요.

Böylece /review src/api/user.ts ile aynı bakış açısına sahip bir inceleme çalışır. Git'e commit ederseniz ekip bunu paylaşır ve inceleme ölçütlerinin kendisini de depoya koyabilirsiniz. Uygulamada kullanılan komut biçimleri Claude Code workflows sayfasında İngilizce olarak daha ayrıntılı açıklanmıştır.

Kullanım penceresi kapandığında çalışmaya devam etme

Abonelik kullanımı 5 saatlik kayan pencereyle yönetilir ve pencere tam da işlerin yoğunlaştığı öğleden sonra kapanabilir. Üst plana geçmek pencereyi o anda açmaz. Gerçekçi seçenekler üç tanedir.

Üçüncü seçenek, aboneliği iptal etmeden kullanılabilir. Aşağıdaki iki satır ayarlı olduğu sürece kullandıkça öde modeliyle ücretlendirilir; değişkenleri sildiğinizde aboneliğe dönersiniz. Anahtarınız yoksa önce Claude API anahtarı alın.

# 사용량 창이 닫혀도 작업을 이어가는 두 줄.
# 이 변수가 설정된 동안에만 종량제로 청구되고, 지우면 구독으로 돌아갑니다.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# 클로드 코드의 기본 모델과 opus 별칭은 최신 Opus를, sonnet 별칭은 Sonnet 5.5를
# 가리킵니다. Kunavo가 제공하지 않는 모델(Sonnet 5.5, 아직 들어오지 않은 새 Opus)을
# 요청해 404가 나지 않도록 모델을 고정합니다. sonnet을 고정하지 않으면 /model sonnet,
# opusplan의 실행 단계, model: 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

# 보조 작업을 가장 싼 모델로 넘기는 한 줄 (매 세션 효과가 있습니다)
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Ücretler katalogdan olduğu gibi okunur: Claude Sonnet 5, 1 milyon token başına $1,40 / $7,00; Claude Haiku 4.5 ise $0,70 / $3,50 tutarındadır. Ücretler ön ödemeli bakiyeden düşülür; bu nedenle çalışmadığınız aylarda ücret alınmaz. Abonelik ile kullandıkça öde seçeneklerinden hangisinin daha ucuz olduğu ve başabaş noktası hesabı Claude Code fiyatlandırması sayfasında, Kore kartıyla ödeme engellendiğinde çözüm Claude API fiyatlandırması ve ödeme sayfasında, kullanım penceresinin yapısı ise Claude Pro sınırları sayfasında açıklanmıştır.

Sonuçları iyileştiren ve kötüleştiren istekler

Son olarak, kullanım biçiminin en büyük farkı yarattığı bölüm budur. Dosya yolunu eklerseniz keşif için kullanılan token sayısı azalır ve sonuçlar daha hızlı, daha doğru olur — “doğrulama mantığını düzelt” yerine “src/api/user.ts'deki doğrulama mantığını zod'a dönüştür”.

Ayrıca büyük bir işi tek seferde vermeyin. Değişiklik → test → sonraki değişiklik şeklinde ilerlerseniz başarısızlık durumunda geri dönülecek nokta net olur. Hata oluştuğunda nasıl ayırt edileceği Claude Code hataları özeti sayfasında açıklanmıştır.

OpenAI tarafındaki kodlama ajanını aynı şekilde kullanmak istiyorsanız Codex kullanımı sayfasında, ChatGPT planı olmadan Codex CLI'yi API anahtarıyla çalıştırma adımlarını açıkladık.

Sık sorulan sorular