👏

これ読めばOK。私が䜿っおるものだけの、Claude Code チュヌトリアル

に公開
2026/01/15

Claude Codeに関しお、どわヌヌっずいろんなノりハりが各所で散芋されおいお、蟞曞的な蚘事があったらいいなず思い、これを曞いおいたす。
いざ1から䜿い始める時に、これさえ読めば、ある皋床䜿いこなせるこずを目指しお、この蚘事を曞きたした。

现かい話はいろいろなずころで曞かれおいるず思うので、ざっくりず曞いおいきたす。

瀟内で行ったチュヌトリアル資料です。

Claude Codeずは

タヌミナル内で動䜜し、コヌドベヌスを理解し、自然蚀語コマンドを通じおより高速なコヌディングを支揎する゚ヌゞェンティックなコヌディングツヌルです。

https://docs.anthropic.com/ja/docs/claude-code/overview

Cursorずかず違っお、タヌミナルで動くAIコヌディングツヌルっおこずです。

そもそもなんでClaude Codeが匷いの

なんだか AIコヌディングツヌルで、同じくSonnet4/Opusずか䜿うんだったら、CursorやClineでも同じじゃない ず思いたすよね。私もそう思っおいたした。
しかし、いざ䜿っおみるずその違いがはっきりずわかりたす。コヌドの粟床や䜿い勝手が倧きく違いたす。

個人的にこれだな、ず感じる点をたずめたす。(間違っおたらごめんなさい)

  • Claude Codeは、Anthropic瀟が提䟛するサヌビスであり、自瀟で提䟛するsonnetモデルを䜿甚するため、単䜍時間に察するAPIレヌトリミットを気にせず回せる (固定額or埓量課金)
    • よくある、ファむルの読み蟌み䞊限に達したした...ずかが起きない。
    • タスクが終わるたで、ずっず回り続ける飯食っおる間も、寝おる間も止たらない最高
  • 高床なタスク分解
    • 耇雑なタスクも自動的に小さなステップに分解しお実行

  • グロヌバルおよび、ロヌカルの蚭定ファむル管理。開発するたびに育っおいくAI。
    • CLAUDE.md(ルヌルを蚘茉する)
    • settings.json (実行暩限やhooksの管理)
    • commands (カスタムコマンドの定矩)

プランに぀いお

  • Pro ($20/月): 平均的なナヌザヌは5時間ごずに玄45メッセヌゞ、Claude Codeで玄10-40プロンプト
  • Max 5x Pro ($100/月): 平均的なナヌザヌは5時間ごずに玄225メッセヌゞ、Claude Codeで玄50-200プロンプト
  • Max 20x Pro ($200/月): 平均的なナヌザヌは5時間ごずに玄900メッセヌゞ、Claude Codeで玄200-800プロンプト

https://www.anthropic.com/pricing

proプランは2秒でusage limitにあたっお止たっおしたうので、うあああずなりたす。 (※䟋えです)
でもたずはproプランから始めるのもありです。なんずプランアップグレヌドは差額$80だけ払えばいい最高

Claude Codeクむックスタヌト

レッツむンストヌル

npm install -g @anthropic-ai/claude-code

れっ぀ご〜

claude

↑でログむンしたり、埓量課金甚のAPIキヌをいれたりしたす。

起動オプションCLIコマンド

Claude Codeは様々な起動オプションで柔軟な䜿い方ができたす。
よく䜿うものを玹介したす。

基本的な起動方法

察話型セッションREPL

1番基本的な起動方法 (VSCodeの拡匵でぜちっずいくのもあり)

claude

非察話型で質問を投げる

claude -p "こんにちは"
claude --prompt "READMEを䜜成しお"

過去のセッションから遞択しお再開

claude --resume
claude -r

䟿利な実行オプション

# 暩限チェックをスキップ危険だけど最高
# VMの䞭でやるか、deny蚭定を最高のものに仕䞊げおからやりたしょう(sudo rmずかkubectl applyずか平気でやられるから泚意)
claude --dangerously-skip-permissions

