claude-code-tips — Claude Code 実践 Tips と dx プラグイン

何か

claude-code-tips は、YK（ykdojo）による Claude Code 運用 Tips 集。README に Tip 0–45 が並び、同じリポジトリが Claude Code プラグイン dx としても配布される。

対象読者は日々 Claude Code を使う開発者。スラッシュコマンド・コンテキスト管理・Git/gh 連携・隔離実行・Remote Control など、実務で効く手順が中心。

46

Tips (0–45)

8

dx skills

9

setup 項目

dx

plugin name

主要パス

claude-code-tips/
├── README.md              # Tip 0–45 の本体
├── CLAUDE.md / GLOBAL-CLAUDE.md
├── .claude-plugin/         # marketplace.json / plugin.json (dx)
├── skills/                 # gha, half-clone, handoff, …
├── scripts/                # context-bar, setup, half-clone-conversation
├── content/                # 派生記事・スライド・図
└── assets/                 # README 用画像

content/ には spectrum of agentic coding のスライド HTML、採用ストーリー、DX 提出メモなどが入る。運用の正本は README と skills/。

カテゴリ別の入口

46 Tips を主題で束ねた索引。詳細手順は README の各 Tip へ。

UI・入力

ステータス行、スラッシュ、音声、入力ショートカット、エイリアス。

Tip 0, 1, 2, 7, 10, 37

コンテキスト

新鮮な会話、/compact、handoff、half-clone、履歴検索。

Tip 5, 8, 12, 21

並列・Git

タブ cascade、worktree、gh / draft PR、指数バックオフ。

Tip 4, 13, 14, 15

検証・自律

write-test サイクル、TDD、出力検証、背景 bash / subagent。

Tip 9, 26, 33, 35

隔離・遠隔

コンテナ / 専用機、auto mode、Remote Control、アカウント切替。

Tip 19, 31, 32, 45

拡張と学習

CLAUDE.md vs Skills、dx 導入、setup.sh、継続学習。

Tip 23, 28, 42, 43, 44

まず押さえる 8 Tips

Tip	要点
`0`	`scripts/context-bar.sh` でモデル・git・トークン使用率をステータス行表示
`3`	大きな問題を小さな issue に分解してから解く
`5 / 8`	コンテキストは新鮮なほど強い。handoff 後に新規会話
`14`	同一リポの並列作業は git worktree（ブランチ + ディレクトリ）
`19`	長時間・高リスクはコンテナ or 専用機 + skip-permissions
`21`	`/branch`・`--fork-session`・half-clone で会話を分岐・圧縮
`23`	CLAUDE.md / Skills / Slash / Plugins の役割分担
`43 / 44`	dx プラグイン導入、または `setup.sh` で一括設定

CLAUDE.md / Skills / Slash / Plugins

Tip 23 の整理。似た機能が並ぶため、読み込みタイミングと配布単位で選ぶ。

