「Permission denied」と表示されて何もできなくなったあなたへ
ClaudeCodeで作業中、突然「Permission denied」とか「EACCES: permission denied」というメッセージが出て、それ以上進めなくなってしまった経験はありませんか。「自分のPCなのに、なぜ拒否されるの?」「権限を変えたら壊れそうで怖い」「sudoって使っていいのか分からない」と戸惑う気持ち、よく分かります。実はこの権限エラーは、ClaudeCodeを業務で使う人がほぼ全員、一度は経験する定番のトラブルです。原因は意外にシンプルで、「あなたが書こうとしているフォルダやファイルが、別のユーザーやシステムのものになっている」というだけのこと。正しい手順を知っていれば、PCを壊すことなく、安全に解決できます。この記事では、権限の仕組みからはじめて、安全な対処法、危険なやり方、そして社内利用での注意点まで、非エンジニアの方が迷わず動けるよう順を追って解説します。
結論ファースト:今すぐ試すべき手順サマリー
「Permission denied」が出たら、まずは「どのファイルやフォルダに対して拒否されたのか」をエラーメッセージから読み取ります。続いて、以下の順に対処してください。最初は「ClaudeCodeを起動した場所を変える」こと。たとえばデスクトップやドキュメントフォルダなど、自分が自由に書き込める場所で作業しているか確認します。システム領域(/usr/やC:\Program Filesなど)で作業しようとすると、ほぼ必ず権限エラーが出ます。次に、ClaudeCode内で/permissionsコマンドを使って、現在の権限設定を確認します。ファイル編集が許可されているか、特定のフォルダがブロックされていないかをチェックできます。それでもダメなら、ファイル自体の権限をchmodコマンドで調整します。ただし、ここでsudoを使うのは最終手段にしてください。安易にsudoを使うと、後から自分でも編集できないファイルになったり、システム全体に影響が出たりすることがあります。最後に、Windowsの場合は「管理者として実行」ではなく、まず通常権限で動かすことを優先してください。原則として「権限は最小限に」「いきなりシステム領域を触らない」「sudoは慎重に」の3つを守れば、安全に対処できます。
なぜ「Permission denied」は起きるのか
「権限」は、コンピュータの世界で「誰が、どのファイルに、何をしていいか」を決めているルールです。たとえばあなたが家を建てるとき、「リビングは家族全員が使える」「金庫の中は親だけが開けられる」「子供部屋は子供だけが入れる」というように、場所ごとに使える人を決めるのと似ています。コンピュータも同じで、システム全体に関わる重要なファイルは「管理者だけが触れる」、ユーザーごとの個人ファイルは「そのユーザーだけが書き換えられる」というふうに区分けされています。
ClaudeCodeが「Permission denied」を出すのは、あなたが書き換えようとしている場所が「あなたのもの」ではないと判断されたときです。具体的にはこんなケースがあります。1つ目は「システム領域への書き込み」。/usr/、/etc/、C:\Program Filesなどは管理者専用で、通常ユーザーは触れません。2つ目は「他のユーザーのファイル」。同じPCを家族や同僚と共有していて、別のアカウントが作ったファイルを編集しようとした場合です。3つ目は「グループ権限の不足」。社内サーバーの共有フォルダで、自分が属していないグループのファイルにアクセスしようとした場合です。4つ目は「ClaudeCode自体の権限設定」。ClaudeCodeには「どのフォルダを読み書きしていいか」の安全装置があり、明示的に許可していないとブロックされます。5つ目は「macOSのフルディスクアクセス」。Mac特有の機能で、特定のフォルダ(ドキュメント、デスクトップなど)へのアクセスにはアプリごとの明示的な許可が必要です。
これらは「壊れた」のではなく、「コンピュータが正しくセキュリティを守っている」証拠でもあります。慌てずに、どの種類の権限エラーなのかを見極めて対処しましょう。
エラーメッセージの種類と読み方
権限エラーにはいくつか表現パターンがあります。Permission deniedは最も一般的な英語表記で、「アクセス拒否」を意味します。EACCES: permission denied, open '/path/to/file'はNode.js系のエラーで、「openという操作が拒否された、対象は/path/to/file」と読みます。括弧内のパスがどのファイルでエラーが起きたかを示すので、ここを必ず確認しましょう。Operation not permittedは「その操作は許可されていません」で、より厳しめの拒否です。Access is denied.はWindowsでよく見るメッセージ。You don't have permission to save in this location.はmacOSのアプリで出るメッセージで、保存先のフォルダに書き込み権限がないことを意味します。
エラーが出たら、まず「どのファイル/フォルダで起きたか」を特定するのが第一歩です。パスに/usr/や/System/が含まれていればシステム領域、/Users/他人の名前/なら他ユーザーのファイル、/Users/自分の名前/Desktop/なら自分のフォルダ内のはずなので別の原因(macOSの保護設定など)を疑います。
対処法1:作業場所を見直す
最も安全で効果的な対処は、そもそも権限エラーの出ない場所で作業することです。ClaudeCodeを使うときは、自分のユーザーフォルダ配下(Macなら~/Documentsや~/Desktop、WindowsならC:\Users\あなたの名前\Documents)でプロジェクトを作るのが鉄則です。間違ってもデスクトップにある「アプリケーション」フォルダや、システムドライブのルート(C:\直下、Macの/直下)にプロジェクトを置かないでください。
ClaudeCodeを起動するときは、ターミナルで作業フォルダに移動してからclaudeコマンドを実行します。
cd ~/Documents/my-project
claude
このcdは「change directory(フォルダを変更する)」の略で、自分のホームフォルダ配下のDocuments/my-projectに移動する命令です。ここで作業すれば、ほぼ確実に書き込み権限がある状態でClaudeCodeを使えます。
もしすでに権限エラーが出る場所にプロジェクトを作ってしまった場合は、Finderやエクスプローラーで、安全な場所(ドキュメントフォルダなど)にフォルダごとコピーしてから、コピー先で作業を再開してください。これだけで多くの権限エラーは解消します。
対処法2:ClaudeCodeの`/permissions`コマンドを使う
ClaudeCodeには、安全のために「どのファイルを読み書きしていいか」を確認する仕組みが組み込まれています。これを管理するのが/permissionsコマンドです。ClaudeCodeの対話画面で次のように入力します。
/permissions
すると、現在の権限設定の一覧が表示されます。ここで「特定のフォルダの編集を許可する」「逆に絶対に触らせない場所を指定する」といった調整が可能です。たとえば、~/Documents/my-project配下は全部許可、~/Desktopにあるファイルだけ確認を求める、といったきめ細かい設定ができます。
具体的な操作は、表示されたメニューに従って選択肢を選んでいけば大丈夫です。初心者の方は「許可を広げすぎない」ことを意識してください。広げすぎると、AIが意図せずに重要なファイルを上書きしてしまうリスクが上がります。逆に狭すぎると、毎回確認ダイアログが出て作業が止まります。プロジェクトフォルダ単位で許可するのがちょうどよいバランスです。
対処法3:chmodでファイル権限を変える
ファイル自体の権限が原因の場合、chmod(チェンジモード)コマンドで調整できます。これはMac/Linuxで使えるコマンドで、ファイルに「読み取り権限」「書き込み権限」「実行権限」を付け外しできます。
たとえば、自分のファイルなのに「Permission denied」が出る場合、書き込み権限が外れている可能性があります。次のコマンドで権限を確認できます。
ls -l ~/Documents/my-project
表示の左端に-rw-r--r--のような記号が出ます。最初の-はファイルの種類、続くrw-が自分の権限、r--がグループの権限、最後のr--が他人の権限を表します。w(write、書き込み)が抜けていれば、書き込めません。
書き込み権限を追加するには次のコマンドです。
chmod u+w ~/Documents/my-project/file.txt
u+wは「ユーザー(自分)に書き込み権限を追加」という意味です。フォルダ全体に対して再帰的に適用したい場合は-Rオプションを付けます。
chmod -R u+w ~/Documents/my-project
ただし、chmod 777という設定(全員に全権限を付与)はセキュリティ上絶対にやらないでください。よくネット上のQ&Aで「777にしたら直った」という回答を見かけますが、これは「家の鍵を全部外したら入れるようになった」と言っているのと同じで、解決ではなく問題の先送りです。必要最小限の権限だけを付与しましょう。
Windowsの場合、chmodは使えません。代わりにエクスプローラーでファイルを右クリック→「プロパティ」→「セキュリティ」タブから権限を編集します。普段使いのユーザーアカウントに「読み取りと書き込み」のチェックが入っているか確認してください。
対処法4:sudoを使うときの絶対ルール
sudo(スードゥ)は「superuser do」の略で、「管理者権限で実行する」命令です。これを使うと、通常ではアクセスできないシステム領域にも書き込めるようになります。便利な反面、誤用すると取り返しのつかない事態(システムファイルを壊す、自分のファイルの所有者がrootになって編集できなくなる、など)を招きます。
非エンジニアの方が守るべきsudo使用の絶対ルールは次の通りです。第一に、「自分が何をしているか分からないコマンドにsudoを付けない」。Q&AサイトのコピペでもsudoがあったらまずGoogleで意味を確認しましょう。第二に、「自分のホームフォルダ配下にsudoは原則使わない」。自分のフォルダなのにsudoが必要な状況は、すでに何かが壊れているサインです。第三に、「sudo chownでファイル所有者を自分に戻す」。間違って所有者がroot(管理者)になってしまったファイルは、次のコマンドで自分に戻せます。
sudo chown $(whoami) ~/Documents/my-project/file.txt
$(whoami)は「今ログインしているユーザー名」を自動で入れる仕組みで、これにより自分のアカウントが所有者になります。再帰的にフォルダ全体に適用するなら-Rを付けます。
sudo chown -R $(whoami) ~/Documents/my-project
第四に、「sudoを使った後は必ず動作確認をする」。一度操作してから、ClaudeCodeで普通に編集できるかをテストし、問題があればすぐに切り戻します。社内ルールでsudo使用が制限されている場合は、エンジニアに依頼してください。
対処法5:macOSのフルディスクアクセスを設定する
Macで「自分のドキュメントフォルダなのに書き込めない」という奇妙な現象が起きる場合、macOSのプライバシー設定が原因のことがあります。macOSは2019年以降、特定のフォルダ(ドキュメント、デスクトップ、ダウンロード、iCloud Driveなど)へのアプリのアクセスを個別に許可制にしています。
設定方法は次の通りです。「システム設定」→「プライバシーとセキュリティ」→「フルディスクアクセス」を開き、リストの中にClaudeCodeを実行しているターミナルアプリ(標準のTerminal、iTerm2、VSCodeなど)があるか確認します。なければ「+」ボタンで追加し、チェックを入れて有効にします。設定後、ターミナルアプリを完全に終了させてから再起動してください。
なお、フルディスクアクセスは非常に強い権限なので、信頼できるアプリにだけ与えるようにしてください。怪しいアプリには絶対に付与しないこと。
対処法6:Windowsの「管理者として実行」を使うタイミング
Windowsで権限エラーが出る場合、「管理者として実行」する選択肢があります。しかし、これも乱用厳禁です。原則として、通常ユーザーで作業するのが安全で、管理者として実行するのは「明らかにシステム領域への書き込みが必要なとき」だけにしてください。
管理者として実行するには、コマンドプロンプトやPowerShellのアイコンを右クリックして「管理者として実行」を選びます。ただし、この状態でファイルを作ると、そのファイルの所有者が管理者アカウントになり、後で通常ユーザーから編集できなくなる場合があります。基本的には通常権限で動かし、「どうしても必要な操作のときだけ」「終わったらすぐ通常権限に戻る」運用が安全です。
業務用PCでは、そもそも管理者権限が付与されていないケースもよくあります。その場合は、IT担当者に正式に申請するルートを通してください。勝手にローカル管理者アカウントを作ったり、UAC(ユーザーアカウント制御)を無効化したりするのは、社内のセキュリティポリシー違反になる可能性があります。
対処法7:所有者を確認する
権限エラーが続く場合、ファイルやフォルダの「所有者」を確認するのが有効です。所有者が自分ではない場合、いくら権限を変えても根本解決しません。
Mac/Linuxで所有者を確認するコマンドは次の通りです。
ls -l ~/Documents/my-project
表示の中に、ユーザー名とグループ名が出ます。たとえばyamada staffなら、所有者はyamada、グループはstaffです。自分のユーザー名と一致しなければ、所有者を変更します。
sudo chown -R $(whoami):staff ~/Documents/my-project
このコマンドは前のセクションでも触れた通り、フォルダ配下すべての所有者を自分に変更します。実行前に「本当にこのフォルダの所有権を取っていいか」をよく考えてください。他人のファイルだったら、勝手に所有権を奪うとトラブルになります。
Windowsの場合は、エクスプローラーで右クリック→「プロパティ」→「セキュリティ」タブ→「詳細設定」から所有者を変更できます。
それでも解決しないときの最終手段
ここまでの対処をすべて試しても直らない場合、いくつかの可能性が残ります。第一に、ウイルス対策ソフトがClaudeCodeのファイルアクセスをブロックしているケース。一時的にスキャンを止めて試すか、ClaudeCodeを例外設定に追加してみてください。第二に、社内のセキュリティポリシーで特定フォルダへの書き込みが制限されているケース。これはIT担当者にしか解除できません。第三に、ディスク自体に問題がある(破損、容量不足、フォーマットの問題)ケース。ディスクユーティリティで検査してみるのが有効です。
非エンジニアの方が自力で対処できないと感じたら、社内のエンジニアやIT担当者に状況を整理して相談しましょう。「どのファイルで」「どんなエラーが」「どのタイミングで」出るかを伝えれば、解決が速くなります。
よくある質問
Q1. chmod 777にすれば全部解決すると聞きました。やっていいですか?
やめてください。セキュリティが大幅に下がり、他人や悪意あるプログラムからもファイルが書き換えられる状態になります。必要最小限の権限付与にとどめましょう。
Q2. sudoを使うのが怖いです。 怖いと感じる感覚は正しいです。コマンドの意味が分かるまで使わない、自分のホーム配下では使わない、を守れば大事故にはなりません。
Q3. ファイルの所有者がrootになってしまいました。
sudo chown -R $(whoami) パスで自分に戻せます。ただし、それが本当に自分のファイルなのかを確認してから実行してください。
Q4. WindowsでもLinuxみたいに権限を細かく設定できますか? できますが、UIから操作するのが基本です。エクスプローラーの「プロパティ」→「セキュリティ」タブから編集します。
Q5. macOSで突然「アクセス許可がない」と言われます。 macOSのプライバシー設定でフルディスクアクセスを許可していない可能性が高いです。「システム設定」→「プライバシーとセキュリティ」を確認してください。
Q6. /permissionsコマンドで広く許可しすぎてしまいました。
同じ/permissionsコマンドで再設定できます。プロジェクトフォルダ単位の許可にとどめるのがおすすめです。
Q7. 社内PCで権限エラーが頻発します。 社内のセキュリティポリシーで制限がかかっている可能性が高いです。IT担当者に状況を伝えて、必要な権限の付与を相談してください。
まとめ
「Permission denied」は、コンピュータがセキュリティを守ろうとしている健全な反応です。怖がる必要はなく、「自分の場所で作業する」「広すぎる権限を与えない」「sudoは慎重に」の3原則を守れば、安全に解決できます。特に非エンジニアの方は、自分のドキュメントフォルダ配下にプロジェクトを置く、/permissionsコマンドで適切な許可範囲を設定する、それでもダメならエンジニアに相談する、という流れで進めるのが安心です。今日から落ち着いて、エラーと向き合っていきましょう。