Claude Codeがうまく動かないときに見る8箇所

1. インストールは成功したのにコマンドが見つからない

インストール自体は終わったのに、ターミナルで実行しようとすると「コマンドが見つかりません」と返ってくる状態です。ここで「インストールに失敗した」と判断して入れ直す人が多いのですが、たいていは入っています。

原因は、実行ファイルの置き場所がターミナルの検索対象に入っていないことです。ターミナルは決められた場所しか探しに行かないので、そこに含まれていないと存在していても見つかりません。ターミナルを一度閉じて開き直すと直ることが多いのは、この検索対象が起動時に読み込まれるためです。

開き直しても変わらない場合は、権限の問題であることが多いです。とくに会社から貸与されたパソコンでは、書き込みが許可されていない場所にインストールしようとして途中で止まり、エラーが出ないまま中途半端な状態になっていることがあります。この場合は個人の領域にインストールし直すのが確実です。

2. どのフォルダで起動したかを意識していない

いちばん多い詰まりがこれです。Claude Codeは「起動したフォルダの中」を作業範囲として扱います。つまり、どこで起動したかで、見えるファイルが変わります。

整理してほしいフォルダとは別の場所で起動していると、「そのファイルは見つかりません」と返ってきます。逆に、パソコンの一番上の階層で起動してしまうと、対象が広すぎて的外れな動きになります。デスクトップにあるファイルを扱いたいならデスクトップで、特定の案件のフォルダを扱いたいならそのフォルダで起動する、と考えてください。

最初のうちは、作業対象のフォルダを1つ作り、その中にファイルを入れてから起動する運用をおすすめします。範囲がはっきりしていれば、意図しないファイルを触られる心配もありません。何ができるか自体を掴みたい場合は、自分の業務内容を伝えて候補を出させるところから始めると早いです。

3. 確認を求められるたびに手が止まる

ファイルを書き換える前や、コマンドを実行する前に、実行してよいか確認が入ります。ここで毎回止まってしまい「自動でやってくれないじゃないか」と感じる人がいます。

これは安全のための仕組みです。とくに削除や上書きは元に戻せないので、確認が入るのは正しい動きです。ただ、同じ種類の作業を何十回も繰り返す場面では確認が邪魔になります。その場合は、許可の範囲をあらかじめ設定しておけば、毎回聞かれなくなります。

注意したいのは逆方向の失敗です。面倒になって何でも許可する設定にしてしまうと、意図しない削除が起きたときに気づけません。おすすめは、対象フォルダのコピーを取ったうえで許可範囲を広げることです。バックアップさえあれば、思い切って任せられます。

4. 毎回同じ前提を説明している

「うちの会社では請求書はこの形式」「日付は必ずこの書き方」といった前提を、依頼のたびに書いている状態です。動いてはいるので問題に見えにくいのですが、これは設定で解決できます。

作業フォルダに決まった名前のメモファイルを置いておくと、起動のたびに自動で読み込まれます。ここに、守ってほしい形式・使ってほしい言い回し・触ってはいけないファイルなどを書いておけば、毎回説明する必要がなくなります。

最初から完璧に書こうとしなくて構いません。実際に使っていて「今の指示は毎回言っているな」と気づいたものを、その都度1行ずつ足していくのが続けやすい方法です。逆に、使ってもいない決まりごとを大量に書くと、かえって指示がぶれます。

5. 同じ作業を毎回ゼロから頼んでいる

前提の共有ができても、手順そのものを毎回説明しているなら、まだ半分です。月次の経費集計や週報のように繰り返す作業は、手順書ごと覚えさせられます。これがスキルという仕組みです。

やることは、手順を書いたテキストファイルを決まった場所に置くだけで、プログラムを書く必要はありません。以降は「週報を作って」の一言で、毎回同じ手順が同じ品質で実行されます。プロンプトを探して貼り付ける手間そのものがなくなります。

使い分けは単純です。一度きりの作業ならプロンプト、月に何度も繰り返す作業ならスキルです。判断に迷ったら、その作業を3か月以内にまたやるかどうかで決めてください。

6. 外部サービスとの連携がつながらない

検索や外部データの取得を追加する仕組み（MCP）は便利ですが、設定でつまずきやすい部分でもあります。症状は「設定ファイルは書いたのに、起動しても認識されない」という形で出ます。

よくある原因は3つです。1つ目は、設定ファイルの書き方がWindowsとMacで違うこと。同じ設定をそのまま持ち込むと、片方では動いて片方では動きません。2つ目は、鍵となる文字列を設定ファイルに直接書かず環境変数から読ませている場合に、その環境変数を登録し忘れていることです。未登録のまま起動すると、設定の読み込み自体に失敗します。

