つまずきレシピ集

# まず入っているか確認
which claude
ls ~/.claude/local/claude 2>/dev/null

# Native install を入れ直す（推奨）
curl -fsSL https://claude.ai/install.sh | bash

# 入った場所を PATH に通す（zsh の場合）
echo 'export PATH="$HOME/.claude/local:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 現状を確認
node -v        # v20 未満なら NG（Node 20 LTS 以上推奨）
npm -v

# Mac は Homebrew で最新へ
brew install node@20
brew link --overwrite node@20

# それでも古いまま見える時は nvm へ移行
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.zshrc
nvm install 20
nvm use 20

# 推奨: native install に切り替え（npm を経由しない）
curl -fsSL https://claude.ai/install.sh | bash

# どうしても npm を使うなら、ユーザーディレクトリに変更
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

# PowerShell を管理者で開いて
wsl --install
# 再起動 → Ubuntu を起動

# Ubuntu の中で
sudo apt update && sudo apt install -y curl
curl -fsSL https://claude.ai/install.sh | bash

# 以後は WSL のシェルから起動
claude

# 自分のシェルを確認
echo $SHELL          # /bin/zsh なら zsh、/bin/bash なら bash

# zsh の場合（Mac の標準）
echo 'export PATH="$HOME/.claude/local:$PATH"' >> ~/.zshrc
source ~/.zshrc

# bash の場合
echo 'export PATH="$HOME/.claude/local:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 反映確認
echo $PATH | tr ':' '\n' | grep claude

# 認証 URL をターミナルに表示させる
claude login

# 表示された URL を手動でコピーしてブラウザに貼る
# 認証後、トークンをターミナルに戻して貼り付け

# それでも動かない時はトークンを直接設定
export ANTHROPIC_API_KEY="sk-ant-..."
claude

# 一旦ログアウト
claude logout

# 認証ファイルが残っていることがあるので消す
rm -rf ~/.claude/credentials.json
rm -rf ~/.config/anthropic 2>/dev/null

# 再ログイン
claude login

# 課金切替後にトークン再発行が必要
claude logout
claude login   # 新しいプランで認証し直す

# 完全ログアウト → クレデンシャル削除 → 再ログイン
claude logout
rm -f ~/.claude/credentials.json
claude login   # ブラウザで切り替えたいアカウントを選ぶ

# Claude Code 内ではディレクトリ操作はチャットで頼む
> プロジェクト xxxx に作業ディレクトリを変えて

# 一旦抜けてシェルに戻る
/exit

# シェルから cd して開き直す
cd ~/projects/myapp
claude

# 現状確認
echo $LANG          # ja_JP.UTF-8 か en_US.UTF-8 が望ましい
locale

# zsh で永続設定
echo 'export LANG=ja_JP.UTF-8' >> ~/.zshrc
echo 'export LC_ALL=ja_JP.UTF-8' >> ~/.zshrc
source ~/.zshrc

# 今のシェルを確認
echo $0

# sh や dash なら zsh / bash に切り替え
chsh -s /bin/zsh   # Mac
# WSL/Linux
sudo apt install zsh
chsh -s $(which zsh)

# ターミナルを開き直す

# 長文を貼る時は Shift+Enter で改行を入れながら貼る
# (Enter 単体は送信になる)

# それでもダメな時はファイルに書いて読ませる
> ./prompt.txt の内容を読んで

# Mac のターミナルなら、設定 > プロファイル > キーボード で
# "メタキーとして Option キーを使用" をオン

# 順に試す（強い順）
Ctrl+C を 2 回連打   # 通常のキャンセル
/exit               # スラッシュコマンドで終了
Ctrl+D              # EOF で終了
Ctrl+\              # 強制クォート

# それでも生きてたら別ターミナルから
ps aux | grep claude
kill -9 [PID]

# 所有者を確認
ls -l <ファイル>

# 自分の所有に戻す
sudo chown -R $USER:staff ./<ディレクトリ>

# 書き込み権限を付与
chmod -R u+w ./<ディレクトリ>

# 承認待ちかどうか確認
> 今、承認待ちのアクションは？

# 実際のファイルパスを聞く
> 今編集したファイルの絶対パスは？

