Claude Code 逆引きコマンド事典

「Claude CodeのXXXで困った時どうする？」という逆引き一問一答形式でまとめたClaude Codeのコマンド集です。

僕は普段から説明書を読まないタイプ(爆)で、Claude CodeもBest Practiceを斜め読みした程度で使ってたのですが、ある時 claude -r コマンドを知って「そんな便利なコマンドあるのか！」と驚愕しました笑。

ちゃんと説明書読まないとなぁと反省し、メモをとりながらClaude公式ドキュメント(+多少の入門記事)を読み直したので、メモをまとめて公開してみます。とはいえ、単なるコマンド一覧では「過去の僕」は読まないかなと思ったので笑、逆引き一問一答形式にしています。

内容は2025年6月23日現在では正しいはずですが、界隈の速さを考えると一瞬で陳腐化すると思います。動かない場合は公式ドキュメントを参照していただけると幸いです。また、明らかに間違っているところがあればTwitterなどでご指摘いただけますと助かります。

本記事ではClaude Codeのはじめかた (インストール方法など) については触れません。Classmethodさんの記事が非常に参考になったのでそちらをご覧いただくことをおすすめします😇

• claude
• VS Code や Cursor の拡張が入ってたら “Run Claude Code” ボタンでもいいですね。
  • 拡張は初回のclaude実行でインストールされるはずです
  • 入ってなかったらこの記事とかを参考に解決されるといいと思います

Run Claude Code = 右上のAnthropicロゴ

• claude -c (claude --continue) で最新の会話に戻って続けられます。
• 会話履歴はローカルマシンに保存される[6]のでマシンをまたいでcontinueできないことには注意が必要です

• claude -r (claude --resume) で過去の会話スレッドを選んで入れます。
  • claude で立ち上げてから /resume でも動作します (なぜか /continue はない？)
• -c と同様にマシンをまたいで resume できないので注意が必要です。

• claude -p "{message}" で質問が可能です。
  • 例: claude -p "僕がaddしたファイル見てcommitメッセージ作って"
• (遅いし何やってるか分からないから個人的にはほぼ使ってません😅笑)

(環境依存で色々変わるのでClaude Codeが言っている内容を見ていただけると良いかと思います)

• \ のあとに Enter もしくは Ctrl+j です。
• Macだと option+Enter でも改行できます
• /terminal-setup コマンドを打ってターミナルを再起動すると Shift+Enter でも改行できるようになります
  • CursorのkeybindingsにはShift+Enterが入っているらしく特に何もせずにShift+Enterで改行できるかなと思います

• /help で見れます

• /model で確認可能です

• Maxプランの例
  • デフォルトでは使用制限の半分までOpusを使ったあと、Sonnet利用に切り替わります。
  • 使用制限の限界までOpusを使いたい場合はOpusを選択するといいです。(その代わり Max x5 プランだとすぐに上限くると思います)

• @ をつけてファイルを指定して渡せます
• とはいえ Claude Code は賢いので @ つけずにファイル名を言って質問するだけでも、よしなにファイル検索してうまく処理してくれることが多いです。

• ! を打てばbashモードになるのでcdとか打てます
• Claude Code は賢いのでbashモードにしなくてもシェルコマンド打てば考えてからコマンド実行してくれますが、まぁまぁ遅いので!を打ってbashモードにすることをおすすめします。

• ESCで止まります

• ESC 2回連打で任意の会話の位置に戻れます
• ただしファイル編集履歴は戻らないので、こまめにコミットさせるのが吉です。
  • (CursorのAgentだとcheckpointに戻ってくれるのでその機能早く追加してほしい)

• /clear で会話履歴全部消せます

• Ctrl+r で展開されます

• /configコマンドで設定画面に入ってVerbose outputをtrueにすると良いです。
• もしくはclaude --verboseで立ち上げるといいです
• とはいえファイル編集のdiffとかも全部出てくるのでややうざいです。

• Shift+tab でモードが切り替わります

• 上に同じく Shift+tab でモードが切り替わります

• コンテンツをファイルに書き込んで @ で呼ぶのが推奨とのこと [3]
  • @じゃなくてもClaudeに「XXXのファイル読んで」って言っても大体は大丈夫
• もしくはPipeで渡す cat foo.txt | claude

