Claude Code ユーザーFAQ

質問

回答

1.1 インストール方法は？

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" と記述してから、ターミナルを再起動します。

参考：トラブルシューティング：PATH

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

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

参考：トラブルシューティング：認証

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

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

参考：トラブルシューティング：認証

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

はい。TeamおよびEnterpriseシート、ならびにConsole（API）アクセスに含まれています。仕事用アカウントでログインしてください。SSOは自動的に処理されます。ログイン後の403エラーは通常、管理者がまだワークスペースに対してこれを有効にする必要があることを意味します。

参考：認証

1.6 Claude Code vs. デスクトップアプリ vs. claude.ai？

Claude Code: リポジトリを読み、ファイルを編集し、コマンドを実行するターミナルエージェント。
​デスクトップ / claude.ai: 会話と単発の質問用のチャットインターフェース。
同じモデルファミリーが基盤にあり、ツールの形状が異なります。

参考：概要

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.1 同じコマンドの許可を何度も求められる

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

参考：権限

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

Shift+Tab を押してモードをサイクルさせます：
• default · リスクのある編集またはコマンドの前に確認
• accept-edits · ファイル編集は実行；コマンド実行前に確認
• plan · 読み取り専用；計画を提案して承認を待つ
• auto（組織で有効な場合） · バックグラウンド安全チェック付きで自動承認

参考：権限モード

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

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

参考：メモリとCLAUDE.md

2.4 CLAUDE.md には何を入れるのか？

ツーリングでは強制できないが、新しいチームメイトが初日に間違える可能性のあること：「main ではなく release からデプロイする」「すべての ID は文字列である」「ルートハンドラーから直接 DB を呼び出さない」。2 画面以下に抑える。長いと流し読みされる。

参考：メモリと CLAUDE.md

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 拡張思考

デフォルトで有効。より難しい質問に対する Claude の推論が表示されます。/effort を使用して深さを上下に調整します。複雑なデバッグやアーキテクチャの判断には、追加のレイテンシーの価値があります。

参考：拡張思考

2.12 途中で停止する

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

質問

回答

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 セットアップ

3.3 フックは何に使うのか？

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

参考：フックガイド

3.4 再利用可能なプロンプト / スラッシュコマンドを作成する

マークダウンファイルを .claude/commands/ に配置します。ファイル名がコマンドになります：.claude/commands/ship.md は /ship になります。プレーンな英語で、特別な構文はありません。最も簡単な方法：Claude に書いてもらうことです。

参考：スラッシュコマンド

3.5 スキルとスラッシュコマンド

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

参考：スキル

3.6 サブエージェントは何に良いのか？

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

参考：サブエージェント

3.7 ヘッドレスで実行する（CI / スクリプト）

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

参考：Unix スタイルの使用

3.8 それが行ったことを元に戻す

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

参考: チェックポイント

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

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

参考: プラグイン

質問

回答

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

Claude Code は内部で ripgrep を使用しています。見つからない場合、検索は低下します。インストールしてください (brew install ripgrep または apt install ripgrep) そして USE_BUILTIN_RIPGREP=0 を設定してシステムコピーを使用してください。

参考: トラブルシューティング: 検索

4.2 SSH または tmux でコピー/ペーストとスクロールが壊れている

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

4.3 WSL で遅い

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

参考: トラブルシューティング: WSL

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.1 Anthropic は私のコードで学習していますか?

いいえ。組織の Team/Enterprise 利用規約に基づき、コードと会話はモデルの学習に使用されません。

参考: データ使用

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

Claude Code はマシン上で実行されます。ソースファイルはローカルで読み取られ、現在のタスクに必要な部分のみが API に送信されて応答が生成されます。何もインデックス化されず、リポジトリ全体としてアップロードされず、学習に使用されません。

参考: データ使用

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

いいえ。セッションはマシン上にプロジェクトディレクトリごとにローカルに保存され、チームメイトと共有されたり、ダッシュボードに表示されたりすることはありません。会話を共有したい場合は /export を使用してください。

参考: データ使用

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

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

参考: 権限

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

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

参考: 権限

リソース

用途

/help

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

/bug

ターミナルからイシューをファイルする（/feedback のエイリアス）

完全なドキュメント

ここにあるすべてのもの、詳細に

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

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

ページ

リンク

クイックスタート

code.claude.com/docs/en/quickstart

トラブルシューティング

code.claude.com/docs/en/troubleshooting

権限

code.claude.com/docs/en/permissions

メモリと CLAUDE.md

code.claude.com/docs/en/memory

MCP

code.claude.com/docs/en/mcp

データ使用

code.claude.com/docs/en/data-usage