Xcode 26.3でClaude Agentがプロジェクトを認識しない？2026年修正ガイド

AppleのXcode 26.3リリースノートは、デスクトップ、ダウンロード、書類という3つの保護対象フォルダへのアクセスを拒否すると、Claude Agentが再度アクセスを要求できない問題を記載しています。該当するリリースノートに沿って、まずプロジェクトの場所と拒否履歴を確認してください。該当する権限項目がシステム設定にあればそこで許可し、項目がなければプロジェクトを保護対象外へ移して再確認するのが先です。

この記事は、リモートMacのXcode 26.3でClaude Agentを初めて使い、現在のプロジェクトを読めない開発者向けです。
開発環境を管理する担当者が、権限を広げずに原因を切り分けたい場合にも役立ちます。

「プロジェクトが見えない」という状態だけでは、原因を決められません。Agentが表示されない、会話はできるがファイルを読めない、コードは読めるがXcodeのビルドやテストを呼び出せない、という違いを先に記録します。

同じプロジェクト内にある、機密情報を含まない通常のソースファイルを一つ指定して読み取りを試します。これで失敗するなら、まずファイルの場所とアクセス権を確認します。読み取りが成功してXcode操作だけ失敗するなら、ディレクトリ権限の変更ではなく、Xcode IntelligenceやAgentの設定を調べます。

最初に残しておく項目は次のとおりです。

• [ ] Xcode内でClaude Agentが表示され、会話できるか
• [ ] 現在開いているワークスペースのパスはどこか
• [ ] 読み取りテストに使ったファイルと、結果は何か
• [ ] 失敗した操作は、ファイル読み取りかXcodeツールの呼び出しか
• [ ] アクセスを求められた際に、過去に拒否した記憶があるか

この記録があれば、同じ権限変更を繰り返したり、Agentを入れ替えたりする前に、どの段階で止まったのかを比較できます。

プロジェクトがデスクトップ、ダウンロード、書類のいずれかにある場合は、まずアクセス許可を確認します。Appleの説明では、macOSはファイルやフォルダへのアクセスをアプリごとに管理しています。ファイルとフォルダへのアクセス権の管理手順を参照し、システム設定の「プライバシーとセキュリティ」内に、Xcodeまたは対象のアクセス項目があるか確認してください。

該当項目が表示されている場合は、対象範囲を確認してから必要な許可だけを有効にします。項目が見当たらない場合、Xcode 26.3の既知の問題では、拒否後に再要求できないケースが記載されています。ホームフォルダ全体を許可して回避しようとせず、プロジェクトをデスクトップ、ダウンロード、書類以外の場所へ移し、移動先から開き直してください。

アクセス権の変更は、問題が起きた対象に限ってください。無関係なリポジトリやホームフォルダ全体を許可すると、今回の原因が解決したか判別しにくくなり、不要なアクセス範囲も増えます。

移動後は、古いXcodeウインドウを使い続けず、移動先のプロジェクトまたはワークスペースを開き直します。Finderなどで確認した実際のパスと、Xcodeで開いている場所が一致しているかも照合してください。プロジェクトだけ移しても、以前のワークスペースや別のコピーを開いていれば、Agentから見える対象は変わりません。

次の対照表で、症状と変更する設定を対応させます。複数の問題を一度に修正せず、該当する行の確認後に同じテストを再実行してください。

XcodeのAgent機能自体が利用できない場合は、AppleのCoding Intelligence設定手順で選択中の機能と設定を確認します。Claudeのログインや利用資格は、プロジェクトのファイル権限とは別の項目です。ClaudeをXcodeで使うための案内で、現行のアカウント要件や利用条件を照合してください。資格やログインの問題を、プロジェクト移動で解消しようとしても改善しません。

確認は次の順に進めます。各段階で結果を残しておけば、変更を戻す場合や別の担当者へ引き継ぐ場合にも、再現条件を保てます。

