Claude Codeを今日から
使いこなすための1歩目

このキットの読み方

このキットは、Part 0〜4 の5パートに分かれています。プログラミング経験がまったくない方でも、上から順に読めば Claude Code を使い始められるように構成しました。

このドキュメント内の表記ルール

$ claude --version
2.1.x (Claude Code)

なぜ Claude Code なのか

世の中には ChatGPT、Gemini、Copilot など似た AI サービスがたくさんあります。その中で Claude Code を使う理由は、大きく3つです。

つまり Claude Code は、「ターミナルという場所に住んでいる、あなた専属のAIアシスタント」と思ってください。ブラウザで話しかけるのではなく、ターミナルで話しかけます。だから最初に、そのターミナルという場所に慣れるところから始めます。

ターミナルの基礎 CLI

ターミナルとは、キーボードで短い命令（コマンド）を打ってパソコンを操作するアプリです。マウスでクリックするのではなく、文字で指示を出します。Claude Code はこのターミナルの中で動くので、最低限の操作だけ覚えてしまいましょう。

ターミナルの起動方法

最初に覚える10個のコマンド

Claude Code を使うだけなら、実はこの10個で十分です。

パス（ファイルの場所）の書き方

パスとは、ファイルやフォルダがどこにあるかを文字で表した住所のようなものです。

Homebrew と Node.js tooling

Claude Code やその関連ツールをパソコンに入れる際、Homebrew（Mac/Linux）というツールがあると圧倒的にラクです。Windows の方は読み飛ばして構いません。

Homebrew のインストール（Mac）

ターミナルを開いて、以下の1行をコピペして Enter。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

途中でパスワードを聞かれたら、Mac のログインパスワードを入力します（画面には表示されませんが、打てています）。

インストール後に案内される echo ... の行をそのまま実行すると、brew コマンドがどこでも使えるようになります。

Node.js と npm（必要な時だけ）

Node.js を入れる場合は、以下のいずれかでどうぞ（Mac の例）。

1. 公式インストーラ：nodejs.org から LTS 版（安定版）の .pkg をダウンロードしてダブルクリック
2. Homebrew：brew install node
3. バージョン切替ツール（nvm / fnm）：複数バージョンを使い分けたい上級者向け

インストール後は以下で確認できます。

$ node --version
v24.x.x
$ npm --version
10.x.x

Git の基礎 version control

Git（ギット）は、ファイルの変更履歴を記録・管理するための仕組みです。例えると「Word の"変更履歴"や"元に戻す"の超強力版」。Claude Code は内部で Git を使ってファイル変更を追跡するので、基本だけでも知っておくと安心です。

Git の3つの概念

最初の設定（1回だけ）

ターミナルで以下を実行。名前とメールは、後で GitHub に登録するものと同じにしておくと紐付きが綺麗になります。

git config --global user.name "Your Name"
git config --global user.email "your@email.com"

最低限覚える Git コマンド

典型的な1日のワークフロー

$ git pull                           # 朝：最新の状態を取り込む
# ... ファイルを編集する ...
$ git status                          # 何を変えたか確認
$ git add .                           # 全変更を印付け
$ git commit -m "議事録テンプレを更新"  # 保存
$ git push                            # GitHub に送信

.gitignore（無視リスト）

プロジェクトのルートに .gitignore というテキストファイルを置くと、そこに書いたファイル／フォルダは Git の追跡対象から除外されます。

書いておくべきもの：

• .env, credentials.json などの機密情報（API キーやパスワードが入るファイル）
• node_modules/, dist/ などの自動生成ファイル（サイズが巨大）
• .DS_Store（Mac が勝手に作る隠しファイル）

GitHub の基礎 remote

GitHub は、Git のリポジトリをクラウドで預かってくれる共有プラットフォームです。Git という仕組みとは別物で、Git で管理しているプロジェクトを「GitHub に置く」ことでバックアップ・共有・共同作業ができるようになります。

GitHub アカウントを作る

1. github.com/signup にアクセス

   メールアドレス・パスワード・ユーザー名を入力します。

2. ユーザー名は慎重に決める

   後から変更は可能ですが、URL の一部（例：github.com/your-name）になります。職場で共有しても問題ない名前にしておきましょう。

3. メール認証を完了

   届いたメールのリンクをクリックして有効化。無料プラン（GitHub Free）でまったく問題ありません。

Public と Private の違い

GitHub CLI（gh コマンド）を入れる

GitHub CLI を入れておくと、GitHub 認証やリポジトリ操作がターミナルから直接できて便利です。Claude Code 公式も gh コマンドの利用を推奨しています。

$ brew install gh
$ gh auth login   # ブラウザが開いて GitHub にログイン → 完了

> winget install --id GitHub.cli
> gh auth login   # ブラウザが開いて GitHub にログイン → 完了

gh auth login を一度済ませておくと、git push のたびに認証を求められず、スムーズに作業が続けられます。

よく使う gh サブコマンド

知っておくと安心：Pull Request と Issue

