Claude Codeの使い方 — 入門記事の先へ

Claude Codeの使い方を扱う記事は多いものの、その大半は「インストールして最初の応答を得るまで」で終わります。本当に行き詰まるのはその後です。同じ説明を毎回繰り返すことになり、確認ダイアログが頻繁に表示され、作業中に5時間の使用量ウィンドウが閉じます。この記事は入門記事が終わる地点から始まり、この3つを順に整理します。

前提を1つそろえておきましょう。Claude Codeはチャット欄にコードを貼り付けるツールではなく、ターミナルでリポジトリ内に常駐するエージェントです。ファイルを読み、修正し、テストを実行し、コミットまで行います。だから最初にすべきことは使い方を暗記することではなく、プロジェクトのルールを渡すことです。

最初の3ステップ — 実行、/init、具体的な依頼

インストール直後に行う価値があるのは、この3つだけです。特に2つ目の/initを省略すると、その後のすべてのセッションで同じ説明を繰り返すことになります。

# 1. 프로젝트 디렉터리에서 실행한다 (이게 전제 조건입니다)
cd ~/work/my-app
claude

# 2. 첫 명령은 /init — 저장소를 읽고 CLAUDE.md를 만들어 줍니다
> /init

# 3. 이후엔 한국어로 그냥 부탁하면 됩니다. 파일 경로를 붙일수록 정확해집니다
> src/api/user.ts의 검증 로직을 zod로 바꾸고 테스트도 같이 고쳐줘

/initはリポジトリを読み取り、CLAUDE.mdを作成します。生成された内容は下書きなので、そのままにせず必ず手で整理してください。次の節ではその内容を説明します。

CLAUDE.md — 毎回説明していたことを一度だけ書く

CLAUDE.mdはプロジェクトルートに置くMarkdownファイルで、各セッションで自動的に読み込まれます。ここに書くのは「コードを読んでも分からないこと」だけです。

# 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/ — 생성물. 직접 수정 금지.

逆に、書いてはいけないものも明確です。ディレクトリ構造や関数の説明はコードを読めば分かるため不要です。CLAUDE.mdは各リクエストに添付されるので、長くなるほどトークンを消費します。短く、ルールだけにしてください。gitにコミットすると、チーム全体に同じルールが適用されます。

権限 — 確認ダイアログは減らすが、すべて無効にしない

ファイルを修正したりコマンドを実行したりするたびに確認ダイアログが表示されます。これは安全装置なので、すべて無効にするのではなく、読み取り・検証系だけを許可する設定が実務的です。セッション中に「常に許可」を選ぶと記憶され、.claude/settings.jsonに記載すればプロジェクト単位で固定されます。

すべての確認を省略するフラグもありますが、削除やリモートへのpushまで無確認になります。壊れても捨てられるコンテナや一時的な作業ツリー内でのみ使用してください。判断基準は--dangerously-skip-permissionsをいつ使うかにまとめています。

カスタムコマンド — 同じ依頼を毎回入力しない

レビュー、リリース前のチェック、コミットメッセージの整理のように、毎回ほぼ同じ方法で依頼する作業はコマンドにしておけます。.claude/commands/にMarkdownを置くだけです。

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

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

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

こうすると/review src/api/user.tsで同じ観点のレビューを実行できます。gitにコミットすればチームで共有でき、レビュー基準そのものをリポジトリに置けます。実際に使われるコマンドの形式は、Claude Code workflowsに英語で詳しく説明しています。

使用量ウィンドウが閉じたときに作業を続ける方法

サブスクリプションの使用量は5時間のローリングウィンドウで管理され、ちょうど作業が集中する午後に閉じることがあります。上位プランに変更しても、その瞬間に開くわけではありません。実質的な選択肢は3つです。

3つ目はサブスクリプションを解約せずに実行できます。以下の2行が設定されている間だけ従量課金され、変数を削除すればサブスクリプションに戻ります。キーがない場合は、まずClaude APIキーを発行してください。

# 사용량 창이 닫혀도 작업을 이어가는 두 줄.
# 이 변수가 설정된 동안에만 종량제로 청구되고, 지우면 구독으로 돌아갑니다.
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

料金はカタログからそのまま読み込まれます。Claude Sonnet 5は100万トークンあたり$1.40 / $7.00、Claude Haiku 4.5は$0.70 / $3.50です。前払い残高から差し引かれるため、利用しない月に請求はありません。サブスクリプションと従量課金のどちらが安いか、損益分岐点の計算はClaude Codeの料金に、韓国のカードで支払いが拒否された場合の解決方法はClaude APIの価格・支払いに、使用量ウィンドウの仕組み自体はClaude Proの制限にまとめています。

結果を良くする依頼、悪くする依頼

最後に、使い方の違いが最も大きく表れる部分です。ファイルパスを付けると探索に使うトークンが減り、結果が速く正確になります。「検証ロジックを直して」より「src/api/user.tsの検証ロジックをzodに変更して」のほうが効果的です。

また、大きな作業を一度に渡さないでください。変更 → テスト → 次の変更と分けると、失敗したときに戻る地点が明確になります。エラー発生時の切り分け方法はClaude Codeのエラー整理にあります。

OpenAI側のコーディングエージェントを同じように使いたい場合は、Codexの使い方で、ChatGPTの料金プランなしにAPIキーでCodex CLIを実行する手順をまとめています。

よくある質問