Tips & Techniques

講義に入りきらなかった発見たち

講師が日々の運用で見つけた小ネタ集

本編の 5 Phase には収まらなかったけれど、Claude Code を毎日使っていく中で「これは効く」と感じたコツを集めました。気が向いたときに 1 つずつ拾い読みしてください。

← 本編ページに戻る

A. 基本操作の小ネタ

最初の 1〜2 週間で「あ、こんなコマンド／挙動があったんだ」と気づくと作業がぐっと軽くなる、入門寄りの Tip です。

1. /btw — 会話履歴を汚染しないサイドクエスチョン

こんなとき: 実装中にちょっとした疑問が湧いた。普通に質問すると、その質疑応答がメインの作業履歴に残って文脈がぼやける…。

Claude Code の答え: プロンプトの頭に /btw を付けると、その質問と回答は 会話履歴に残らず 消えます。サイドクエストとして処理して、メインタスクの文脈はそのまま守れます。 

/btw この `--continue` フラグ、ちなみに何ができる？

★ 「ちなみに」レベルの軽い質問専用。重要な意思決定は普通に質問して履歴に残しましょう。

2. /rewind と /resume — セッション操作の使い分け

こんなとき: 作業を間違った方向に進めてしまった、または昨日の別作業に戻りたい。

Claude Code の答え: 役割が違う 2 つのコマンドを使い分けます。

★ /fork で分岐させた先のセッション ID は直後にメモしておくと、後で /resume で行き来しやすくなります。

3. 使用量は 5 時間ローリングウィンドウ

こんなとき: 「Pro プランの上限って深夜 0 時にリセットされる？」と気になった。

Claude Code の答え: 固定時刻のリセットではなく、使い始めたタイミングから 5 時間後 に枠が回復する方式です。Claude.ai と枠を共有しているので、ブラウザ版で重い処理をすると CLI 側にも影響します。

★ 朝 9 時に Phase 3 の /arscontexta:setup を回したら、リセットは 14 時頃。重い処理は時間帯を選んで走らせるとスムーズ。

B. 運用パターン（中級向け）

毎日触っていると見えてくる「設計の判断」「メンテのコツ」を集めました。慣れてきたら手を入れてみてください。

4. Claude Code のルール階層 — 7 つのレイヤー

こんなとき: CLAUDE.md とスキルとメモリ、それぞれに似たような指示を書けるけど、結局どれが効くの？

Claude Code の答え: 強い順に並べると、ユーザーの直接指示が最強で、デフォルトプロンプトが最弱です。

強さ 場所 効力
1（最強） ユーザーの直接指示（プロンプト） すべてを上書き
2 プロジェクト / グローバル CLAUDE.md セッション全体のベース指示
3 スキル（SKILL.md） 呼び出し時に注入される手順書
—（別系統） hooks（settings.json） Claude を経由せずハーネスが強制実行
4 memory（MEMORY.md） 参考情報として読まれる、優先度低め
5（最弱） デフォルトシステムプロンプト すべてに上書きされうる

★ 「絶対に毎回 X してほしい」は CLAUDE.md ではなく hooks に書きます。CLAUDE.md は判断レイヤー、hooks は強制レイヤー。

5. CLAUDE.md は「ファイル構造」ではなく「ルール」を書く

こんなとき: 新しいプロジェクトを始めて CLAUDE.md を書こうとしたら、ついディレクトリ構造ツリーを書きそうになった。

Claude Code の答え: ファイルツリーは Claude Code が ls で勝手に把握できます。CLAUDE.md に書くべきは、コードからは読み取れない判断基準・行動指針 — たとえば「コミットメッセージは日本語」「テスト失敗時はスキップせず根本原因を直す」など。

★ 「ここに何を書けばいいか」迷ったら、「これは未来の自分／他の Claude が見落とすかも」 と感じたルールだけを書く。

6. settings.json の整理は「壊れた permission」から

こんなとき: いつの間にか settings.json の allow リストが膨らんで、削除したディレクトリ参照やワンショットコマンドが残っている。

Claude Code の答え: 一度全部見直して、構造化された permission パターン（"Bash(git:*)" など）に圧縮します。one-shot の "Bash(echo hello)" のような具体コマンドは原則削除、許可は パターン単位 でまとめる。

★ "Bash(rm:*)" や "Bash(curl:*)" など破壊的・通信系は deny 側に書く方が安全です（CLAUDE.md より下のレイヤーで止まる）。

C. アーキテクチャの理解（上級向け）

Claude Code を「自分仕様の道具」として深く育てたい人向けの設計の話です。

7. セキュリティは「重要なほど下のレイヤーに重ねる」

こんなとき: --dangerously-skip-permissions で動かしたいけど、本当に何でもさせて大丈夫？

Claude Code の答え: 防御は 3 層あります。重要なルールほど下のレイヤーに重ねるのが鉄則。

★ 認証情報の保護は CLAUDE.md ではなく settings.json の deny に。怪しいコードを試すなら Docker。CLAUDE.md は薄い防御層と割り切る。

← 本編ページに戻る