メインコンテンツにスキップ

Claude Code ユーザー FAQ

オフィスアワーで最もよく出る質問への簡潔な回答と、詳しく知るためのリンク。最初の数週間でどこにいるかで整理されています。

このガイドの使い方

以下の5つのセクションは、開発者の最初の数週間の流れに沿っています:はじめに、日常的な使用、スキルアップ、よくある落とし穴、プライバシー、信頼。自分の段階に合ったセクションをざっと読むか、特定の質問を検索してください。

1. はじめに

質問

回答

1.1 インストール方法は?

最も簡単:Claude Desktop をダウンロードし、プランでサインインして、「Code」 タブを開きます。Claude Code は組み込まれているため、他にインストールするものはありません。

ターミナル:

macOS/Linux: curl -fsSL https://claude.ai/install.sh | bash
​Windows PowerShell: irm https://claude.ai/install.ps1 | iex
​Homebrew: brew install --cask claude-code
​WinGet: winget install Anthropic.ClaudeCode
その後、任意のリポジトリから claude を実行します。

1.2 インストール済みだが、「claude: command not found」 と表示される

ネイティブインストーラーはバイナリを ~/.local/bin/claude に配置します(Windows:%USERPROFILE%\.local\bin)。そのディレクトリを PATH に追加します。例えば、~/.zshrc または ~/.bashrc に export PATH="$PATH:$HOME/.local/bin" と記述してから、ターミナルを再起動してください。

1.3 ログインが別のマシンのブラウザで開く / SSH を使用している

ログインプロンプトで c を押して認証 URL をコピーします。ローカルブラウザで開き、コードをターミナルに貼り付けます。

1.4 ログイン直後に認証エラーが出るが、アクセス権はある

400 「organization disabled」:迷子の ANTHROPIC_API_KEY 環境変数がログインをオーバーライドしています。設定を解除し、シェルプロファイルから削除して、再起動してください。/status を実行して、どの認証がアクティブかを確認します。
​403 Forbidden:管理者がワークスペースで Claude Code をまだ有効にしていないか、企業プロキシが干渉しています。

1.5 Claude Code は私のプランに含まれていますか?

はい。有料 Claude プランと Console(API)アクセスに含まれています。仕事用アカウントでサインインしてください。SSO は自動的に処理されます。ログイン後の 403 エラーは通常、管理者がまだワークスペースで有効にする必要があることを意味します。


参考:認証

1.6 Claude Code と Claude のチャットの違いは?

Claude Code:リポジトリを読み、ファイルを編集し、コマンドを実行するコーディングエージェント。Claude Desktop の 「Code」 タブであり、ターミナルまたは IDE でも実行されます。
​Claude のチャット(Web、Claude Desktop、またはモバイル):会話と単発の質問用チャット。
同じモデルが基盤ですが、ツールの形状が異なります。


参考:概要

1.7 IDE で動作しますか?

はい。VS Code と JetBrains IDE(IntelliJ、PyCharm など)用の拡張機能が利用可能です。同じ機能ですが、別のターミナルではなくエディターに組み込まれています。


参考:VS Code · JetBrains

1.8 Copilot/Cursor のオートコンプリートとどう違いますか?

オートコンプリートは次の数行を提案します。Claude Code はエージェント:タスク(「失敗したテストを修正する」)を与えると、ファイルを読み、コマンドを実行し、完了するまで複数ファイルの編集を行います。「文を完成させて」というより、「問題があります、対応してください」という感じです。


参考:概要

1.9 最初に何を試すべきですか?

先延ばしにしていた退屈だが難しくないバグに向けてください。例:「[ファイル]のテストが不安定です。理由を調べてください。」 コードを説明する代わりに、コードを読ませてください。

1.10 更新方法は?

ネイティブインストールはバックグラウンドで自動更新されます。今すぐ強制的に更新するには、claude update を実行してください。
Homebrew/WinGet は自動更新されません:定期的に brew upgrade claude-code または winget upgrade Anthropic.ClaudeCode を実行してください。


2. 日常的な使用

質問

回答

2.1 同じコマンドの許可を何度も求められる

承認はデフォルトで現在のセッション中のみ有効です。永続化するには:
• プロンプトで 「常に許可」 を選択
• .claude/settings.json の permissions.allow にパターンを追加
• または /permissions を実行して対話的に管理


参考:権限

2.2 権限モードと切り替え方法

Shift+Tab を押してモードを切り替えます:

  • auto · バックグラウンド安全チェック付きで自動承認します。組織が管理設定で無効にしていない限り、サポートされているモデルで利用可能です。

  • manual · リスクのある編集またはコマンドの前に確認

  • acceptEdits · ファイル編集は実行;コマンド実行前に確認

  • plan · 読み取り専用。プランを提案して承認を待ちます

2.3 /init とは何ですか。いつ実行しますか?

