インストールと初回セットアップ
重要キーワード (4 語)
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.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
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 ブランチで動かして本番設定を壊した、という事故が定番です。
安全に試すコツ
- ✅ 使い捨てフォルダから始める —
~/sandbox/cc-test/のような場所 - ✅ default モードで操作の単位を観察
- ✅ 慣れてきたら acceptEdits、自分のリポでだけ
- ✅ 重要操作前に
git statusを一度確認する習慣を - ✅ 危険操作は 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 の 「考えて手を動かす」 基本パターンです。