第5章 · Claude Code Basics

インストールと初回セットアップ

Install & Setup
→ で次のスライド · F でフルスクリーン · N で講師ノート · Esc で終了

重要キーワード

Native installer
ネイティブインストーラ
Node.js 不要で動く公式の単体バイナリ(現在の推奨)
npm
Nodeパッケージマネージャ
Node.js のパッケージ管理ツール(従来からのインストール手段)
WSL
Windows Subsystem for Linux
Windows 上で Linux を動かす環境
Permission Mode
権限モード
default / acceptEdits / bypassPermissions

インストール

📝 2026 年時点の推奨は ネイティブインストーラ(Node.js 不要)。npm 経由も引き続き利用可能ですが、Node が無くても入れられるネイティブ版が公式の第一推奨になりました。

ネイティブインストーラ(推奨)

macOS / Linux / WSL:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Windows PowerShell:

brew install --cask claude-code

Windows コマンドプロンプト:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

代替手段

Homebrew (macOS):

brew install --cask claude-code

WinGet (Windows):

winget install Anthropic.ClaudeCode

npm (Node.js 18+ がある場合):

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

Windows での選び方

  • ✅ WSL 推奨: Bash ツールが POSIX 互換 (sed/grep の挙動が安定)、symlink が動く。WSL では「macOS / Linux / WSL」のコマンドを使う
  • ✅ Windows ネイティブ(PowerShell / WinGet): .NET / MSBuild など Windows 専用ツールチェーンを触る時
  • どちらでも claude コマンドの使い勝手は同じ

インストール後の動作確認

claude --version       # バージョン表示
claude doctor          # 環境診断 (バージョン/プラットフォーム/設定パス)

初回ログイン

Pro / Max 契約で使う場合 (推奨)

claude

→ ブラウザが自動で開き Anthropic アカウントで OAuth ログイン → ターミナルに戻ると対話開始。 ログイン情報は ~/.claude/ 配下に保管され、次回以降は自動。

API キー課金モード

API キーで pay-as-you-go したい場合:

export ANTHROPIC_API_KEY="sk-ant-..."   # bash/zsh
$env:ANTHROPIC_API_KEY="sk-ant-..."     # PowerShell
claude --model claude-sonnet-4-6

.env ファイルを ~/.claude/ に置いておくと自動で読み込まれます。

よくある初回トラブル

症状 原因と対処
command not found: claude(ネイティブ) ~/.local/bin(macOS/Linux)や %LOCALAPPDATA%\Programs\claude\bin(Windows)を PATH に追加。シェル再起動も忘れずに
command not found: claude(npm) npm のグローバル bin が PATH に入っていない。npm config get prefix で確認
ブラウザログインがループ ~/.claude/auth.json を削除して再ログイン
EACCES permission error(npm) ネイティブインストーラに乗り換えるのが一番簡単。続けたい場合は nvm で Node を user 領域に
Windows で文字化け chcp 65001 で UTF-8 に切替
WSL からブラウザが開かない URL が表示されるので Windows 側ブラウザにコピペ

基本コマンド (CLI フラグ)

コマンド 動作
claude 対話セッション開始
claude -p "質問" ワンショット (print) モード — スクリプト/CI から呼ぶ
claude --resume / -c 直前の会話を再開 (重要!)
claude --resume <id> 特定セッションを ID 指定で再開
claude --model claude-haiku-4-5 起動時にモデル指定
claude --print 出力を pipe しやすいモード
claude --output-format=json 構造化出力 (CI 用)
Ctrl+C 1 回 入力欄クリア
Ctrl+C 2 回 セッション終了

セッション内の Slash コマンド (一覧)

コマンド 用途
/help ヘルプ表示
/clear コンテキストを完全リセット (新規 chat 同等)
/compact 会話を要約圧縮 (記憶を残しつつ context 縮小)
/model モデル切替 (Haiku ↔ Sonnet ↔ Opus)
/init プロジェクト用 CLAUDE.md 雛形を生成
/config 設定パネル (モデル・テーマ・hooks 等)
/permissions permission ルール編集
/hooks Hooks 設定パネル
/mcp MCP サーバー一覧・接続
/agents Subagents 一覧・追加
/login / /logout アカウント切替
/cost セッションのトークン消費・概算コスト
/doctor 環境診断
/bug バグ報告

💡 詳細は ch6「Claude Code 応用」で各機能を深掘りします。

権限モード (Permission Mode)

書き換え・コマンド実行を 承認するタイミング を切り替えます。

モード 編集 コマンド実行 おすすめ用途
default 都度承認 都度承認 慣れてないリポ / 初心者
acceptEdits 自動 都度承認 自分のリポでルーチン作業
plan しない しない 大規模変更の計画レビュー
bypassPermissions 全自動 全自動 サンドボックス / 使い捨て VM のみ

Shift+Tab でモード巡回。--permission-mode <mode> フラグで起動時指定も可。

⚠️ --dangerously-skip-permissions について

bypassPermissions をフラグ化したもの。個人 PC の本物のリポでは使わない。 使うとしたら: - Docker や DevContainer の使い捨て環境 - 専用の使い捨て VM - CI で完結するスクリプト

うっかり main ブランチで動かして本番設定を壊した、という事故が定番です。

安全に試すコツ

  1. ✅ 使い捨てフォルダから始める — ~/sandbox/cc-test/ のような場所
  2. ✅ default モードで操作の単位を観察
  3. ✅ 慣れてきたら acceptEdits、自分のリポでだけ
  4. ✅ 重要操作前に git status を一度確認する習慣を
  5. ✅ 危険操作は CLAUDE.md で禁止 (git push --force 等)

Pro / Max でセッション制限に当たったら

  • /model で軽量モデル (Haiku) に切替
  • /compact で会話を圧縮
  • /clear で完全リセット (内容を要約して保存してから)
  • API キーモードに切替

Hello, Claude Code

空フォルダで起動して、最初の依頼:

mkdir cc-test && cd cc-test
claude

「Hello World を出力する Python スクリプト hello.py を作って実行してください」

観察ポイント: 1. Write ツールで hello.py を生成 2. 確認プロンプトが出る (default モードなら) 3. Bash ツールで python hello.py を実行 4. 結果を要約して報告

これが Claude Code の 「考えて手を動かす」 基本パターンです。

Hands-on Exercise

演習: 空フォルダで Claude Code を起動

次の手順を実行してください。

  1. 空フォルダ cc-test/ を作成して cd
  2. claude を起動
  3. 「Python で素数を 100 個出力するスクリプト primes.py を作って実行して」と依頼
  4. 生成されたコード・実行結果を観察

気付くべきポイント: Claude が Write → Bash をどの順で呼ぶか、エラーが出たときの自己修復挙動。

▶ Playground を開いて実行

理解度チェック

4 問のクイズで理解度を確認しましょう。

クイズを開く
🎉

まとめ

お疲れ様でした!