一般的なインストール問題

Linuxの権限問題

npmでClaude Codeをインストールする際、npmのグローバルプレフィックスがユーザー書き込み可能でない場合(例:/usr、または/usr/local)、権限エラーが発生する可能性があります。

推奨解決策:ユーザー書き込み可能なnpmプレフィックスを作成する

最も安全なアプローチは、ホームフォルダ内のディレクトリを使用するようにnpmを設定することです:

# まず、後の移行のために既存のグローバルパッケージのリストを保存します
npm list -g --depth=0 > ~/npm-global-packages.txt

# グローバルパッケージ用のディレクトリを作成します
mkdir -p ~/.npm-global

# 新しいディレクトリパスを使用するようにnpmを設定します
npm config set prefix ~/.npm-global

# 注意:~/.bashrcを~/.zshrc、~/.profile、またはお使いのシェルに適した他のファイルに置き換えてください
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# 新しいPATH設定を適用します
source ~/.bashrc

# 新しい場所にClaude Codeを再インストールします
npm install -g @anthropic-ai/claude-code

# オプション:新しい場所に以前のグローバルパッケージを再インストールします
# ~/npm-global-packages.txtを確認し、保持したいパッケージをインストールしてください

この解決策が推奨される理由:

  • システムディレクトリの権限変更を避ける
  • グローバルnpmパッケージ用の清潔で専用の場所を作成する
  • セキュリティのベストプラクティスに従う

システム復旧:システムファイルの所有権と権限を変更するコマンドなどを実行した場合

すでにシステムディレクトリの権限を変更するコマンド(sudo chown -R $USER:$(id -gn) /usr && sudo chmod -R u+w /usrなど)を実行し、システムが破損している場合(例:sudo: /usr/bin/sudo must be owned by uid 0 and have the setuid bit setが表示される場合)、復旧手順を実行する必要があります。

Ubuntu/Debian復旧方法:
  1. 再起動中にSHIFTキーを押し続けてGRUBメニューにアクセスします

  2. 「Advanced options for Ubuntu/Debian」を選択します

  3. リカバリモードオプションを選択します

  4. 「Drop to root shell prompt」を選択します

  5. ファイルシステムを書き込み可能として再マウントします:

    mount -o remount,rw /
    
  6. 権限を修正します:

    # root所有権を復元
    chown -R root:root /usr
    chmod -R 755 /usr
    
    # npmパッケージ用に/usr/localがユーザーによって所有されることを確認
    chown -R YOUR_USERNAME:YOUR_USERNAME /usr/local
    
    # 重要なバイナリにsetuidビットを設定
    chmod u+s /usr/bin/sudo
    chmod 4755 /usr/bin/sudo
    chmod u+s /usr/bin/su
    chmod u+s /usr/bin/passwd
    chmod u+s /usr/bin/newgrp
    chmod u+s /usr/bin/gpasswd
    chmod u+s /usr/bin/chsh
    chmod u+s /usr/bin/chfn
    
    # sudo設定を修正
    chown root:root /usr/libexec/sudo/sudoers.so
    chmod 4755 /usr/libexec/sudo/sudoers.so
    chown root:root /etc/sudo.conf
    chmod 644 /etc/sudo.conf
    
  7. 影響を受けたパッケージを再インストールします(オプションですが推奨):

    # インストール済みパッケージのリストを保存
    dpkg --get-selections > /tmp/installed_packages.txt
    
    # それらを再インストール
    awk '{print $1}' /tmp/installed_packages.txt | xargs -r apt-get install --reinstall -y
    
  8. 再起動:

    reboot
    
代替ライブUSB復旧方法:

リカバリモードが機能しない場合、ライブUSBを使用できます:

  1. ライブUSB(Ubuntu、Debian、または任意のLinuxディストリビューション)から起動します

  2. システムパーティションを見つけます:

    lsblk
    
  3. システムパーティションをマウントします:

    sudo mount /dev/sdXY /mnt  # sdXYを実際のシステムパーティションに置き換えてください
    
  4. 別のブートパーティションがある場合、それもマウントします:

    sudo mount /dev/sdXZ /mnt/boot  # 必要に応じて
    
  5. システムにchrootします:

    # Ubuntu/Debianの場合:
    sudo chroot /mnt
    
    # Archベースシステムの場合:
    sudo arch-chroot /mnt
    
  6. 上記のUbuntu/Debian復旧方法の手順6-8に従います

システムを復元した後、上記の推奨解決策に従ってユーザー書き込み可能なnpmプレフィックスを設定してください。

自動アップデーター問題

Claude Codeが自動的に更新できない場合、npmグローバルプレフィックスディレクトリの権限問題が原因である可能性があります。これを修正するには、上記の推奨解決策に従ってください。

代わりに自動アップデーターを無効にしたい場合は、DISABLE_AUTOUPDATER 環境変数1に設定できます

権限と認証

繰り返される権限プロンプト

同じコマンドを繰り返し承認している場合、/permissionsコマンドを使用して特定のツールを承認なしで実行できるようにすることができます。権限ドキュメントを参照してください。

認証問題

認証問題が発生している場合:

  1. /logoutを実行して完全にサインアウトします
  2. Claude Codeを閉じます
  3. claudeで再起動し、認証プロセスを再度完了します

問題が続く場合は、以下を試してください:

rm -rf ~/.config/claude-code/auth.json
claude

これにより、保存された認証情報が削除され、クリーンなログインが強制されます。

パフォーマンスと安定性

高いCPUまたはメモリ使用量

Claude Codeはほとんどの開発環境で動作するように設計されていますが、大きなコードベースを処理する際に大量のリソースを消費する可能性があります。パフォーマンス問題が発生している場合:

  1. /compactを定期的に使用してコンテキストサイズを削減します
  2. 主要なタスクの間にClaude Codeを閉じて再起動します
  3. 大きなビルドディレクトリを.gitignoreファイルに追加することを検討してください

コマンドがハングまたはフリーズする

Claude Codeが応答しない場合:

  1. Ctrl+Cを押して現在の操作をキャンセルしようとします
  2. 応答しない場合、ターミナルを閉じて再起動する必要があるかもしれません

JetBrains(IntelliJ、PyCharmなど)ターミナルでESCキーが機能しない

JetBrainsターミナルでClaude Codeを使用していて、ESCキーが期待通りにエージェントを中断しない場合、これはJetBrainsのデフォルトショートカットとのキーバインドの競合が原因である可能性があります。

この問題を修正するには:

  1. 設定 → ツール → ターミナルに移動します
  2. 「Override IDE Shortcuts」の横にある「Configure terminal keybindings」ハイパーリンクをクリックします
  3. ターミナルキーバインド内で、「Switch focus to Editor」までスクロールダウンし、そのショートカットを削除します

これにより、ESCキーがPyCharmの「Switch focus to Editor」アクションによってキャプチャされる代わりに、Claude Code操作のキャンセルに適切に機能するようになります。

さらなるヘルプの取得

ここでカバーされていない問題が発生している場合:

  1. Claude Code内で/bugコマンドを使用してAnthropicに直接問題を報告します
  2. 既知の問題についてGitHubリポジトリを確認します
  3. /doctorを実行してClaude Codeインストールの健全性を確認します