Claude Code とは overview

Claude Code は、Anthropic 社が提供する ターミナル上で動く AI エージェント型のアシスタントです。普通の ChatGPT と違って、あなたのパソコンの中のファイルを直接読み書きしたり、ターミナルのコマンドを自分で実行したりできます。

従来の AI サービスとの違い

どこで動くか

• ターミナル（macOS / Linux / Windows） — もっとも基本的な使い方
• VS Code 拡張 / JetBrains 拡張 — 使い慣れたエディタの中から呼び出し
• デスクトップアプリ（Mac / Windows） — 独立したアプリとして起動
• Web 版（claude.ai/code） — ブラウザから

インストールと認証 setup

インストール方法は OS によって少しだけ違います。ネイティブインストーラ（公式推奨）・Homebrew（Mac）・npm の3択があります。

うまくいかないときの最終兵器

$ claude doctor

セットアップを自動で診断して、何が足りないか教えてくれます。セッション内からは /doctor としても呼べます。

最初に覚える10コマンド basics

Claude Code の中では、普通の会話とスラッシュコマンド（/ で始まる特別な命令）を使い分けます。全部覚える必要はなく、以下の10個だけで日常の9割はこなせます。

会話の中で使える特別な記号

便利なキーボードショートカット

Plan / Auto / 権限モード permission

Claude Code は、「どこまで自動で実行していいか」を権限モード（Permission Mode）で制御します。初心者は default と plan の2つだけ意識すれば OK です。

6つの権限モード

Plan Mode（計画モード）の使い方

Claude Code の中で Shift + Tab を押すと、モードが切り替わります。⏸ plan mode on と表示されたら Plan Mode です。

Auto Mode の注意点

CLAUDE.md とメモリ memory

CLAUDE.md は、「このプロジェクトではこう振る舞ってね」という指示書をまとめたファイルです。Claude Code は起動時に必ずこれを読むので、毎回繰り返さなくていい指示をここに書いておきます。

CLAUDE.md に書くべきこと

• プロジェクトの概要（何をするプロジェクトか、主な関係者）
• ファイルの配置ルール（議事録はここ、提案書はここ）
• 守ってほしい約束（このファイルには勝手に手を入れない等）
• 用語集（社内独自の略語、プロジェクト固有の呼び方）
• 望ましいコミュニケーションスタイル（丁寧に／手短に／絵文字なし等）

CLAUDE.md を置ける場所

迷ったらまず /init を実行しましょう。プロジェクト直下に CLAUDE.md のたたき台が自動生成されます。

簡単な書き方の例

# プロジェクト名：週次セミナー運営

## コミュニケーション
- 日本語で回答する
- 人名には「さん」をつける（大城のみ敬称なし）
- 日付は "2026-04-24" のように YYYY-MM-DD で書く

## ファイル配置
- 議事録は docs/meetings/ に置く
- 資料ドラフトは drafts/ に置く

## 禁止事項
- ops/CURRENT_*.md は自動更新スキル経由でのみ編集

Auto Memory（自動メモリ）

Claude Code にはもうひとつ、Auto Memory という機能があります。これは会話の中で得た学びや文脈をClaude が自動で記録しておき、次回起動時に思い出してくれる仕組みです。

使い分けは簡単です。「明文化したいルール」は CLAUDE.md に書く、「Claude が自然に覚えてくれれば十分なこと」は放っておく（＝ Auto Memory に任せる）。

Skills・サブエージェント・MCP extend

Claude Code は「デフォルト機能」だけでも十分強力ですが、拡張の仕組みを覚えると一気に自分仕様の道具になります。最初は名前だけ知っておけば OK です。

それぞれの追加方法（概要だけ）

# Skills：ディレクトリを作るだけ
mkdir -p .claude/skills/my-skill
vim .claude/skills/my-skill/SKILL.md  # やり方を書く

# サブエージェント：定義ファイルを置く
mkdir -p .claude/agents
vim .claude/agents/researcher.md

# MCP サーバー：コマンド一発で追加
claude mcp add <サーバー名> <コマンド>

基本ワークフロー：Explore → Plan → Code → Commit workflow

Anthropic 公式のベストプラクティスで最も重要なのが、この4ステップの流れです。大きな作業ほど、この順番を守ると失敗が激減します。

なぜこの順序が大事か

• Explore をスキップすると、Claude は現状を誤解したまま書き換えを始める
• Plan をスキップすると、あなたの想像と違う方向に大きく進んでしまう
• Commit をスキップすると、やり直したい時に戻れない

よい指示の書き方 prompting

Claude Code は 「具体的で、文脈のある、段階的な指示」に最もよく応えます。ChatGPT での会話と基本は同じですが、"手を動かす"エージェントなので、指示の粒度がより重要になります。

3つの原則

① 明確に（Be specific）

② 背景を伝える（Give context）

③ 段階を分ける（Break it down）

深く考えてほしい時：ultrathink キーワード

