Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

VS CodeがDockまたはSpotlightから起動された場合、BashツールがHomebrewやその他のPATH依存のバイナリを見つけられない問題を修正しました。

原文（英語） ​

Fixed Bash tool not finding Homebrew and other PATH-dependent binaries when VS Code is launched from Dock/Spotlight.

概要 ​

macOSでVS CodeをDockのアイコンクリックやSpotlight検索から起動した場合、シェルの環境変数（特に PATH）が正しく引き継がれないため、BashツールがHomebrewでインストールしたコマンド（brew、node、python3 など）を見つけられないバグが修正されました。ターミナルから code . で起動した場合は発生しない問題でした。

基本的な使い方 ​

修正後は、VS CodeをDockやSpotlightから起動してClaude Codeを使用しても、Homebrewのコマンドが正常に認識されます。

bash
# 修正前は以下のようなエラーが発生していた
# command not found: brew
# command not found: node

# 修正後は正常に動作する
brew --version  # → Homebrew 4.x.x
node --version  # → v20.x.x

実践例 ​

ユースケース: Dock起動後のNode.js環境確認 ​

VS CodeをDockから起動してClaudeにNode.jsプロジェクトの作業を依頼する場合：

bash
# 修正前: Dock起動のVS Codeでは以下が失敗していた
node --version    # command not found: node
npm install       # command not found: npm
npx vite build    # command not found: npx

# 修正後: 正常に動作する
node --version    # v20.11.0
npm install       # ✓
npx vite build    # ✓

ユースケース: Python環境の利用 ​

bash
# 修正前: Spotlight/Dock起動のVS Codeでは pyenv/homebrew のPythonが見つからなかった
python3 --version  # /usr/bin/python3 が使われる（Homebrewのものではない）

# 修正後: Homebrewでインストールしたバージョンが使われる
python3 --version  # Python 3.12.x (Homebrew)

ユースケース: その他のHomebrew依存ツール ​

bash
# git, gh, jq, ripgrep などHomebrew経由でインストールしたツール全般が対象
gh --version   # GitHub CLI
jq --version   # JSONプロセッサ
rg --version   # ripgrep

注意点 ​

  • この問題はmacOS固有の問題で、VS CodeをGUIから起動した場合に発生していました
  • ターミナルから code . または code ~/project で起動した場合は影響がありませんでした
  • ~/.zshrc や ~/.bash_profile でPATHを設定している場合、それらが正しく読み込まれるようになります

関連情報 ​