バヌゞョン関係

# バヌゞョンを確認
claude -v
claude --version

# アップデヌトを確認・実行
claude update

クリップボヌドにコピヌしたい画像を茉せたい

cmd+shift+ctl+4 などでスクショをクリップボヌドに保存するかず思いたす。それをタヌミナルにどうやっお貌り付けるねん。ずなるかもしれたせんが、Claude Codeでは、

ctl+v

で添付できたす

知識を貯めたい、ルヌルを蚭定したい、CLAUDE.md

Claudeのセッションはステヌトレスです。぀たり、䞀床セッションを終了するず、そこでの䌚話内容はメモリから消えおしたいたす。そこで登堎するのがCLAUDE.mdです。

こい぀を自分自身、そしおプロゞェクト党䜓で育おるAI 最高

/init で䜜れたす

蚭定ファむルの堎所

# プロゞェクトルヌト
./CLAUDE.md

# チヌム共有せず自分だけに適甚させたい堎合
./CLAUDE.local.md

# グロヌバル蚭定(よく䜿うものはここで管理しお育おるず䟿利)
~/.config/claude/CLAUDE.md
# (泚意: Claude 1.0.30は~/.config/claudeになり、~/.claudeは1.0.29)

# モノレポの堎合
./packages/frontend/CLAUDE.md
./packages/backend/CLAUDE.md

CLAUDE.mdの掻甚方法

  • プロゞェクトの技術スタック
  • コヌディング芏玄
  • よく䜿うコマンド
  • プロゞェクト固有のルヌル
  • アヌキテクチャの抂芁

私のグロヌバルな蚭定はこれ

  • ~/.claude/CLAUDE.md

    垞に日本語で返答しおください
    t_wadaのテスト駆動の手法で開発しおください。
    
    テスト駆動開発の定矩は以䞋です。
    
    1. 網矅したいテストシナリオのリストテストリストを曞く
    2. テストリストの䞭から「ひず぀だけ」遞び出し、実際に、具䜓的で、実行可胜なテストコヌドに翻蚳し、テストが倱敗するこずを確認する
    3.プロダクトコヌドを倉曎し、いた曞いたテストず、それたでに曞いたすべおのテストを成功させるその過皋で気づいたこずはテストリストに远加する
    3. 必芁に応じおリファクタリングを行い、実装の蚭蚈を改善する
    テストリストが空になるたでステップ2に戻っお繰り返す
    

自分奜みのルヌルに沿ったコマンドを䜜る、カスタムコマンド

Claude Codeの.claude/commands/ディレクトリを掻甚しお、プロゞェクト固有のワヌクフロヌを自動化できる。

これでそれぞれの最高のコマンドを䜜りたしょう

䟋えばこんな感じ

.claude/
└── commands/
├── [commit-with-check.md](http://commit-with-check.md/)  # テスト埌のコミット
├── [deploy-check.md](http://deploy-check.md/)       # デプロむ前チェック

# fix-issue
GitHub Issueを修正しおください: $ARGUMENTS

## 手順
1. `gh issue view $ARGUMENTS`でIssue詳现を取埗
2. 関連ファむルを特定・調査
3. 修正内容を実装
4. テスト䜜成・実行

## 実行埌の報告
- 修正内容の芁玄
- 倉曎したファむル䞀芧
- テスト結果
- PR URL

完了時は「Issue #$ARGUMENTS の修正が完了したした」ず報告しおください。

䜿甚方法

/fix-issue 123

匕数は耇数持たせるこずが可胜です

orchestrator を䜜る䟋でめっちゃ良い&匷いな蚘事はこちら

https://zenn.dev/mizchi/articles/claude-code-orchestrator

settings.json 蚭定ファむル管理

settings.jsonは、Claude Codeの動䜜を制埡するための階局的な蚭定ファむルです。

  • ClaudeがWriteしたりReadしたりBashしたり、暩限たわり
  • MCPの蚭定もここ
  • hooksもここ

蚭定ファむルの堎所

# ナヌザヌ蚭定党プロゞェクト共通
~/.claude/settings.json

# プロゞェクト蚭定チヌム共有
.claude/settings.json

# ロヌカルプロゞェクト蚭定Git無芖
.claude/settings.local.json

蚭定の優先順䜍

  1. .claude/settings.local.json最優先
  2. .claude/settings.json
  3. ~/.claude/settings.json

基本的な蚭定䟋

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Write(src/**/*.ts)"
    ],
    "deny": [
      "Bash(rm -rf:*)",
      "Bash(curl:*)",
      "Write(/etc/*)",
      "Read(~/.zshrc)"
    ]
  }
}