3つ目は接続の遮断です。会社のネットワークや、社内から外部への通信を制限している環境では、設定が正しくても外部サービスに届きません。この場合、手元では動かないという結論になるので、別の実行場所を用意するか、その機能を使わない前提に切り替える判断が必要になります。ここは症状が「なぜか動かない」としか見えないため、独力では原因にたどり着きにくい箇所です。

7. 長い作業の途中から話が噛み合わなくなる

作業を続けていると、最初のほうに伝えた条件を無視した回答が返ってくるようになることがあります。品質が落ちたように見えますが、原因は一度に扱える会話量の上限です。

古いやり取りは順に押し出されていくので、序盤に伝えた前提ほど失われやすくなります。対策は2つで、区切りのよいところで会話をいったん切ってやり直すことと、守ってほしい条件を会話ではなくファイル（4の節のメモファイル）に書いておくことです。ファイルに書いた内容は毎回読み込まれるので、会話が長くなっても消えません。

また、1つの会話で複数の目的を混ぜないほうが安定します。ファイル整理を頼んだ流れで文章の下書きも頼む、といった使い方をすると、途中の指示が互いに干渉します。目的が変わったら会話を分けてください。

8. 出てきた結果をそのまま信じている

最後は設定ではなく運用の話です。動くようになったあとに起きる失敗として、こちらのほうが実害が大きくなります。

領収書の読み取りや音声の書き起こしは実用的な精度が出ますが、金額や固有名詞を誤ることがあります。合計金額だけでも人が突き合わせる運用にしておけば、間違いはその場で見つかります。ファイルの一括変更も同様で、実行前に「何をどう変えるか」を説明させてから進めると、意図と違う場合に止められます。

会社のファイルを扱う場合は、社内の生成AI利用ルールを先に確認してください。判断がつかない場合は、個人名や取引先名を伏せた状態で試す方法があります。ここを飛ばして進めると、うまくいったときほど後戻りが大変になります。

それでも解決しないとき

ここまでの8箇所は、症状と原因が対応しているので、当てはまるものがあれば自力で直せます。実際、多くはこの範囲で片付きます。

一方で、独力では時間がかかりやすいのが次の3つです。1つ目は環境そのものが原因のケース（会社のパソコン、権限の制限、社内ネットワークからの接続遮断）で、手順どおりにやっても動かないため、何が原因かの切り分けから必要になります。2つ目は「動いてはいるが自分の業務に合った使い方が分からない」ケースで、これは正解が人によって違うので、記事を読んでも解決しません。3つ目は、4と5で触れた設定ファイルやスキルを、自分の業務に合わせて実際に作るところです。仕組み自体は単純でも、何を書くべきかは業務を知らないと決まりません。

この3つに当てはまる場合は、画面を見ながら一緒に切り分けたほうが早いです。下の枠は、それを個別に請けているサービスです（有料）。上の8箇所で解決した場合は不要なので、まずは順に確認してみてください。

よくある質問

インストールし直せば直りますか？

入れ直しで直るのは、インストールが途中で止まっていた場合だけです。コマンドが見つからない、指示が通らない、といった症状の多くは設定と使い方が原因なので、入れ直しても同じことが起きます。まず1と2の節を確認してください。

毎回確認を求められるのを止められますか？

許可の範囲をあらかじめ設定しておけば、毎回聞かれなくなります。ただし、何でも許可する設定にすると意図しない削除に気づけなくなるので、対象フォルダのコピーを取ってから広げてください。

会社のパソコンでも使えますか？

使える場合と使えない場合があります。書き込み権限が制限されていてインストールが完了しない、社内ネットワークから外部への通信が遮断されて外部サービス連携が動かない、といった制約が出ることがあります。あわせて、社内の生成AI利用ルールを先に確認してください。

途中から指示を無視されるのはなぜですか？

一度に扱える会話量に上限があり、古いやり取りから順に失われるためです。守ってほしい条件は会話ではなく設定ファイルに書いておくと、会話が長くなっても保たれます。区切りのよいところで会話を切り直すのも有効です。

プログラミングの知識は必要ですか？

必要ありません。ただし、作業フォルダの考え方（2の節）だけは避けて通れないので、そこだけは押さえてください。ここを理解しないまま使うと、指示が通らない原因がずっと分からないままになります。

関連する解説ガイド

• Claude Codeでできること（非エンジニア向け）：コードを書かない人がClaude Codeで実際に片付けられる作業を、ファイル整理・データ処理・書類作成の順に具体例で紹介します。