AI AGENT FACTORYAIエージェント工場見学 ACTIVE

ChatGPTのノリでClaude Codeを使うと詰む——初心者が最初に直すべき「作業するAI」という前提

Claude Codeをインストールして、とりあえず話しかけてみたけれど「何が起きたのかよくわからなかった」——そう感じる初日を経験する初心者は少なくない。tech-lab.sios.jp が公開した記事(Claude Codeの使い方|初心者に僕が最初に伝える、たった一つのこと、2026/03/16)では、「どこから手をつけるか迷ったとき」という状態が初心者の典型として紹介されている。ChatGPTと同じように入力しても、Claude Codeが「動いている感じ」がしない。その原因は手順のミスではなく、「Claude Codeはチャットで回答を生成するツールではなく、ファイルとターミナルを直接操作するツールだ」という前提の違いにある。この記事は、その一点を最初に知ることで、初日のつまずきをゼロにすることを目的とする。


仕組みの全体像(図解)

flowchart TD
    A[指示を入力] --> B{ツールの種類}
    B -->|ChatGPT| C[テキストで回答を生成]
    C --> D[人間が手動でファイルへ適用]
    B -->|Claude Code| E[ファイルを読み込む]
    E --> F[ファイルを直接書き換え]
    F --> G[コマンドも自動実行]
    G --> H[変更が即反映]

上の図が示すのは、ChatGPTとClaude Codeの「出力の向き先」の違いだ。ChatGPTは人間へのテキスト出力が終点であるのに対し、Claude Codeはファイルシステムとターミナルへの直接操作が終点となる。「回答を受け取って自分で適用する」のではなく、「AIが手を動かして、自分はレビューをする」という役割分担に変わる。


Claude Codeは「作業するAI」—— ChatGPTと何が違うか

ChatGPTは「答えを言葉で返すAI」だ。プログラミングについて聞けばコードをテキストで出力してくれる。ただしそのコードをファイルに貼り付けて実行するのは、あくまで自分の作業になる。

Claude Codeは根本的に違う。Anthropicが開発したCLI(コマンドラインインターフェース)ツールであり、起動するとターミナル上でAIが対話しながら作業を進める。具体的には次のことが起きる。

  • ファイルを直接読む・書く: 「このファイルのバグを直して」と指示すると、AIがファイルを開いて内容を確認し、コードを書き換えて保存する
  • コマンドを実行する: テストの実行、パッケージのインストール、gitコミットなどをAIが代わりに実行できる
  • プロジェクト全体を把握する: 複数ファイルにまたがる変更も、コンテキストを保持しながら一括処理する

ChatGPTを使うときの感覚は「検索エンジンに聞いてメモアプリに貼り付ける」に近い。Claude Codeを使うときの感覚は「ペアプログラマーに隣に座ってもらって一緒にコードを書く」に近い。この違いを最初に理解していないと、初日は「何もしてくれない」と感じやすくなる。


初日に「動いた気がしない」と感じる3つの理由

tech-lab.sios.jp の記事(Claude Codeの使い方|初心者に僕が最初に伝える、たった一つのこと、2026/03/16)では、「どこから手をつけるか迷ったとき」という問いが初心者への最初の問いかけとして示されている。この「迷い」の背景には、3つの前提のギャップがある。

理由1:「入力する場所」がターミナルしかない

ChatGPTはブラウザで開けば入力ボックスがある。Claude Codeはターミナルを自分で開いて、プロジェクトフォルダに移動して、コマンドを打ってはじめて起動する。ターミナルに慣れていない人にとって、この「入口を自分で用意する」という工程自体が最初の壁になりやすい。

理由2:「出力」がテキストではなくファイルの変化

Claude Codeが正しく動くと、ファイルの中身が変わる。しかし「変わった」ことに気づくためにはファイルを開いて確認する必要があり、ChatGPTのようにスクリーン上に答えが出てこないため「何もしていない」と見える瞬間がある。作業が見えにくいことが「動いている感じがしない」という感覚を生む。

理由3:「作業する対象」がないと詰まる

Claude Codeは「作業する対象」が必要なAIだ。空のフォルダで起動しても、ファイルを操作する対象がないため何もできない。ChatGPTのように「何でも聞ける」という使い方には向かない。「このプロジェクトを〇〇してほしい」という具体的な対象があって初めて力を発揮する。


まずここだけ:インストールと最初の「動いた」体験

インストールは5分で終わる。「ターミナルを開ける・コマンドを1行打てる」だけで十分だ。網羅的な手順を探したい場合は aquallc.jp(Claude Code 初心者完全ガイド【2026年最新】、2026/02/19)が体系的にまとめているが、まず「動いた」体験を得るためには以下の最小手順で十分だ。