# エディタを一旦閉じてから再度開く
# (VS Code は自動リロードを ON に)

# 何が無視されてるか確認
git check-ignore -v <ファイル>

# .gitignore を確認
cat .gitignore

# どうしても追加したい時 (推奨されない)
git add -f <ファイル>

# 別の git 管理下にいないか確認
cd <ファイルのある場所>
git rev-parse --show-toplevel

# スペース込みパスは必ずダブルクオートで囲む
cd "/Users/me/My Drive/Project Files"

# Mac の iCloud / GoogleDrive パスはエスケープが堅実
cd /Users/me/Library/CloudStorage/GoogleDrive-xxx/マイドライブ

# Claude には絶対パスを直接見せる
> /Users/me/My\ Drive/Project\ Files の中を確認して

# git に大文字小文字を意識させる
git config core.ignorecase false

# 既に重複している場合は片方を git から削除
git mv README.md README.md.tmp
git commit -m "rename"
git mv README.md.tmp readme.md
git commit -m "lowercase"

# 続きを書かせる（最も簡単）
> 続けて

# それでもダメなら分割を指示
> このファイルを A 部 / B 部 / C 部 に分けて、A 部だけ書いて

# 既存ファイルへの追記なら Edit ベースで頼む
> file.py の foo 関数だけ修正して

# 環境を明示する（依頼時のテンプレに入れる）
> Python 3.12 / FastAPI 0.115 で書いて
> Node 20 / React 19 / Next.js 15 で書いて

# 既存の package.json / requirements.txt を見せる
> ./package.json を見て、これに合わせて書いて

# ドキュメントの URL を貼る
> https://docs.xxx.io/latest を参照して、最新 API で

# プロジェクトに CLAUDE.md を作る
cat > CLAUDE.md <<'EOF'
# このプロジェクトのルール
- TypeScript strict モードを必ず使う
- React は関数コンポーネントのみ、class は禁止
- API 呼び出しは必ず try-catch で包む
- console.log を残さない（本番ビルド前に必ず削除）
EOF

# 既存セッションでもメモリに登録
> 「console.log を残さない」をこのプロジェクトのルールとして覚えて

# セッション開始時に明示
> 以後、すべての応答は日本語で。コード内コメントも日本語で。

# CLAUDE.md に書いておけば毎回不要
echo "応答言語: 日本語" >> CLAUDE.md

# 絶対パスで指定
> /Users/me/proj/src/api/auth.ts の login 関数を直して

# 編集前に対象を確認させる
> どのファイルを編集する予定？まだ書かないで

# git で安全網を張る
git status
git diff   # 編集前後を比較
git checkout -- <間違って編集されたファイル>   # 戻す

# 履歴をリセット
/clear
# または一旦終了して新セッション
/exit
claude

# 大きなファイル読み込みを減らす
> ./big.json は読まないで、./summary.md だけ見て

# 別モデルに切り替え（重い時は Sonnet が軽い）
/model sonnet

# 作業を細かく分ける
> ステップ1: 設計だけ書いて、実装はまだしないで
> （受け取って確認）
> ステップ2: 関数 A だけ実装して
> ...

# ネットワーク状態を確認
ping -c 3 api.anthropic.com

# VPN / プロキシをいったん切る

# プロセスを確認
ps aux | grep -E "claude|node" | head

# 不要セッションを終了
/exit

# 並行は最大 2-3 まで
# Mac なら アクティビティモニタ で claude / node の使用量を見る

# 巨大 node_modules や .git は読み込み除外を指示
echo "node_modules/" >> .claude/ignore

# まず最新を取り込む
git fetch origin
git pull --rebase origin main

# コンフリクトが出たら解消（G-02 参照）

# 解決したら push
git push origin <ブランチ名>

# 競合ファイルを Claude に解決させる
> 今コンフリクトしているファイルを開いて、私の意図に沿って解決して

# 状況確認
git status
# Unmerged paths と表示されたファイルを開くと
# <<<<<<< HEAD
# 私の変更
# =======
# 相手の変更
# >>>>>>> branch

# 解決後
git add <ファイル>
git rebase --continue   # rebase 中の場合
git commit              # merge 中の場合

# 諦めて元に戻す
git rebase --abort
git merge --abort

