🔥虚無との戦い

🤖Claude Code

9 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 にいろいろかく

記憶

CLAUDE.md

プロジェクト説明

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

Agentic Memory

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

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

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

docs

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

Tools

Skills(.claude/skills)

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

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

作り方

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

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'"
          }
        ]
      }
    ]
  }
}

権限設定

auto-accept mode

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

Yolo mode

全権限を与える.

claude —dangerously-skip-permissions, -y

コンテクスト管理

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

設計

Plan mode

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

思考レベルを指示

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

動作確認/テスト

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

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活用

claude code subagents

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

Agent Teams

Agent戦隊ゴレンジャー

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

ユースケース

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

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

エージェントハーネス

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

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

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

Refs

Journals

グラフビュー

バックリンク

Recents