• これも同様に/permissions で Deny Allow でルール設定できます
• 例: Edit(docs/*): docsディレクトリにあるファイルの編集を (禁止 | 許可) できます
• 同様に Read(docs/*) 設定で読み取り自体の制御もできます。

• これも/permissions で Deny でドメイン指定して排除できます
• 例: WebFetch(domain:example.com) example.com への Fetch を (禁止 | 許可) できます

• .claude/settings.json を編集したら一気に設定できるよ。
• [8]に記載の例

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)"
    ]
  },
  ...
}

• Deny を有効活用されている方の例

• .claude/settings.json をレポジトリに入れて共有するといい

• claude --dangerously-skip-permissionsで起動したらいいです
• 危険が危ない()のでからインターネットアクセスのないコンテナ内での使用を推奨
• (僕は使ったことない笑)

• /theme

• /init で作ってくれます
  • /init 日本語で作って で日本語で作ってくれるらしい (僕は常に英語で作ってる)
• もちろん自分で書いてもいいです

• [7]には以下のような図が掲載されているので参考にするといいでしょう

• # を打ってルールを打てば覚えてくれるよ

• CLAUDE.mdファイルに@path/to/import構文で参照したいファイルをインポートできます。なので単純なコピペ不要です。
• 例

See @README.md for project overview and @package.json for
available npm commands for this project.

# Additional Instructions
#### git workflow @docs/git-instructions.md
...

• パスは相対パスと絶対パスの両方が使用できます。

• 最大5ホップ先の参照まで再起的に読み込まれます[7]

• /memory で確認可能です

• 前提として Claude Code はGit操作に慣れてます
• 「ブランチ作って」って言ったら作ってくれます
• 特によく使う以下3つの操作は単語を打つだけで何するべきか考えてやってくれます
  • commit
  • push
  • pr
• gh CLI入れておくとスムーズです
  • commitしてpushしてPR作らせるぐらいなら、ghなくても全然大丈夫です😇

# Mac
brew install gh

# Ubuntu/Debian
sudo apt install gh

# 認証設定 (共通)
gh auth login

• claude commit で起動即commitしてくれます

• Custom slash command を作るといい。
• そもそも Custom slash command とは？
  • ~/.claude/commands/{コマンド名}.md に指示書くと /{コマンド名} で実行できるようになる。これを Custom slash command と呼んでいる。
    • 例: ~/.claude/commands/hoge.md → /hoge
    • 場所は /{プロジェクトのルートディレクトリ}/.claude/commands/{コマンド名}.md でも可
    • 注意
      • ドキュメントには /user:hoge と説明しているものがあるが古いので注意
  • Custom slash command には $ARGUMENTS を設定でき、コマンドの引数を代入することができる。
• Custom slash command を活用したIssue解決指示例
  • 以下のようなプロンプトを ~/.claude/commands/fix-github-issue.md に書く
  • /fix-github-issue 1234を実行

以下の手順に従って、GitHub issue #$ARGUMENTS を解決してください

以下のステップに従ってください：
1. `gh issue view`を使用してissueの詳細を取得する
2. issueに記載されている問題を理解する
3. 関連するファイルをコードベースから検索する
4. issueを修正するために必要な変更を実装する
5. 修正を検証するためのテストを作成し実行する
6. コードがlintとtype checkをpassすることを確認する
7. 丁寧な説明と共にコミットメッセージを作成する
8. プッシュしてPRを作成する

GitHubに関連するすべてのタスクには、GitHub CLI（`gh`）を使用してください。

• /permissionsやclaude/settings.jsonを利用してDenyやAllowしましょう
• 構文は /mcp____ です
• Playwright の例だと以下のようになります

{
  "permissions": {
    "allow": [
      "mcp__playwright__browser_navigate",
      "mcp__playwright__browser_take_screenshot"
    ]
  },
  "enableAllProjectMcpServers": true,
  "enabledMcpjsonServers": [
    "playwright"
  ]
}

• まず、最初に徹底的に計画させるのが大切
  • 計画がないとすぐに解決策のコーディングに取り掛かってしまう。([1]に明記されている)
  • 計画の際には Shift+Tab で Plan Mode にしておくと良い。
• 次に、コードを書いて反復してコミットするように指示するのが大事。
  • Claude は、視覚的なモック、テストケース、その他の出力など、明確な反復目標がある場合に最も高いパフォーマンスを発揮するようになっている。(同じく[1]に明記)
  • なので
    • 画面作らせる時はスクショ撮らせたりするのが良い
    • TDDで最初にテスト書かせてそれに沿って開発させるのもいい
    • ただしテストを通すためのズルをしたり、テスト通ってないけど気にせず次の作業するねﾃﾍﾍﾟﾛ、とかほざくことも多いので僕も悩んでいる😅

• Claude Codeのベストプラクティス[1]曰く、「Claudeは意図を推測できますが、心を読むことはできません。具体的な内容を指示することであなたの期待値に沿った動きができるようになるでしょう。」(意訳) らしいです。
• ベストプラクティスに掲載されている例 (下図 / 筆者意訳) などを参照に、何をやってほしいか具体的に書くように心がけると良いでしょう。

• [2]の動画で紹介されていた質問例がわかりやすいので以下に意訳した上で引用する。
  • @RoutingController.py ってどんな感じで使ってるの？
  • 新しい @app/services/ValidationTemplateFactory をどうやって実装したらいいかな
  • recoverFromException が多くの引数を取るのはなんで？Git履歴を調べて答えて。
  • @src/index.ts API に if/else を追加することで、なぜ issue #18363 が解決できたのだろうか？
  • 新しい @api/ext/PreHooks.php API をリリースしたのはどのバージョンですか？
  • PR #9383 を見て、影響を受けたアプリのバージョンを慎重に確認して
  • 先週僕がリリースしたものを教えて

• 作業用のメモを作成させて、消し込みながら作業させると良い。
• 大量のlintを行わせる例
  • まずClaudeに lint コマンドを実行させる
  • その結果を何らかのファイルに保存させる
  • その後に、Claude Codeにリストを消し込みつつ作業してもらう
  • こうすることで Claude Code は自分がやってない場所を把握し、上手に処理することができる。

主な参考文献をあげておきます。Claude公式ドキュメントは他にも色々参照した気がするので、気になる点があれば一通り読んでみることをおすすめします。(日本語版には英語版ならあるドキュメントがないこともあるので、ChromeのGoogle翻訳拡張とかで英語版を翻訳して読むのがいいと思います)