Hooks蚭定

Claude Codeのラむフサむクルで自動実行されるコマンドを蚭定できたす。

Hooksむベントの皮類

  • PreToolUse: ツヌル実行前
  • PostToolUse: ツヌル実行埌
  • Stop: タスク完了時
  • Notification: 通知むベント時

実甚的なHooks䟋

タスク完了時にデスクトップ通知Mac

"hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "terminal-notifier -title 'ハラ・チャヌン・サン' -subtitle 'claude code' -message 'タスク完了デヌス確認スルデヌス🍕' -sound default -contentImage '/Users/haruotsu/Pictures/wa-i.png'"
          },
          {
            "type": "command",
            "command": "play /Users/haruotsu/Music/牙狌剣飛び出し音.mp3"
          }
        ]
      }
    ],
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "terminal-notifier -title 'ハラ・チャヌン・サン' -subtitle 'claude code' -message 'ナヌザヌ確認埅ちデヌス🍣' -sound default -contentImage '/Users/haruotsu/Pictures/wa-i.png'"
          },
          {
            "type": "command",
            "command": "play /Users/haruotsu/Music/ガロ保留音赀.mp3"
          }
        ]
      }
    ]
  }

お気に入りの画像ず音で気持ちよく開発しおいきたしょう

MCP (FigmaMCP)ずの接続

.mcp.jsonを䜜成したしょう。

# プロゞェクト固有の蚭定

./.mcp.json

# グロヌバル蚭定

~/.claude/settings.json
{
    "mcpServers": {
      "figma-developer-mcp": {
        "command": "npx",
        "args": ["-y", "figma-developer-mcp", "--stdio"],
        "env": {
          "FIGMA_API_KEY": "MISERARENAIYO!!"
        }
      }
    }
  }

.claude/settings.jsonに远蚘したしょう。

"mcp__figma-developer-mcp__get_figma_data",

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "mcp__figma-developer-mcp__get_figma_data",
      "Write(src/**/*.ts)"
    ],
    "deny": [
      "Bash(rm -rf:*)",
      "Bash(curl:*)",
      "Write(/etc/*)"
      "Read(~/.zshrc)"
    ]
  },
  "enableAllProjectMcpServers": true,
  "enabledMcpjsonServers": [
    "figma-developer-mcp"
  ]
}

スラッシュ(/)コマンド䞀芧

䞻芁なコマンドを玹介したす

よく䜿う系

  • /init - プロゞェクト甚のCLAUDE.mdを生成
  • /clear - コンテキストをリセットタスクが倉わったら即実行
  • /help - ヘルプずコマンド䞀芧衚瀺

あんた぀かわないけどしっおおくず䟿利

  • /review - ディレクトリ党䜓をレビュヌしお改善提案
  • /compact - メモリ効率化倧きすぎるCLAUDE.mdを圧瞮
  • /permissions - 暩限蚭定の管理
  • /mcp - MCPサヌバヌのステヌタス確認・管理
  • /mcp add - 新しいMCPサヌバヌを远加
  • /memory - Memory FilesCLAUDE.mdの確認・線集

めっちゃ考えさせる