複数回作業するリポジトリで、早期に一度実行します。プロジェクトをスキャンして、ビルドコマンド、アーキテクチャ、規約を含む CLAUDE.md を書き込みます。以降のセッションでは自動的に読み込まれるため、Claude はコンテキストを持った状態で開始します。

2.4 CLAUDE.md には何を入れますか?

ツールが強制できず、新しいチームメンバーが初日に間違える可能性のあることです。例えば 「main ではなく release からデプロイする」、「すべての ID は文字列」、「ルートハンドラーから直接 DB を呼び出さない」 など。2 画面以下に収めてください。長すぎるとスキムされます。

2.5 Claude が CLAUDE.md に従っていません

• 長すぎるか曖昧:実際に重要なルールに絞る
• 散文に埋もれている:重要なルールを上部に配置し、命令形を使う(「X をしない。常に Y をする。」)

2.6 特定のファイルを貼り付けずに指定する

@ の後にパスを入力します(タブ補完対応)。指定されたファイルは Claude が応答する前に読み込まれます。

2.7 プロンプトにスクリーンショットを貼り付ける

ターミナルに画像をドラッグするか、Ctrl+V を押します。Mac では Cmd ではなく Ctrl です(Cmd+V はテキストを貼り付けます)。エラーダイアログ、UI モックアップ、ホワイトボードの写真に対応しています。

2.8 Claude の応答をターミナルからコピーする

/copy は最後の応答をクリップボードに入れます。/export は会話全体をファイルに書き込みます。

2.9 前のセッションを復元する

claude --continue は最新のセッションを再開します。claude --resume はリストを開いて選択できます。セッションはプロジェクトディレクトリごとにローカルに保存されます。

2.10 モデルを切り替える

/model でピッカーを開きます。毎回同じモデルを使いたい場合は .claude/settings.json でデフォルトを設定します。

2.11 拡張思考

デフォルトで有効です。推論自体は通常ビューでは非表示です。詳細なトランスクリプトを読みたい場合は Ctrl+O を押して切り替えます。/effort で深さを調整できます。複雑なデバッグやアーキテクチャの判断には追加のレイテンシーの価値があります。

2.12 途中で停止する

Ctrl+C を押して現在の生成をキャンセルし、代わりに何をするかを指示します。会話を最初からやり直す必要はありません。


3. レベルアップ

質問

回答

3.1 MCP とは何ですか?

MCP は Claude Code を外部ツール(GitHub、Linear、Slack、データベース、オブザーバビリティスタック)に接続します。1 つの .mcp.json 設定で、Claude は問題を読み、データをクエリし、あなたが使うのと同じツールで作業できます。最初のコネクタとしては、イシュートラッカーが一般的です。


参照: MCP

3.2 最初の MCP サーバーをセットアップする

• プロジェクトルートに .mcp.json を追加するか、claude mcp add を使用します
• 各エントリはサーバーパッケージ名と任意の環境変数(通常は認証トークン)を指定します
• Claude Code を再起動して /mcp を実行し、接続を確認します


参照: MCP setup

3.3 フックは何に使いますか?

イベント時に実行されるシェルスクリプト(ツール実行前、ファイル編集後、Claude があなたの入力を待っているとき)。最初のフックとしては、Claude が入力を必要とするときにデスクトップに通知する Notification フックが一般的です。同じメカニズムで、すべての編集後にリンターを実行したり、Slack に投稿したり、保護されたパスへの編集をブロックしたりできます。


参照: Hooks guide

3.4 再利用可能なプロンプト / スキルを作成する

.claude/skills/ship/SKILL.md を作成すると、フォルダ名がコマンドになります:/ship。プレーンな英語で、特別な構文は不要です。最も簡単な方法:Claude に書いてもらう。(レガシーの .claude/commands/ship.md パスも引き続き機能します。)


参照: Skills

3.5 スキル vs. レガシーコマンド

同じメカニズム。コマンドはスキルにマージされました。.claude/commands/foo.md と .claude/skills/foo/SKILL.md の両方が /foo を作成します。スキル形式が推奨され、サポートファイル(参照ドキュメント、テンプレート、ヘルパースクリプト)用のフォルダが提供されます。


参照: Skills

3.6 サブエージェントは何に役立ちますか?

並列作業:コードベースの異なる部分を検索したり、異なる観点から差分をレビューしたり、同時に競合する実装を生成したりします。メインセッションが結果を集約します。

3.7 非対話的に実行する (CI / スクリプト)

claude -p "your prompt" は 1 回実行して結果を出力します。CI フック、プリコミットチェック、または他のツールへのパイプに最適です。ログイン済みセッションまたは ANTHROPIC_API_KEY 経由で認証します。

3.8 実行内容を元に戻す

/rewind は以前のチェックポイントにロールバックします。チェックポイントは送信するプロンプトごとに自動的に作成されます。既にコミットされたものについては、通常の git revert を使用してください。