前提条件

  • Node.js 18以上がインストール済みであること(確認: ターミナルで node -v と打って番号が表示されればOK)
  • Anthropicのアカウント作成済みであること(claude.ai でサインアップ)

手順

1. ターミナルでインストールする

-g をつけることでシステム全体にインストールされ、どのフォルダからでも claude コマンドが使えるようになる。

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

2. 作業したいプロジェクトフォルダへ移動する

Claude Codeはフォルダの中にあるファイルを対象に動くため、先に「作業の舞台」を指定する必要がある。まだプロジェクトがない場合は新しいフォルダを作って移動する。

mkdir my-first-project && cd my-first-project

3. Claude Codeを起動する

claude

初回はブラウザでのログイン認証が求められるので、そのまま進む。

4. 最初の指示を入力して「動いた」を確認する

抽象的な質問ではなく具体的な作業指示を与えると、ファイルに変化が起きて「動いている」と実感できる。

hello.txt というファイルを作成して、「はじめてのClaude Code」と書いてください

AIが変更の確認を求めてきたら y と入力して承認する。hello.txt が生成されれば成功だ。

ターミナルの入力を使いやすくする設定

長い指示を書くとき、Enterを押すと送信されてしまうため改行を入れにくい。zenn.dev AWS Japan(初心者が爆速でClaude Codeを習得する10のステップ、2025/12/02)では、Claude Code内で以下のコマンドを実行すると Shift+Enter で改行できるようになると記されている。

/terminal-setup

長いプロンプトを書く際の操作性が大きく向上するため、起動後すぐに設定しておく価値がある。


詰まったときに試す問いかけの型

Claude Codeで「何をすればよいかわからない」と感じたとき、ChatGPT的な使い方(「何か面白いことを教えて」)ではなく、状況整理を依頼する問いかけが有効だ。

tech-lab.sios.jp(Claude Codeの使い方、2026/03/16)では、初心者が最初に問いかける3つの質問パターンが紹介されており、「どこから手をつけるか迷ったとき」「全体像を把握したいとき」への対処として示されている。この考え方を参考にすると、以下のような問いかけが有効だと読み取れる。

状況を整理させる問いかけ(推奨)

あなたは今このディレクトリで何ができますか?ファイル構成を確認して、できることを教えてください。

この問いかけには2つの効果がある。AIがフォルダの中身を読んで現状を説明することで全体像が把握でき、同時にAIが作業可能な範囲を示してくれるため次の指示を具体的に出せるようになる。

段階を区切る問いかけ(推奨)

一度に大きな指示を出すより、一歩ずつ確認しながら進む方がトラブルが少ない。

まず現状のコードの問題点だけを説明してください。修正はまだしないでください。

内容を確認してから:

では、先ほど説明した問題のうち、〇〇だけを直してください。

避けた方がよい問いかけ

このプロジェクトを完成させてください。

Claude Codeは能力が高いが、曖昧で大きな指示は想定外の変更を生むことがある。小さく区切って、変更のたびにファイルを確認する習慣を早めに身につける方が安全だ。


料金のリアル—— どこから課金が始まるか

Claude Codeの利用料金はAnthropicの利用プランに紐づく。2026年7月時点での一般的な構造は以下の通りだが、プランの詳細や最新料金はAnthropic公式サイト(claude.ai/pricing)で必ず確認すること。

Claude Proサブスクリプション: 月額固定料金で一定量のClaude Code利用が含まれる。個人の学習・副業用途では多くの場合このプランから始める形になる。ただし使用量が多い場合は上限に達することがある。

Anthropic API経由(従量課金): トークン量に応じた課金。自動化や大量処理には向いているが、使いすぎると予想外のコストになる可能性がある。上限アラートの設定を忘れずに。

料金・プランの詳細な比較は、aquallc.jp(Claude Code 初心者完全ガイド【2026年最新】、2026/02/19)が体系的にまとめているため、プラン選択で迷う場合は参照するとよい。


よくあるエラーと対処

エラー1: claude: command not found

インストール後にターミナルを再起動していない、またはnpmのグローバルパスが通っていない場合に発生する。

対処:

  • ターミナルを一度閉じて再度開く
  • それでも解決しない場合: npm root -g を実行してパスを確認し、シェルの設定ファイル(.zshrc.bashrc)にPATHを追加する

エラー2: ログイン・認証エラー

対処:

  • ブラウザでclaude.aiにログインしてからターミナルに戻る
  • Anthropicアカウントのサブスクリプション状態を確認する(未契約だと認証が通らない場合がある)

