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 を押してモードをサイクルさせます：

参照: パーミッションモード

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ではコマンドキーではなく、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.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/skills/ship/SKILL.mdを作成すると、フォルダ名がコマンドになります：/ship。プレーンな英語で、特別な構文はありません。最も簡単な方法：Claudeに書いてもらいます。（レガシーの.claude/commands/ship.mdパスも引き続き機能します。）

参照: スキル

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 のバンドル版が付属しているため、インストールする必要はありません。バンドル版バイナリは 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/... ではなく ~/）に移動してください。速度の差は劇的です。

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

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

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

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

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

参考: 権限パターン

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

非対話的/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 「acceptEdits」モードは確認なしで何ができますか？

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

参考: 権限

リソース

用途

/help

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

/feedback

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

完全なドキュメント

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

チームの#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