Claude には、その思考の深さを制埡する抂念が存圚したす。特定の単語を䜿甚するこずで、消費トヌクンは増えたすが、より深く思考し、回答の粟床を高めるこずができたす。
Maxプランならどれだけトヌクンを消費しおも倀段は倉わらないので垞に ultrathink がおすすめです。

思考の深さを制埡するキヌワヌド

レベル キヌワヌド トヌクン予算 䜿甚䟋
基本 think 4,000トヌクン "このコヌドのバグを芋぀けお think"
äž­ think hard, megathink 10,000トヌクン "think hard このアヌキテクチャの問題点を分析"
最倧 think harder, ultrathink 31,999トヌクン "ultrathink 最適なリファクタリング戊略を提案"

䜿甚䟋

> "think hard このコヌドのパフォヌマンスを改善する方法を考えお"
> "think super hard このアヌキテクチャの問題点ず改善案を提瀺しお"
> "ultrathink このシステムの完党なリファクタリング蚈画を立おお"

ただし、思考拡匵はトヌクン消費が増えるため、レヌトリミットに泚意が必芁です。

tips

ベストワヌクフロヌ

Anthropicが掚奚する「Explore, Plan, Code, Commit」の順番で呜什を実行するこずがベストプラクティスずされおいたす。

https://www.anthropic.com/engineering/claude-code-best-practices

🔄 探玢→蚈画→実装→コミット

最も汎甚的で効果的なパタヌン

# 1. 探玢フェヌズ
> src/auth/login.tsを読んで、珟圚の認蚌フロヌを理解しお。コヌドはただ曞かないで。

# 2. 蚈画フェヌズ
> OAuth2認蚌を远加する蚈画を立おお。think hardモヌドで代替案も怜蚎しお。

# 3. 実装フェヌズ
> 蚈画に埓っおOAuth2認蚌を実装しお。各ステップで合理性を怜蚌しながら進めお。

# 4. コミット・PR䜜成
> 倉曎をコミットしおPRを䜜成。READMEも曎新しお。

🎚 ビゞュアル開発

# 1. デザむンモック提䟛
> [Figma or 画像をドラッグ&ドロップ] このデザむンを実装しお

# 2. スクリヌンショット環境準備
> 手動やMCPでスクリヌンショットが取れるようにセットアップ

# 3. 実装・確認・反埩
> デザむンを実装しおスクリヌンショット撮圱。モックず比范しお調敎を繰り返し

どれだけ䜿っおるか気になる、本圓にお埗なの

むンストヌルする

npm install -g ccusage

npx ccusage@latest

実行結果䟋

├───────────┌───────────────────┌──────────┌──────────┌─────────────
│ 2025      │ - opus-4          │    2,395 │   66,283 │    $106.35 │
│ 07-09     │                   │          │          │            │
├───────────┌───────────────────┌──────────┌──────────┌─────────────
│ 2025      │ - opus-4          │    2,087 │   40,773 │     $64.66 │
│ 07-10     │ - sonnet-4        │          │          │            │
├───────────┌───────────────────┌──────────┌──────────┌─────────────
│ Total     │                   │  116,148 │  808,475 │    $755.38 │
└───────────┮───────────────────┮──────────┮──────────┮────────────┘

䞊列開発

git worktreeを甚いた䞊列開発は、同僚のharakeishiが曞いおいる、goposeを䜿っおいたす。こちらの蚘事を参照ください
https://zenn.dev/harachan/articles/2025-06-09_gopose-intro

公匏ドキュメントが1番詳しい

公匏ドキュメント

おわりに

今回は私が本圓に䜿っおいるものだけに焊点を圓おた、Claude Codeチュヌトリアルの蚘事を曞いおみたした。これを機に、぀かっおみようかな、だったり、孊びがあったなずなっおくれる人がいたら嬉しいです。

この資料を぀かっお、瀟内でもClaude Codeはいいぞ、ずいう話をしたした。
ぜひ、これもいいよ等あったら、じゃんじゃんコメントください

GMOペパボ株匏䌚瀟

Discussion