エラー3: 「このファイルを変更してもよいですか?」への戸惑い

Claude Codeはファイルを変更する前に確認を求めることがある。これは誤操作を防ぐための設計だ。内容を確認して問題なければ y(yes)、やめたい場合は n(no)と入力する。

エラー4: /terminal-setup を実行したが変化しない

シェルの種類(bash/zsh/fish)によって設定方法が異なる場合がある。zenn.dev AWS Japan(初心者が爆速でClaude Codeを習得する10のステップ、2025/12/02)では設定方法の詳細が記されているため、自分のシェル環境と照らし合わせて確認するとよい。

エラー5: npm install でエラーが出る

Node.jsがインストールされていない可能性がある。node -v を実行してバージョン番号が出なければ、Node.js公式サイト(nodejs.org)からインストールする。バージョンは18以上が必要だ。


よくある誤解Q&A

Q: Claude Codeはコードを書けない人でも使えますか?

A: 使える。ファイルの作成・文章の整理・マークダウン変換など、プログラミング以外の作業にも使える。ただし「プロジェクトフォルダ」という概念と「ターミナルでコマンドを打つ」という操作は必要になる。この2点がどうしてもハードルになる場合は、先にターミナルの基本操作だけ学んでから戻ってくると始めやすい。

Q: ChatGPTで慣れているので、まず質問から始めてもよいですか?

A: 質問はできる。ただし「何を作りたいか」「どんなファイルがあるか」が具体的であるほど的確な作業が始まる。「何か教えて」より「このフォルダのREADMEを書いて」の方が動作が明確になる。

Q: AIがファイルを変更するのが怖い。元に戻せますか?

A: gitを使っているプロジェクトならば、git diff で変更内容を確認し、問題があれば git checkout . で元に戻せる。Claude Codeを使い始めるときにgitリポジトリを初期化しておく(git initgit add .git commit -m "initial")ことを強く推奨する。

Q: Claude Codeと普通のClaude(claude.ai)は何が違うのですか?

A: claude.aiはブラウザで使うチャットUI。Claude Codeはターミナルで動くCLIツール。どちらも同じAIモデルを使っているが、Claude Codeはファイルシステムへのアクセス権を持っている点が根本的に異なる。「見て答える」のがclaude.ai、「見て直接触る」のがClaude Codeだ。

Q: 英語のUIが出てきたが日本語で使えますか?

A: 日本語で指示を送れば日本語で回答・作業してくれる。UIのターミナル表示は英語が多いが、入力と出力は日本語で問題ない。


次のステップ:CLAUDE.mdとPlan Modeへ進む前に知ること

初日の「動いた」体験が得られたら、次は2つの機能が視野に入る。

CLAUDE.md: プロジェクトのルールや背景情報をAIへの事前説明としてファイルに書いておく仕組み。「このプロジェクトはNext.js製です」「コードコメントは日本語で書いてください」といった指示を毎回入力しなくて済むようになる。プロジェクトルートに CLAUDE.md というファイルを置くだけで自動的に読み込まれる。

Plan Mode: 大きな変更を加える前に、AIが「何をどの順番でやるか」を先に提示してユーザーが確認してから実行するモード。ファイルを大量に変更するような作業では安全性が大きく高まる。

これらの詳細については、qiita.com(【Claude Code入門】今から追いつくClaude Code 徹底解説、2026/04/27)がCLAUDE.md・Plan Mode・Skill・Hooksまで網羅的に解説しているため、次の一歩として参照を推奨する。いきなり全部を覚えようとせず、まずは「動かせた」状態を数日キープしてから発展機能に進む方が定着しやすい。


まとめ(次の一歩)

Claude Codeが「動いた気がしない」理由のほとんどは、「チャットで答えを受け取る」というChatGPTの使い方のモデルをそのまま持ち込んでいることにある。Claude Codeは「作業する」AIであり、ファイルシステムを直接書き換え、コマンドを実行する。その前提を一点切り替えるだけで、初日の体験は大きく変わる。

今日試す最小ステップ:

  1. npm install -g @anthropic-ai/claude-code でインストール
  2. 任意のフォルダで claude を起動
  3. 「hello.txt というファイルを作って『はじめてのClaude Code』と書いてください」と入力
  4. ファイルが生成されたことをファイルエクスプローラー(またはlsコマンド)で確認

この4ステップで「Claude Codeが動いた」体験が得られる。詰まったら「あなたはこのディレクトリで何ができますか?」と問いかけることを起点にするとよい。次の段階としてCLAUDE.mdの設定に進むと、毎回の説明なしにAIがプロジェクトの文脈を把握してくれるようになる。

← 攻略ガイド一覧へ

最新の実験ログ