# まだ push していない場合
git reset --soft HEAD~1   # 直前 commit を取り消し、変更は残す
git reset --mixed HEAD~1  # 上 + ステージング解除（デフォルト）

# メッセージだけ修正
git commit --amend -m "正しいメッセージ"

# push 済みの場合（履歴は変えない方が安全）
git revert <コミットハッシュ>   # 打ち消す新 commit を作る
git push

# まず差分を見る（実行はしない）
git fetch origin
git log HEAD..origin/main --oneline | head -20
git diff --stat HEAD origin/main

# Claude に要約させる
> origin/main に対する自分のブランチの差分を要約して

# 安全に取り込む手順
git stash                   # 自分の変更を退避
git checkout main
git pull
git checkout <自分のブランチ>
git rebase main             # ← ここでコンフリクトに対処
git stash pop

# 現在の認証方法を確認
git config --global credential.helper
git remote -v

# Mac: キーチェーンに保存（推奨）
git config --global credential.helper osxkeychain

# 保存済みパスワードを消したい時
# キーチェーンアクセス.app で "github.com" を検索 → 削除

# SSH に切り替える方が安定
ssh-keygen -t ed25519 -C "you@example.com"
cat ~/.ssh/id_ed25519.pub   # GitHub Settings > SSH keys に貼る
git remote set-url origin git@github.com:user/repo.git

# 1. VS Code 拡張をアップデート
# 拡張タブ > Claude Code > 更新ボタン

# 2. 本体の最新化
claude update
# または手動で
curl -fsSL https://claude.ai/install.sh | bash

# 3. ワークスペースの「信頼」をオン
# Cmd+Shift+P > "Workspaces: Manage Workspace Trust"

# 4. それでもダメなら拡張を入れ直し
# 拡張タブで Claude Code をアンインストール → 再インストール

# まずは一覧を見る
/help

# プロジェクトのコマンドを確認
ls .claude/commands/
ls ~/.claude/commands/

# プラグインを有効化（settings.json）
cat .claude/settings.json
# "plugins": { "codex@openai-codex": true } のように追加

# まず原因を確認
claude --debug   # デバッグログを出して再起動

# レート制限の場合は数分待ってから再起動
# プラン上限に近い時は console.anthropic.com で使用量チェック

# 再開時、前回の文脈を渡す
claude
> 前のセッションで <タスク> をやっていた途中。続きから。

# よく落ちるなら ulimit で制限緩和
ulimit -n 10240

# 接続状況を確認
/mcp

# 設定ファイルを確認
cat ~/.claude/settings.json | python3 -m json.tool   # JSON 構文チェック

# プラグインを再起動
/exit
claude

# それでもダメなら設定をリセット
mv ~/.claude/settings.json ~/.claude/settings.json.bak
claude   # デフォルト設定で起動

# 現在時刻をシェルから渡す
> 今 $(date) です。これを基準に処理して

# CLAUDE.md に毎回入れておく
echo "現在時刻は date コマンドで取得した値を使う。学習時点を信用しない。" >> CLAUDE.md

# タイムゾーンを明示
> 私のタイムゾーンは Asia/Tokyo (JST/UTC+9) です

# 設定の書式チェック
cat ~/.claude/settings.json | python3 -m json.tool

# hooks のスクリプトに実行権限
chmod +x ~/.claude/hooks/my-hook.sh

# 絶対パスで書く（$HOME 展開されないシェル環境あり）
# NG: "command": "~/scripts/x.sh"
# OK: "command": "/Users/me/scripts/x.sh"

# デバッグログを見る
claude --debug 2>&1 | grep -i hook

# セッション内で
/model
# 一覧から選択

# または直接
/model sonnet
/model opus

# 起動時から指定
claude --model claude-sonnet-4-7

# プロジェクトのデフォルトを設定
# .claude/settings.json
# { "model": "claude-sonnet-4-7" }

# 標準の更新
claude update

# 強制的に最新スクリプトで入れ直し
curl -fsSL https://claude.ai/install.sh | bash

# 古い npm 版が残ってないか
which -a claude
npm list -g --depth=0 | grep claude
# 残ってたら uninstall
npm uninstall -g @anthropic-ai/claude-code

# バージョン確認
claude --version