1. 症状と対象パスを記録します。 Claude Agentが表示されるか、会話できるか、どのファイルで読み取りに失敗するかを書き留めます。現在Xcodeで開いているワークスペースの場所も記録してください。
2. Agent機能とアカウントを別々に確認します。 XcodeのCoding Intelligence設定とClaudeのログイン状態を確認し、必要な利用資格については公式案内を参照します。設定変更後もファイル読み取りの結果を別に記録します。
3. 同じプロジェクト内の通常ファイルを読ませます。 最初は変更を伴わないファイルを使い、Agentが内容を取得できるか確認します。読めなければ、ビルド設定の変更に進まず、パスとフォルダ権限に戻ります。
4. 対象が保護フォルダにあるか確認します。 デスクトップ、ダウンロード、書類に該当し、以前アクセスを拒否した可能性があるなら、システム設定に対応する項目があるか調べます。項目がなければ、対象プロジェクトだけを保護対象外へ移します。
5. 移動先からワークスペースを開き直します。 移動後のパスとXcodeの表示を照合し、読み取りテストを繰り返します。許可を追加した場合は、どの項目を変更したのかも記録します。
6. ファイル編集とXcode操作を順番に試します。 まず機密情報を含まないテスト用コピーへの限定的な変更を確認し、その後、影響を把握できる範囲でビルドやテストなどのXcode操作を試します。作業前の状態と変更後の差を確認できるようにしてください。
7. まだ失敗する場合は、失敗段階から分岐します。 読み取りに失敗するならパスとアクセス権、ツール呼び出しだけ失敗するならXcode IntelligenceまたはAgent接続、Agentが使えないならログインや資格を再確認します。すぐに再インストールしたり、権限を大きく広げたりする必要はありません。

Xcode内のClaude Agentを利用しているのか、外部のClaude CodeをMCP経由でXcodeに接続しているのかを区別してください。外部Agentは接続先や許可するツールの構成が加わるため、コードを読み取れるかどうかと、Xcodeの操作を実行できるかどうかが別々に失敗することがあります。

外部Agentを使っている場合は、Appleの外部Agent接続手順で接続方法を確認します。Agentの許可や環境をカスタマイズしている場合は、Agentの拡張とカスタマイズに関する説明も参照してください。これらは、Xcode内蔵Agentのフォルダ権限を直す手順の代わりではありません。

リモートMac開発環境では、SSHでファイルにアクセスできることと、画面上で操作するXcodeやClaude Agentが同じプロジェクトを参照していることも、分けて確認する必要があります。SSHで見えるパスと、Xcodeのワークスペースのパスが異なるなら、まず開いているプロジェクトを合わせてから再検証します。テストでは機密情報を含まないプロジェクトを使い、アクセス範囲を限定してください。

Xcode 26.3でClaude Agentがプロジェクトファイルを読めない場合、最初に何をしますか？
Agentが起動しているか、会話できるか、ファイルだけ読めないのかを切り分けます。次に、同じプロジェクト内の通常ファイルを指定して読み取りを試し、プロジェクトのパスと拒否履歴を確認します。読み取りの段階で失敗する場合は、Xcodeツールの設定より先にフォルダへのアクセスを調べてください。

書類へのアクセスを拒否した後、どうすれば再び許可できますか？
システム設定の「プライバシーとセキュリティ」で、該当するファイルとフォルダのアクセス項目が存在するか確認します。項目があれば対象の許可を見直します。項目が表示されない場合は、Xcode 26.3のリリースノートが説明する問題に該当する可能性があるため、プロジェクトを保護対象外へ移し、移動先から開き直して読み取りを試します。

プロジェクトをデスクトップから移動しても見えないときはどうしますか？
移動したファイルとXcodeで開いているワークスペースが同じ場所を指しているか確認します。以前のウインドウ、古いブックマーク、別のコピーを使っていると、移動後も同じ失敗に見えることがあります。移動先から開き直したうえで、テスト用の通常ファイルだけを再度読み取らせてください。

コードは読めるのに、Claude AgentがXcodeのビルドやテストを使えない原因は何ですか？
ファイルアクセスが成功しても、Xcodeツールの呼び出しまで有効とは限りません。内蔵AgentならCoding Intelligenceの選択と設定を確認し、外部Agentなら接続や許可するツールの構成を別に調べます。どちらの場合も、アカウントのログインや利用資格は、フォルダ権限とは切り分けて確認します。

プロジェクトの読み取りだけなら、現在の端末にある環境を維持する方法が最も単純な場合もあります。ただし、手元のMacを開発作業で占有すること、macOS専用ツールを使えないLinux環境では代替しにくいこと、仮想環境では実機のXcode操作と条件が異なることは考慮が必要です。まず機密情報を含まないテスト用プロジェクトで、リモートの画面セッションとファイルアクセスが必要な範囲で動くか確かめてください。継続してXcodeを使うmacOS環境が必要で、実機の接続やローカル常時稼働が必須でない場合は、JEXCLOUDのリモートMac環境を選択肢として比較できます。日本向けの利用条件を先に確認したい場合は、日本向けリモートMacの案内も参照できます。専用の実機や物理インターフェースが必要な運用では、手元のMacを使う方が適しています。