【第1回】今さら聞けないClaude Code入門【初級編】

AIを活用したコーディングツールが次々と登場する中、Anthropic社の「Claude Code」が大きな注目を集めています。

「ターミナルがこわい」「プログラミング経験がほとんどない」「エンジニアになりたてで不安」——そんな方でも、Claude Codeを安全に使い始めて、ちゃんと成果を出せるところまでを、できるだけやさしく丁寧にまとめました。

途中でつまずきやすいポイント（インストール、権限設定、秘密情報の保護、料金）を先回りして潰していきます。この記事を読み終える頃には、Claude Codeを使った開発の第一歩を踏み出せているはずです。

Claude Codeって何？

Claude Codeは、ターミナルで動く「AI相棒」です。

GitHub Copilotのようなコード補完ツールとは根本的に違います。Copilotが「入力中のコードの続きを予測して提案する」のに対し、Claude Codeは「プロジェクト全体を理解して、指示されたタスクを自分で考えて実行する」という、より高度な働き方をします。

あなたが「こういう作業をして」と伝えると、Claude Codeはあなたのパソコン上で次のようなことをあなたの許可を得ながら進めてくれます。

• ファイルを読んで状況を把握する
• コードを作る・直す（複数ファイルでもOK）
• テストやコマンドを実行して確認する
• うまくいかなければ原因を調べて修正する

つまり、「チャットで相談」だけじゃなく、「実際に手を動かして作業する」AIがClaude Codeです。

まるで優秀な先輩エンジニアが隣にいて、「これやっといて」と頼むだけで全部やってくれる感覚。しかも24時間365日、疲れ知らずで対応してくれます。

Claude Codeでできること

具体的にどんなことができるのか、いくつか例を挙げてみましょう。

コードを書いてもらう

「Reactで検索フォームのコンポーネントを作って。デバウンス処理も入れて、TypeScriptで。」と頼むだけで、ベストプラクティスに沿ったコードを生成してくれます。

バグを直してもらう

「このエラーログを見て原因を調べて直して」とログファイルを渡すだけで、原因を特定し、修正まで行ってくれます。

コードを理解する

「このプロジェクトの構造を教えて」「この関数は何をしているの？」と聞けば、引き継いだプロジェクトやOSSのコードを理解するのに重宝します。

Git操作を任せる

「今日の変更をいい感じにコミットして」「developブランチにリベースして」と頼めば、コミットメッセージの作成からコンフリクト解消まで、Git操作全般をお任せできます。

テストを書いてもらう

「この関数のユニットテストを書いて」「カバレッジを80%以上にして」と言えば、面倒なテスト作成も一瞬で終わります。

この記事でできるようになること

この記事を最後まで読むと、以下のことができるようになります。

• Claude Codeをインストールして起動できる
• 安全設定（.envブロック・許可制・CLAUDE.md）ができる
• 「はじめてのプロジェクト」で実際に成果物を作れる
• よくある詰まり（claude: command not foundなど）を自力で直せる
• 基本的なコマンドを使いこなせる

先に知っておくと安心：料金とデータの話

初心者がいちばん不安に感じるのが、料金とデータの扱いです。最初に整理しておきましょう。

料金は大きく2パターン

Claude Codeの使い方はざっくり2つあります。

1. Claudeのサブスクリプション（Pro/Max）で使う

ブラウザ版Claudeのアカウントでログインして、Claude Codeを使うパターンです。月額固定なので、料金を気にせず使えます。

2. API（従量課金）で使う

APIキーを使って課金するパターンです。使った分だけ支払います。開発者向けで、細かいコスト管理ができますが、使いすぎると思わぬ出費になることも。

完全初心者は、まず1のサブスクリプションから始めるのがおすすめです。APIは「使った分だけ課金」なので、慣れるまで料金が読みにくく不安になりやすいためです。

データ（学習利用・保持期間）について

Claude Codeはあなたの入力やコード変更をネットワーク越しに送って処理します。個人向け（Free/Pro/Max）では、学習利用を許可する・しないの選択があり、保持期間も変わります。

• 学習利用を許可：保持が長め（モデル改善のため）
• 学習利用を許可しない：保持が短め（プライバシー優先）

業務で機密性の高いコードを扱う場合は、設定を確認しておくと安心です。

始める前の準備

ここをしっかり押さえておくと、9割のつまずきを防げます。

必要なもの（最低限）