flowchart TD
  A["毎回ロード"] --> B["CLAUDE.md
project / global"]
  C["必要時だけ"] --> D["Skills
Claude 起点が主"]
  C --> E["Slash Commands
ユーザー起点が主"]
  F["配布単位"] --> G["Plugins
skills / hooks / MCP 等を束ねる"]
  D --> G
  E --> G
  B -.->|"トークン常駐"| H["簡潔に保つ"]
  D -.->|"遅延ロード"| I["トークン節約"]

仕組み	いつ載るか	向き
CLAUDE.md	全会話の先頭に常時	プロジェクト説明・繰り返し指示。短いほどよい
Skills	関連時に自動、または `/skill`	手順付きの再利用ワークフロー
Slash Commands	明示的に起動	ユーザーがタイミングを制御したい操作
Plugins	インストール単位	skills / hooks / MCP などをまとめて配布（例: `dx`）

注: Claude Code 2.1.3 以降、Skills と Slash Commands は統合方向。意図の違いは「誰が主に起動するか」。Skills は Claude 向け、Slash はユーザー向けとして設計されてきた。

同梱スキル

リポジトリはプラグイン名 dx（developer experience）。marketplace ykdojo から入れる。

コマンド / スキル	役割	関連 Tip
`/dx:gha <url>`	GitHub Actions 失敗の調査（ジョブ単位の履歴・flaky・breaking commit）	27
`/dx:handoff`	`HANDOFF.md` を書いて次エージェントへ引き継ぎ	8
`/dx:half-clone`	会話後半だけクローンしてトークン削減	21
`/dx:reddit-fetch`	Reddit JSON（DuckDuckGo hop でセッション確保）	—
`/dx:review-claudemd`	直近会話から CLAUDE.md 改善案	28
`/dx:hn-summarize`	Hacker News 上位・スレッド要約（公式 API）	—
`/dx:version-check`	Claude Code の更新可否・ピン推奨	—
`/dx:private-github-search`	ローカル mirror + ripgrep で private 含む全文検索	—

claude plugin marketplace add ykdojo/claude-code-tips
claude plugin install dx@ykdojo

推奨コンパニオン: Playwright MCP（ブラウザ自動化。Tip 9）。

setup.sh（Tip 44）

対話式で複数推奨設定をまとめて入れるスクリプト。スキップ番号を指定できる。

bash <(curl -s https://raw.githubusercontent.com/ykdojo/claude-code-tips/main/scripts/setup.sh)

#	区分	内容
1	Install	DX プラグイン
2–7	`~/.claude/settings.json`	status line / 自動更新オフ / MCP lazy-load / `Read(~/.claude)` / `Read(//tmp/**)` / attribution 無効
8–9	shell	aliases（`c`/`ch`/`cs`）と `--fs` → `--fork-session`

ステータス行だけ入れる場合

scripts/context-bar.sh を ~/.claude/scripts/ にコピーして実行可能にする
~/.claude/settings.json の statusLine.command にパスを指定
必要ならスクリプト先頭の COLOR（orange / teal / …）を変更。プレビューは scripts/color-preview.sh

表示例: モデル名・cwd・ブランチ・未コミット数・origin 同期・コンテキスト使用率バー・直前メッセージ。

圧縮と分岐

01

新しい話題は新会話

Tip 5。長い履歴は性能を下げる。トピック切替で /clear か新規セッション。

02

handoff してから切る

Tip 8 / /dx:handoff。Goal・進捗・成功失敗・Next を HANDOFF.md に書いてパスだけ渡す。

03

fork / half-clone

Tip 21。/branch や --fork-session で分岐。長い会話は後半だけクローン。

04

85% で半クローン提案

任意 hook: scripts/check-context.sh を Stop hook に。auto-compact はオフ推奨。

half-clone の権限: 会話履歴読み取りのため、グローバル settings に Read(~/.claude) を許可するとプロンプトが減る（Tip 21）。

{
  "permissions": {
    "allow": ["Read(~/.claude)"]
  }
}

実行モードの段階

レベル	手段	用途
default	手動承認 / auto mode（Shift+Tab）	通常開発。auto は機械的承認疲れを減らす（Tip 31）
container	`--dangerously-skip-permissions` in sandbox	長時間研究・実験。safeclaw 等（Tip 19）
dedicated Mac	computer use 可能な専用機	claude-controls-mac（Tip 19）
remote	`/remote-control` / `claude remote-control`	スマホから操作。隔離環境以外は慎重に（Tip 32）

並列作業

タブ cascade（Tip 13）: 新規タスクは右にタブ追加。左→右で古い順に巡回。同時は 3–4 本程度。
worktree（Tip 14）: ブランチごとに別ディレクトリ。同じプロジェクトの衝突を避ける。
tmux ワーカー（Tip 19）: 外側 Claude が tmux send-keys / capture-pane でコンテナ内 Claude を操縦。

公式・関連

GitHub: ykdojo/claude-code-tips — Tips 本体と dx プラグイン
Quick demo — マルチ Claude + 音声入力
Claude Code Masterclass — 関連トーク
safeclaw — コンテナ実行プリセット
claude-controls-mac — 専用 Mac セットアップ
Remote Control docs
r/ClaudeAI — コミュニティ Tips