3.9 セットアップをチームと共有する

.claude/ をリポジトリにチェックインします (CLAUDE.md、コマンド、MCP 設定)。リポジトリをクローンした人は誰でも同じセットアップを自動的に取得します。スキルは プラグイン としてパッケージ化することもでき、チームは /plugin 経由でインストールできます。


4. よくある落とし穴

質問

回答

4.1 ファイルが見つからない / 検索で何も返されない

Claude Code には ripgrep のバンドル版が付属しているため、インストールする必要はありません。バンドル版バイナリは Alpine/musl システムで失敗する可能性があります。その場合はシステムコピーをインストール (apk add ripgrep) して、USE_BUILTIN_RIPGREP=0 を設定し、Claude がそれを使用するようにしてください。

4.2 SSH または tmux でコピー/ペーストとスクロールが機能しない

ターミナル UI はマウスイベントをキャプチャします。選択時に Shift キーを押したままにしてバイパスするか、tmux を設定してマウスイベントをパススルーします。/copy と /export は問題を完全に回避します。

4.3 WSL で遅い

/mnt/c/ 経由で Windows ファイルを読み取ることは既知のペナルティです。リポジトリを WSL ファイルシステム (/mnt/c/... ではなく ~/) に移動してください。速度の差は劇的です。

4.4 Mac で画像ペーストが機能しない

Ctrl+V を使用してください。Cmd+V ではなく。Cmd+V はテキストをペーストします。Ctrl+V はクリップボードからの画像パスです。

4.5 ワイルドカード権限ルールが一致しない

ルールを段階的に構築します: まず対話的にコマンドを承認し、設定に何が書き込まれたかを確認してから、一般化します。

4.6 非対話的な -p モードの動作が異なる

  • OAuth が必要な MCP サーバーは非対話的モードでプロンプトを表示できません

  • 対話的な承認は引き継がれません

非対話的/CI 実行の場合は、API キー認証と環境変数トークンで設定された MCP サーバーを優先してください。

4.7 タスク途中でコンテキストが不足した

/compact は以前の会話を要約してスペースを解放します。/clear は CLAUDE.md と設定を読み込んだまま新規に開始します。長いタスクの場合は、フェーズ間に /clear を使用してステップに分割してください。


5. プライバシーと信頼

質問

回答

5.1 Anthropic は私のコードで学習していますか?

いいえ。組織の Team/Enterprise 利用規約に基づき、コードと会話はモデルの学習に使用されません。ただし、組織が Development Partner Program などを通じてモデル改善のためにデータを提供することを選択した場合を除きます。/feedback でフィードバックを送信した場合、製品とサービスの改善に使用される可能性があります。

5.2 私のコードは実際にどこに行きますか?

Claude Code はマシン上で実行されます。ソースファイルはローカルで読み取られ、現在のタスクに必要な部分のみが API に送信されて応答が生成されます。リポジトリ全体がインデックス化またはアップロードされることはありません。組織がモデル改善のためにデータを提供することを選択した場合を除き、コードは学習に使用されません。/feedback でレポートを送信するか、調査後にセッショントランスクリプトを共有することを選択した場合、その会話 (含まれるコードを含む) は Anthropic に送信されます。

5.3 他の誰かが私の会話を見ることができますか?

チームメンバーは、共有しない限りローカルセッションを開くことはできません。ローカルセッションはマシンに保存され、プロジェクトディレクトリごとに保存されます。会話を共有したい場合は /export を使用してください。会社はセッションを確認できる場合があります。Team 表示に設定されたクラウドセッション、または Slack から開始されたセッションは、組織の他のメンバーに表示される可能性があります。

5.4 シークレットと .env ファイルを会話から除外するにはどうすればよいですか?

Claude はタスクに必要なファイルのみを読み取ります。リポジトリ全体をスキャンしません。特定のファイルをハードブロックするには、.claude/settings.json に Read 拒否ルールを追加します (例: "Read(.env*)")。拒否されたファイルは、誤って要求した場合でも読み取ることはできません。


参照: 権限

5.5 「acceptEdits」 モードは私に尋ねずに何ができますか?

ファイル編集はプロンプトなしで実行されます。シェルコマンドの実行、ネットワーク呼び出し、または作業ディレクトリ外のものへのアクセスの前に確認を求めます。より厳密な制御のため、デフォルトモードのままにしてください。


参照: 権限


付録: まだ困っていますか?

リソース

用途

/help

セッションで利用可能な機能を一覧表示する組み込みコマンド

/feedback

ターミナルから問題を報告します (/bug のエイリアス)

ここにあるすべてを詳細に説明

チームの #claude-code チャネル

小さな成功も奇妙なエラーもそこに属しています


付録: リソースディレクトリ

Claude Code は頻繁に更新されます。内部配布前に、バージョン固有の詳細を code.claude.com/docs で確認してください。

こちらの回答で解決しましたか?