• インターネット接続
• Claudeアカウント（Freeでも可）
• ターミナル（macOSなら標準の「ターミナル」、WindowsならPowerShellまたはWSL）

「ターミナルが怖い」人へ

ターミナルに苦手意識がある方も多いと思います。でも安心してください。この記事で使うのは、たった3つのコマンドだけです。

この3つさえ覚えれば、Claude Codeを使い始められます。

Step 1. インストール

Claude Codeは公式の「標準インストール」が一番ラクです。Homebrewやnpmでも入れられますが、初心者はまず標準インストールが安心です。Node.jsなどの事前準備も不要です。

macOS / Linux / WSLの場合

ターミナルで以下のコマンドを実行します。

curl -fsSL https://claude.ai/install.sh | bash

インストールが完了したら、確認してみましょう。

claude --version

バージョン番号（例：2.0.30）が表示されれば成功です！

Windows（PowerShell）の場合

PowerShell（管理者権限でなくてもOK）で以下を実行します。

irm https://claude.ai/install.ps1 | iex

確認コマンドは同じです。

claude --version

Windows（WSLを使いたい場合）

WSL（Windows上でLinuxを動かす仕組み）を使うと、開発向けに安定します。WSL内のUbuntuなどで、上の「macOS / Linux / WSL」の手順を実行してください。

Step 2. 初回起動とログイン

インストールが完了したら、さっそく起動してみましょう。ターミナルで以下を実行します。

claude

初回はログインが求められます。画面の案内に従って進めてください。ブラウザが自動で開いて認証画面が表示されるので、Claudeアカウントでログインします。

ログインが完了すると、Claude Codeの対話画面が立ち上がります。プロンプト（入力待ちの状態）が表示されたら準備完了です。

もし途中で迷ったら、/help と入力するとコマンド一覧が表示されます。

Step 3. まずやる安全設定（最重要）

Claude Codeを安全に使うために、最初に必ず設定しておくべきことがあります。初心者におすすめの安全設定は以下の3つです。

1. 作業用フォルダを作る（いきなり大事なフォルダでやらない）
2. 秘密情報を読ませない（.env / secrets / credentialなど）
3. 危ないコマンドは許可制（必要な時だけ許可）

3-1. 作業用フォルダを作る（練習場）

まずは安全な「練習場」を作ります。いきなり本番のプロジェクトフォルダで試すのは避けましょう。

mkdir -p ~/claude-playground
cd ~/claude-playground
pwd

pwd を実行すると、/Users/あなたの名前/claude-playground のように表示されるはずです。

3-2. 秘密情報をブロックする

Claude Codeは settings.json で、読んでいいもの・ダメなものを制御できます。

初心者が一番やりがちな失敗が「.env をそのまま読ませてAPIキーが漏れる」パターンです。まず最初にブロックしておきましょう。

プロジェクト内に .claude フォルダを作成します。

mkdir -p .claude

次に、.claude/settings.json を作成します。以下の内容をコピペしてください。

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)"
    ]
  }
}

この設定により、.env ファイルや secrets フォルダ内のファイルをClaude Codeが読めなくなります。

3-3. 「許可制」で運用する

Claude Codeは基本的に、ファイル変更やコマンド実行の前に承認を求めてきます。初心者のうちはこの「許可を求める状態」のままが安心です。

何でも自動で許可してしまうと、意図しない変更が加わる可能性があります。最初は一つひとつ確認しながら進めましょう。

• 設定を確認したいとき → /permissions
• 設定画面を開きたいとき → /config

Step 4. CLAUDE.mdでプロジェクトのルールを教える

Claude Codeは CLAUDE.md というファイルで、プロジェクトの方針や好みを覚えてくれます。このファイルがあると、Claude Codeがプロジェクトの背景を理解した上で作業してくれるようになります。

Claude Codeで以下を実行してください。

/init

すると CLAUDE.md のひな形を自動で作ってくれます。

生成されたファイルに、以下のような情報を追記しておくと効果的です。

# このプロジェクトの目的
- Claude Codeの練習用プロジェクトです。初心者向けに、分かりやすく進めてください。

# 進め方のルール
- いきなり大量に変更せず、まず計画（TODO）を出してから進めてください。
- コマンドを実行する前に、何をするか一行で説明してください。
- 分からない前提があれば、作業を止めて質問してください。

# 出力の希望
- できるだけ短い手順で、コピペできる形で提示してください。

