【結論】claude code エラー xの解決策 / 実行コマンド
現在のClaude Codeはネイティブインストーラーが推奨され、通常の導入にXcode Command Line Toolsは必須ではありません。
xcode-selectエラーが出る場合は、Claude Code本体ではなくGitや依存パッケージのビルドが要求している可能性を切り分けます。
まず現行版を再導入し、診断を実行してください。
curl -fsSL https://claude.ai/install.sh | bash
claude doctor
claude --version具体的な手順・設定方法
which -a claudeで旧npm版とネイティブ版が重複していないか確認します。Gitやnode-gypの処理で
xcrun、clang、xcode-selectエラーが出た場合だけCommand Line Toolsを導入します。Apple Siliconでは
uname -mがarm64、Intel Macではx86_64であることを確認します。導入後も失敗する場合は
claude --debug-fileでログを取り、エラーがClaude Code起動前か起動後かを分けます。
which -a claude
uname -m
xcode-select -p
# 必要な場合のみ
xcode-select --install実践プロンプト / 活用テクニック
環境情報をまとめて診断させると、不要なキャッシュ削除やNode.js変更を避けられます。
エラー全文は先頭と末尾を省略せず渡します。
次のMac環境情報とエラーを分析してください。
修正コマンドを実行する前に、Claude Code本体、Git、Xcode Command Line Tools、CPUアーキテクチャ、PATHのどこが原因か判定してください。
出力: uname -m / which -a claude / xcode-select -p / エラー全文注意点・よくあるエラーと対処法
npm cache clean --forceはネイティブ版の問題には効果がなく、他プロジェクトのキャッシュまで消します。Command Line Toolsを入れても401、429、500などのAPIエラーは解決しません。
複数の
claudeが見つかる場合は、実行されているパスを確認して旧版だけを整理します。管理者権限でのnpm再インストールを安易に行わず、公式インストーラーかHomebrewを利用します。