🔥虚無との戦い

🤖Claude Code

12 min read

ターミナル常駐型のCoding Agent/CLIツール.

Claude Code 概要 - Anthropic

設計思想

Vim, VSCode, Zed, 全員が使える共通のインターフェースとして、ターミナルが選択された. ターミナルは最も汎用的で、既存のワークフローに組み込みやすい.

Config

# windows
~/.config/Claude/claude_desktop_config.json
 
# linux(WSL2)
~/.claude.json
  • Windows Desktopとは共有不可.
  • Win/WSL2はシンボリックリンクで共有可能.

quick references

commands

  • claude # 対話セッションを開始
  • claude —continue # 直近のセッションを継続
  • claude —resume # 過去のセッションから選択して再開

操作

  • !: bash mode
  • #: memory mode
  • @: file 追加
  • Alt+Enter: 改行

IDE連携

  • @でファイルパス指定.
  • Ctrl+Alt+kで選択範囲をターミナルにペーストできる.
  • cursorのタブは開閉ができないのでterminalがいいかも.

会話履歴/セッション

  • sessionID は UUID v4 で、セッション開始時に自動生成されます
  • ~/.claude/projects//.jsonl

turn

tool呼び出しの単位. max-turnsを指定するとコスト管理できる.

MCP

https://docs.anthropic.com/ja/docs/claude-code/mcp

  • user: ~/.claude.json に追加.
claude mcp add -s user context7 -- cmd /c npx @upstash/context7-mcp@latest

設定(.claudes)

Commands

検索だけgemini-cli

AIコマンドで長文を与える/文字化け対策

AI.md

@AI_INSTRUCTIONS.md

AI_INSTRUCTIONS.md にいろいろかく

Tools

Subagents(/agents)

独立コンテキストのAgents.

  1. 会話中に @manager で呼ぶ（推奨）
  2. セッション全体をmanagerとして起動
  3. 自動委任(不確実)

サブエージェントは「調べてくる秘書」. 仕事を丸投げして結果の報告を受け取りたいとき.

Skills(.claude/skills)

再利用可能な指示書・ガイドライン

  • Skillsは、Claudeに領域固有の専門知識を提供する再利用可能なファイルシステムベースのリソース
  • Skillsはオンデマンドで読み込まれ、複数の会話で同じガイダンスを繰り返し提供する必要がなくなります。
  • 用途: 知識共有、軽量なワークフロー、規約の提供
    • Skillsは知識ではなく手順の自動化
    • 毎回同じ手順を踏む作業」にのみ価値があります
  • 25/12にリリースされた機能. comandsはレガシー、skillsに統合.
  • Agent Skills - Claude API Docs
  • <2026-02-01 Sun 16:32>今までは自分でdocs配下に手順書を作成していたが、これを置き換えることができそうだ.

作り方

専用コマンドはない. 会話か手動でつくる.

リファレンスコンテンツ

Claude が現在の作業に適用する知識を追加します。規約、パターン、スタイルガイド、ドメイン知識

このコンテンツはインラインで実行されるため、Claude は会話コンテキストと一緒にそれを使用できます。

<2026-03-19 Thu 13:05>これはフォルダ+SKILL.mdでなくてもいい。コマンドではない.

vs subagents

  • 本質: 独立した専門AIアシスタント
  • 実行環境: 完全に隔離された独自のコンテキスト

Hooks(.claude/hooks/)

ガードレール

  • 編集後にフォーマッター実行
  • auth・billing・migrationsなど危険なディレクトリをブロック
  • モデルは忘れるが、Hooksは忘れない

https://docs.anthropic.com/ja/docs/claude-code/hooks

  • 型チェック
  • linter
 {
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "npm run check || echo 'Type check completed'"
          }
        ]
      }
    ]
  }
}

Skills vs Subagents

  • Skills
    • ユーザーが直接呼べる
  • Subagents
    • 他のスキルやワークフローの部品として繰り返し呼ばれる場合に向いています

権限設定

auto-accept mode

編集権限をすへて与える. 注意点はbash commandではないこと. 自走させるにはさらに設定が必要.

Yolo mode

全権限を与える.

claude —dangerously-skip-permissions, -y

コンテクスト管理

  • /clear: コンテクストリア
  • /compact: コンテクスト要約
  • Esc: 方向性がへんならばすぐに止める

調査

  • WebSearch: 検索
  • WebFetch: URL指定して全文取得

設計

Plan mode

plan mode: 初めに計画. shift+tab x 2

思考レベルを指示

  • think - 基本的な思考
  • think hard - より深い思考
  • think harder - さらに深い思考
  • ultrathink - 最大限の思考時間

動作確認/テスト

  • 権限をある程度与えないとすぐ止まる.

ドキュメント管理/記憶

CLAUDE.md

プロジェクト説明

  • 目的・構造・ルールだけを短く書く
  • 長くなるほど重要な文脈を見落とす
  • # から入力することで追加