こうしておくと、Claude Codeが「まずTODOを出す」「一つずつ確認しながら進める」といった動き方をしてくれます。

Step 5. はじめての実戦：成果物を作ってみよう

ここからは「小さく作って成功体験」を狙います。いきなり大きなアプリを作ろうとせず、まずは簡単なものから始めましょう。

完全初心者におすすめの最初のプロジェクトは、1枚のWebページ（HTML/CSS）です。環境構築が不要で、すぐに結果が見えるからです。

Claude Codeへの最初の依頼

Claude Codeを起動して、以下のように話しかけてみてください。

いまのフォルダに、自己紹介の1枚ページを作りたいです。
初心者なので、必要なファイルは最小で。index.html と style.css の2つだけでお願いします。
先にTODOを出してから進めてください。

Claude Codeはおそらく、次のような流れで進めてくれます。

1. TODOリストを作成
2. ファイルを作成（または編集）
3. 表示確認の手順を案内

見た目が微妙なときの直し方

AIが作ったデザインが微妙でも大丈夫。直し方はシンプルです。思ったことをそのまま伝えましょう。

• 「もっと余白を増やして」
• 「スマホで見やすいように」
• 「フォントは読みやすいものに」
• 「ボタンを1つ追加して」
• 「背景色をもう少し明るく」

ここで大事なのは、理想を言葉にすること。絵コンテのように短い文でOKです。

Step 6. 成果が出る「依頼の型」

Claude Codeでうまくいく人は、だいたい以下の順番で伝えています。この「型」を覚えておくと、スムーズに作業が進みます。

依頼テンプレート（コピペ用）

目的：○○を作りたい／直したい
現状：いまこうなっている（エラーがあれば貼る）
ゴール：最終的にこうしたい
制約：触っていい場所／触らない場所、使っていい技術
お願い：先にTODOを出して、1ステップずつ進めて

この形式で依頼すると、Claude Codeが的確に動いてくれます。

Step 7. よく使うスラッシュコマンド

Claude Codeにはたくさんのコマンドがありますが、初心者はまず以下だけ覚えれば十分です。

毎日使うコマンド

設定・確認系コマンド

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

特に Escape × 2回は覚えておくと便利。「あ、さっきの状態に戻したい」というときにすぐ戻れます。

Step 8. よくあるトラブルと解決法

「claude: command not found」と表示される

原因として考えられるのは以下の3つです。

• インストールが完了していない
• ターミナルを開き直していない
• PATHが通っていない

対処法：

1. ターミナルを一度閉じて、開き直す
2. もう一度 claude --version を実行
3. それでもダメなら、Step 1のインストールをやり直す

コマンド実行が怖い

その感覚は正解です。初心者は「許可制」で進めましょう。

• 「このコマンド、何をするの？」とClaude Codeに聞く
• 不安なら「実行しないで、代替手順だけ教えて」と言う

変更が大きすぎて怖い

Claude Codeに以下のように頼むと安全です。

• 「まず差分だけ見せて」
• 「1ファイルずつ、小さく変更して」
• 「理由を一行で添えて」

初心者が「伸びる」使い方

最後に、上達のコツをまとめます。

• 1回で全部頼まない：「TODO → 1ステップずつ」の流れで
• 不安は言語化する：「危ない操作はしないで」「差分を見せて」
• 迷ったらリセット：/clear で会話をクリア
• 長くなったら整理：/compact で要約
• 調子が悪かったら診断：/doctor

まとめ

Claude Codeは、ターミナルで動く「AI相棒」です。コード補完ではなく、プロジェクト全体を理解して自律的にタスクを実行してくれる、頼れるペアプログラミング相手と言えるでしょう。

今日やるならこの順番：

1. インストール（curl -fsSL https://claude.ai/install.sh | bash）
2. claude を起動してログイン
3. .claude/settings.json で .env をブロック
4. /init で CLAUDE.md を作成
5. 1枚Webページを作って成功体験！

ここまでで約30分〜1時間。これでClaude Codeの基本はバッチリです。

最初は「本当にこれでいいの？」と不安になるかもしれませんが、使ってみると手放せなくなります。この記事で紹介した安全設定を最初に入れておけば、安心して試行錯誤できます。

次回の「中級編」では、カスタムコマンド、MCP連携、実務での活用パターンなど、さらに一歩進んだ使い方を解説します。お楽しみに！

参考リンク

• Claude Code公式ドキュメント
• Claude Code GitHub
• Claude料金ページ