難しい問題で Claude にじっくり考えてほしい時は、指示の中に ultrathink という言葉を入れると、そのターンの思考予算（effort）が最大レベルに引き上げられます。対応モデルは Opus 4.6 / Opus 4.7 / Sonnet 4.6 などです。

このプロジェクトの構造が複雑なので、ultrathink で全体を
精査してから改善案をまとめてください。

よく使う指示テンプレ5選

コンテキスト管理 context

コンテキストとは、Claude が判断に使う「頭の中に入っている情報」のことです。限られた容量の中で、何を入れるか・何を入れないかがパフォーマンスを大きく左右します。

コンテキストを"整える"3つの習慣

1. 必要なファイルだけ見せる

   プロジェクト全体を読ませるより、@ で必要なファイルだけ指定するほうが速く正確。Claude Code は無指定だと関連ファイルを自動探索しますが、ピンポイントで渡したほうが思考が鋭くなる傾向があります。

2. 長くなったら /compact で圧縮

   長時間の会話は、古いやりとりが情報を圧迫します。/compact を実行すると、Claude が会話を要約して圧縮してくれます。話題が大きく切り替わるなら /clear で完全に新セッションに。

3. 大事な前提は CLAUDE.md に昇格

   同じ説明を毎回しているなら、その内容を CLAUDE.md に追記しましょう。以降のセッションで自動的に読まれるようになります。

"大きいファイル"を読むときのコツ

Claude Code は一度に全部読めないほど大きいファイルには、先頭から順に分割して読みます。「全部読んで」と明示することで、重要な終盤の情報を見落としません。

this-file.md は長いので、分割してでも必ず全文読んでから要約してください。
キーワード検索で済ませないでください。

セキュリティと事故防止 safety

Claude Code は強力なぶん、"やってはいけないことをやってしまう"リスクもゼロではありません。非エンジニアの方が最初に身につけるべき安全習慣をまとめました。

絶対に守りたい5つのルール

• 機密情報は Claude Code に見せない：API キー・パスワード・顧客情報など。会話履歴に残ります。
• 大きな変更は Plan Mode で下見：特に「全部消して作り直して」系の指示の前に。
• こまめに Git コミット：戻れる地点が増えるほど、大胆に試せます。
• Public リポジトリに機密を置かない：.env や認証ファイルは必ず .gitignore に。
• 不明な指示の自動実行は許可しない：特に rm -rf や git push --force 系が出てきたら一度手を止めて確認。

よくある事故パターン

"やり直したい"時の3つの手段

セットアップ完了チェックリスト checklist

ここまでを読んで実行していれば、次の項目にすべてチェックが付くはずです。

準備編

• ターミナルを開いて pwd と打って、自分のホームパスが表示される
• Mac なら Homebrew、Windows なら Git for Windows が入っている
• Node.js（任意）が入っていれば node --version でバージョンが出る
• git config --global user.name と user.email が設定済み
• GitHub アカウントを作成し、gh auth login でログイン済み

Claude Code

• Claude の Pro / Max / Team / Enterprise / Console プランに加入している
• claude --version でバージョンが表示される
• claude doctor が大きなエラーを出さない
• claude 起動 → ブラウザ認証が完了している
• 自分のプロジェクトフォルダで /init を実行し、CLAUDE.md を作った

最初の1週間でやってみたい5つ

1. 議事録を要約させる

   社内の Meeting メモを Claude Code に渡して、「決定事項・宿題・次回の議題」に分けてもらう。

2. 小さなファイル整理

   Downloads フォルダの整理、Desktop の片付けなど、失っても困らないタスクから。

3. Plan Mode を体験

   何か変更を頼む前に Shift+Tab。計画を出させて、実行の有無を選ぶ感覚をつかむ。

4. CLAUDE.md にルールを1つ追加

   「日付は YYYY-MM-DD で書く」など、守ってほしい小さなルールから。効果がすぐ実感できます。

5. Git コミットをしてみる

   「今の変更を適切なメッセージでコミットしておいてください」と一言。Claude が代わりにやってくれます。

公式リンク集 references

さらに学びたい方へ。すべて公式・1次情報なので、情報の鮮度が高いです。

Claude Code / Anthropic

• Claude Code 公式ドキュメント（Overview）
• Claude Code Best Practices（Anthropic 公式ベストプラクティス）
• Advanced setup（インストールとオプション）
• Commands reference（全スラッシュコマンド）
• Permission modes
• Memory（CLAUDE.md と Auto Memory）
• Skills
• Sub-agents
• Checkpointing / rewind
• MCP integration
• Anthropic 料金プラン

Git / GitHub

• Pro Git 第2版（日本語・無料）
• GitHub Docs（日本語）
• GitHub：Git のセットアップ
• GitHub CLI マニュアル

ターミナル / 環境構築

• Mac 用ターミナル使い方ガイド（Apple 公式）
• Windows Terminal（Microsoft 公式・日本語）
• WSL のインストール（Microsoft 公式・日本語）
• Homebrew（日本語）
• Node.js（日本語）