Claude Code の実務ガイド・使い方
Claude Codeを個人開発・実務ワークフローに入れるための導入、設計、サブエージェント、MCP連携、失敗例をまとめます。
まず読む
Claude Code サブエージェントの作り方と使いどころ：.claude/agents の frontmatter
Claude Code のサブエージェントとは何か、.claude/agents/*.md の frontmatter(name / description / tools / model)での作り方、いつ使うべきかに冒頭で直接回答。公式ドキュメントを2026年9月14日に確認し、/agents の挙動変更も反映。
関連ツール
-
AGENTS.mdとCLAUDE.mdの違いと同期方法：@インポート・リンク・生成スクリプト・モノレポ配置
CodexとClaude CodeがAGENTS.md・CLAUDE.mdをどの順で読むかを公式ドキュメントで確認し、3つの同期方式とモノレポ3階層での読み込みをWindowsで実測。2026年9月14日時点の挙動です。
agents-md / claude-code / codex / workflow / troubleshooting -
AGENTS.mdテンプレート集：Next.js・Rails・FastAPI・Go・Astro のスタック別雛形
AGENTS.mdをNext.js / Rails / FastAPI / Go / Astroの5スタック向けに、コマンド・ディレクトリ構成・テスト方針・禁止事項・PRルールの型で各30〜45行にまとめました。構成とコマンドは各フレームワークの公式ドキュメントで2026年9月14日に確認したものだけを使っています。
agents-md / claude-code / codex / workflow / tips -
Claude Code hooksレシピ7本：危険コマンド阻止・.env保護・自動整形・Stopでテスト
Claude Code hooksレシピ7本。PreToolUseでrm -rfや.envを止め、PostToolUseで整形、Stopでテストを差し戻す設定を、Windowsでの実行出力付きで紹介。導入前に決める安全境界も整理。
claude-code / workflow / security / hooks / mcp / agent-ops -
Claude Codeのログイン・OAuthエラー対処：/loginが通らない・APIキーが勝つ・組織違い
Claude Codeで/loginが失敗する、ブラウザが開かない、ANTHROPIC_API_KEYが勝ってサブスクが使われない、組織アカウントを取り違えるといった認証トラブルを、公式docsの認証優先順位とclaude auth系コマンドの実出力で整理します（2026-09-14確認）。
claude-code / troubleshooting -
Claude Codeの使用上限（5時間・週次）の仕組み、Pro/Max別の枠と止まった時の対処
Claude Codeの5時間セッション上限と週次上限の仕組み、Pro・Max 5x・Max 20x・Team・API従量の料金と枠の違い、上限で止まった時の選択肢、/usageの読み方、枠を延ばす実務を公式docsで整理。
claude-code / troubleshooting / tips / anthropic / 個人開発 -
Claude Code settings.json 逆引き：3層の優先順位・permissions・hooks・env
Claude Codeのsettings.jsonをユーザー/プロジェクト/ローカルの3層と優先順位から整理し、permissions・hooks・env・model・statusLineの主要キーを公式ページで確認。用途別コピペ例と、壊れた設定の見つけ方を2.1.261の実出力付きでまとめます(2026-09-14確認)。
claude-code / json / workflow -
Claude Code Skills(SKILL.md)の作り方：配置・frontmatter・呼ばれ方と使い分け
Claude Code の Skills を SKILL.md 1枚で作る手順を、置き場所、公式 frontmatter、コマンド出力の埋め込み、自動で呼ばれる条件、CLAUDE.md や hooks との使い分けで整理。2.1.261 の claude -p で呼び出しを確認した出力付き(2026-09-14)。
claude-code / workflow / agents-md -
Claude Codeのアップデートが反映されない：自動更新の仕組み・claude update・二重インストール
Claude Codeのバージョンが古いまま、claude updateしても変わらない、警告が出続ける原因(自動更新の反映タイミング、DISABLE_AUTOUPDATER、ネイティブとnpm/WinGetの混在、PATH順序)と対処を、公式ページと2.1.261の実出力で整理(2026-09-14確認)。
claude-code / troubleshooting / npm -
Claude Code Windowsネイティブのトラブル：Git Bash・PowerShell実行ポリシー・パス・改行
Windows 11でClaude Codeをネイティブ実行したときの詰まりどころ(Git Bashが見つからない、実行ポリシー、パス区切りと改行、ネイティブ版とnpm版の混在、WSLとの使い分け)を、公式ページと手元Windows 11 Proの実測で整理(2026-09-14確認)。
claude-code / windows / troubleshooting -
契約書レビューをClaude Code+e-Gov法令MCPで回す実務フロー：条文特定から人の確認まで
契約書レビュー・コンプライアンス確認をClaude Codeとe-Gov法令MCPで進める手順。対象条文の特定、asofでの施行時点確認、条文引用、人が確認する境界の順に、フリーランス法・取適法をe-Gov法令API v2で実際にcurl実行した2026-09-14のログを根拠に解説。CLAUDE.md追記例付き。
legal-tech / japanese-law / egov / claude-code / workflow -
法令改正チェックを定期実行する：e-Gov法令API law_revisions の差分検知とClaude Code連携
e-Gov法令API v2の law_revisions を定期取得し、履歴IDと施行状態の変化を検知する70行のNode.jsスクリプトを実行確認。変化時だけ claude -p で要約し、タスクスケジューラやcronで回す設計を2026年9月14日の実測で整理します。
egov / japanese-law / legal-tech / claude-code / workflow / automation / windows -
e-Gov法令API v2エンドポイント逆引きリファレンス：6本の用途・パラメータ・実測レスポンス
e-Gov法令API v2の6エンドポイント（laws / law_revisions / law_data / keyword / law_file / attachment）を、やりたいこと別に逆引きできる形で整理。全エンドポイントをcurlで実行し、主要パラメータと応答を2026年9月14日に実測しました。
egov / japanese-law / legal-tech / api / json / mcp / claude-code -
国会会議録APIをMCPサーバー化する：TypeScript最小実装とClaude Code登録まで
国会会議録検索APIをMCP TypeScript SDK v2(@modelcontextprotocol/server 2.0.0)でstdioサーバーにする手順。検索・発言取得の2ツール、出典を返すoutputSchema、JSON-RPCを直接流した動作確認ログ、claude mcp addの構文まで(2026-09-14実測)。
mcp / diet / ai-agent / claude-code / stdio / json -
ローカルLLMをClaude Code / Codex CLIから使う：Ollama接続の実行ログと限界、使い所
Ollamaのモデルを Claude Code（ANTHROPIC_BASE_URL）と Codex CLI（--oss）から呼ぶ手順と、RTX 3090での実行ログ（2026-09-14）、ローカルに任せる作業の判断基準を整理します。
local-llm / ollama / claude-code / codex-cli / コスト管理 / セキュリティ -
AIエージェントに「原因調査だけ」を任せる依頼テンプレート
CodexやClaude Codeに修正を許可せず、再現条件・根拠・反証・影響範囲まで調査させるプロンプトと受け入れ基準を解説します。
ai-agent / debugging / prompts / agent-ops / codex / claude-code -
「下請法」で法令検索すると0件になる｜通称と現行法令名のズレをMCPで埋める
e-Gov法令MCP(@codeagentjp/egov-law-mcp)のsearch_lawsは法令名マッチのため、下請法・電帳法・景表法といった通称は0件で返ります。実測ログをもとに、通称→正式名称の解決手順と、改題された法令の扱いを整理します。
mcp / claude-code / cursor / egov / japanese-law / troubleshooting -
ハーネスエンジニアリング入門: 60行の自作エージェントでClaude Codeの中身を理解する
ハーネスエンジニアリングとは何かを馬具のたとえと3層の進化で整理し、Python約60行の最小ハーネスを自作して、エージェントループ・ツール実行・ガードレールの仕組みをコードで理解します。
harness-engineering / ai-agent / claude-code / python / tool-use / claude-api / context-engineering / prompt-engineering -
egov-law-mcpが動かない時の対処法｜npx・Node.js・Windows接続エラー
e-Gov法令MCP(@codeagentjp/egov-law-mcp)がClaude CodeやCursorで接続失敗する時の切り分け手順を、npx解決、Node.jsバージョン、Windows固有、e-Gov API側の4段階で解説します。
mcp / claude-code / cursor / egov / japanese-law / npm / troubleshooting -
国会の情報を AI エージェントから引く——houan-mcp の7つの実用ユースケース
Claude Desktop / Claude Code / Cursor から国会会議録と議案情報を出典付きで引ける @codeagentjp/houan-mcp の使いどころを、記者・法務・研究者・市民目線で7つのユースケースに整理します。答弁検索、法案ウォッチ、大臣発言の時系列追跡まで。
mcp / houan / japanese-diet / ndl-kokkai / legal-tech / policy-tech / claude-code / ai-agent -
AGENTS.md完全ガイド — Codex・Cursor・Clineで共通のエージェント指示を書く
AGENTS.mdは複数のコーディングエージェントが参照する共通指示ファイルです。CLAUDE.mdとの違い、書くこと・書かないこと、ツール別の読まれ方、更新と刈り込みの運用を整理します。
agents-md / claude-code / codex-cli / cursor / instructions / workflow / agent-ops -
AIエージェントに秘密情報を読ませない — .gitignore・権限・sandboxの実務
鍵やトークンをAIエージェントとログから守る方法を、読ませない・コミットさせない・残さないの3層で解説します。
security / secrets / claude-code / permissions / tips -
AIコーディングエージェントとは？用途・予算・チーム規模で選ぶ比較ガイド
AIエージェントとは何か、チャットAIとの違いから、Claude Code・Codex CLI・Cursor・Cline・Roo Code・Copilotの選び方までを、統合形態・コスト・秘匿性・チーム規模の4軸で整理します。
claude-code / codex-cli / cursor / cline / roo-code / ai-agent / comparison / selection -
Claude Codeのコンテキストが壊れた時の復旧 — /clear・/compact・/rewindの使い分け
Claude Codeが指示を忘れる・同じ失敗を繰り返す時は、積み増しより作り直しが速いです。/clear・/compact・/rewindが何を消すかで選びます。
claude-code / context / tips / troubleshooting -
サブエージェント・スキル・MCP・hooks・コマンドの使い分け早見表
Claude Code のサブエージェント、スキル、MCP、hooks、コマンドは「コンテキストを汚さず・確実に・拡張する」の3目的で役割が分かれます。早見表で一発整理します。
claude-code / subagents / skills / mcp / hooks / workflow -
Claude Codeをヘッドレス実行する — claude -p でCI・GitHub Actions・スクリプト自動化
claude -p なら対話なしでワンショット実行できる。output-format で text/json/stream-json を選び、allowedTools で操作を絞り、CI・pre-commit・バッチに安全に組み込む手順を実例でまとめる。
claude-code / ci / github-actions / automation / headless / workflow -
Claude Codeの権限プロンプトを減らす設定 — allowlist・autoモード・sandboxの使い分け
Claude Codeの確認プロンプトが多すぎる時の安全な減らし方。allowlist・autoモード・sandboxの違いと向き不向き、settings.jsonの設定例、非対話実行の注意までを実務目線で整理します。
claude-code / permissions / settings / sandbox / tips -
MCP入門 — 仕組み・繋ぎ方・最初に入れるサーバーを実例で理解する
MCPはAIに外部ツールやデータを差し込む共通規格です。仕組み、用語、claude mcp addでの繋ぎ方、最初に入れると効くサーバーの型まで初学者向けに整理します。
mcp / claude-code / getting-started / foundations / tools -
MCPサーバーが繋がらない時のチェックリスト — claude mcp add・stdio・HTTP・環境変数
MCPサーバーが繋がらない原因の多くはコマンドパス・作業ディレクトリ・環境変数・トランスポート種別の取り違えです。stdioとHTTPの違いから切り分け手順までまとめます。
mcp / claude-code / troubleshooting / stdio / tips -
仕様駆動でAIエージェントに実装させる — SPEC.md・依頼テンプレート・よくある失敗5つ
大きめの機能は仕様を固める会話と実装する会話を分けると手戻りが減ります。SPEC.mdを書かせて新セッションで実装させる手順に加え、依頼テンプレートとClaude Code/Codexでよくある失敗5つを整理します。
spec-driven / claude-code / codex / planning / workflow / ai-agent / 個人開発 / troubleshooting -
ローカルLLMの費用回収：削減できる月額から電気代を引いて比べる
GPU初期費用13万円・月額削減3,000円・電気代651円という仮定なら単純回収は約55.3か月。契約を維持する場合との違い、測定済みベンチマークの範囲を整理します。
local-llm / cost / ollama / claude-code / codex-cli -
ローカルLLMとクラウドの比較：J-WorkBenchの相対得点と測定の限界
2026年6月6日のJ-WorkBench保存記録を読み解きます。クラウド比66〜87点という相対指標、カテゴリ別の品質、AI採点の制約を整理。実業務を同じ割合で自動化できるという測定ではありません。
local-llm / ollama / claude-code / codex-cli / benchmark / rag -
自分のPCで J-WorkBench を回す — ローカルLLM実務ベンチの再現手順
日本語実務ベンチ J-WorkBench を自分のPCで再現する手順。Ollamaでモデルをpullし、npm run bench で7カテゴリを採点、結果からサイト用データを生成するまでを通しで解説します。サブスクCLIのフラグは要検証。
local-llm / ollama / benchmark / claude-code / codex-cli -
Claude Codeでe-Gov法令を検索する｜egov-law-mcpの設定と使い方
e-Gov法令MCPをClaude Code、Claude Desktop、Cursorへ追加し、法令検索・条文取得・関連法令確認を出典URL付きで行う手順を解説します。
mcp / claude-code / cursor / egov / japanese-law / legal-tech / npm -
houan-mcpで関連法案を検索する: 議事録公開前の調査フロー
議事録公開前に、衆参の公式議案情報から関連法案を探す方法を @codeagentjp/houan-mcp の実演として整理します。
mcp / claude-code / diet / japanese-law / legal-tech / npm -
e-Gov法令MCPとは？Claude Codeで日本法令を参照する設計と作り方
e-Gov法令APIをClaude CodeやCursorから使うMCPサーバーの仕組み、stdio設定、出典付き条文取得、安全境界、既存実装との差別化を解説します。
mcp / egov / japanese-law / legal-tech / claude-code / source-attribution -
Claude Code導入ガイド: Windows/macOS/WSLと初期設定
Claude Codeを始める個人開発者向けに、macOS、Windows、WSLでの導入手順とCLAUDE.mdの初期設定を整理します。
claude-code / 導入 / windows / macos / wsl / 個人開発 -
Claude Code サブエージェントの作り方と使いどころ：.claude/agents の frontmatter
Claude Code のサブエージェントとは何か、.claude/agents/*.md の frontmatter(name / description / tools / model)での作り方、いつ使うべきかに冒頭で直接回答。公式ドキュメントを2026年9月14日に確認し、/agents の挙動変更も反映。
claude-code / サブエージェント / subagent / ワークフロー / 個人開発 -
Claude CodeとCodexはどっち？違い・比較・使い分けを個人開発目線で解説
Claude CodeとOpenAI Codexはどっちを使うべきか。違い、比較ポイント、個人開発での使い分け、料金・権限まわりの注意点を実務目線で整理します。
claude-code / codex / openai / anthropic / 比較 / どっち / 個人開発 / ai-agent