Agentic Memory

短期記憶、セッションでcontextが増えてきたら一時保存して情報を引き継ぐ.

  • MEMORY.md はcladue codeが読み書きするので人間はみない.
  • 200行程度なので古い記憶は自動削除される.

https://docs.anthropic.com/ja/docs/claude-code/memory

docs

  • 長期記憶.
  • git管理するドキュメント. 設計とか. 自動で参照させるには、CLAUDE.mdからの参照をいれる.

best practice

  • CLAUDE.mdは「AIのオンボーディング」（80-200行）— 毎セッション読み込まれるので厳選
  • docs/は「深い参照レイヤー」— CLAUDE.mdから「〇〇実装時は docs/xxxを参照」とトリガーで誘導
  • Claudeが公開ドキュメントから推論できる情報は不要

claude code subagents

  • Claude Code のサブエージェントは、別のサブエージェントを起動できません。

https://docs.anthropic.com/ja/docs/claude-code/sub-agents

Other Tips

https://www.anthropic.com/engineering/claude-code-best-practices

GitHub CLI

コスト確認

https://github.com/ryoppippi/ccusage

npx ccusage@latest          # 日次の使用量とコストを表示
npx ccusage@latest blocks   # 現在のセッションブロックを確認

マルチエージェント/並列化

Claude code 並列実行

Claude Codeの他のツールに対する優位点は、ターミナルなので軽いということ.

  • <2025-08-02 Sat 11:08> packageのインストールや環境変数が面倒なのでやるならscriptで自動化しないといけない.

tmux活用

Orchestrator-Workers パターン

リードエージェントと複数体のサブエージェント. 並列実装ならばエージェントチームでなくてもいい.

Generator-Evaluator Pattern

GANに発想を得て、AIにダメ出しをさせるとうまく言った.

  • planner: 1〜4文の短いプロンプトを、詳細なプロダクト仕様に拡張する。AI機能を仕様に組み込む役割も担う。
  • generator: スプリント単位で1機能ずつ実装し、各スプリント後に自己評価してQAに引き渡す。React・Vite・FastAPI・SQLiteスタックを使用。
  • Evaluator: Playwright MCPを使って実際のアプリを操作し、UIのバグやAPIエンドポイント、データベース状態を検証して採点する
  • https://www.anthropic.com/engineering/harness-design-long-running-apps, 26/03/24
    • 「ブラウザ上でWeb Audio APIを使った完全なDAWを構築せよ」という1行のプロンプトから、約4時間・$124.70のコストで完璧なDAWを作成. Claude codeをつかったDTMの可能性をここに見出した. やっぱりなんでもできそうだ.

Agent Teams

Agent戦隊ゴレンジャー

Claude Code セッションのチームを調整する - Claude Code Docs

ユースケース

  • 調査とレビュー
  • 新しいモジュールまたは機能
  • 競合する仮説でのデバッグ
  • クロスレイヤー調整

<2026-03-13 Fri 11:25>Sonnetだからか、そこまでtoken消費はなかった. 設計だけopusにするべきだったか.

エージェントハーネス

長時間稼働. 🤖エージェントハーネス

これは直列のシングルプロセスなので、マルチプロセスとは異なる論点.

Human-in-the-loopなくす

headless(-p)

claude cliからプロンプトを渡して起動するモード.

作業完了通知

  • BurntToastをつかう.
  • hooks利用.

https://github.com/Windos/BurntToast

remote-control

長時間かかるリファクタリングやビルドを走らせたまま外出し、スマホで進捗確認・メッセージ送信するといった使い方が主なターゲット.

任意のデバイスからローカルセッションを続行する Remote Control - Claude Code Docs

refs

PR駆動開発

GitHub Action

Max Planから.

plan modeをissueに引き継ぐ

plan modeが~/.claude/plans/*.mdにプランファイルを生成した後、特に/clearや新セッションをまたぐ場合にどうコンテキストを引き継ぐのがベストか

  • plan ファイルに含まれる

    • 最終的な設計判断
    • 変更ファイル一覧
    • 検証方法

  • plan ファイルに含まれない

    • 却下した代替案とその理由
    • なぜこの設計にしたか」の背景議論
    • 途中で気づいた既存コードの制約・注意点

「このプランに以下を追記して：

  • 却下した代替案とその理由
  • 既存コードで注意すべき制約
  • 実装時の判断基準（迷ったときの指針）」
  • フル: plan folderのmarkdownを貼り付ける

What Actually Is Claude Code’s Plan Mode? | Armin Ronacher’s Thoughts and Writings, 実態はmarkdownというもの.

<2026-03-16 Mon 13:03>VPSもローカルもrsyncすればいいだけか？todoもメモがいいかも.

/handoff カスタムコマンド

個人開発

GitHub連携は必要ない.

  • issueはローカルメモでいい
  • prはデスクトップ通知でいい

Refs

Plugins

Refs

Journals

グラフビュー

バックリンク

Recents