Claude Code の実務ガイド・使い方
Claude Codeを個人開発・実務ワークフローに入れるための導入、設計、サブエージェント、MCP連携、失敗例をまとめます。
まず読む
サブエージェントの使いどころ: Claude Code の Task ツールで設計を分離する
Claude Code のサブエージェントを、文脈分離・並列化・役割分担の観点で、個人開発でどう使えば効くのかを整理します。
関連ツール
-
その条文は「現在」のものです｜e-Gov法令API v2の時点指定(asof)と通称検索を実測
e-Gov法令API v2はasofパラメータで過去時点の条文を返し、法令名検索が通称(abbrev)にもマッチします。v1しか叩いていないegov-law-mcp 0.1.0では何が引けないのかを、下請法の改題を題材に実測ログで確認します。
mcp / claude-code / egov / japanese-law / legal-tech / troubleshooting -
「下請法」で法令検索すると0件になる｜通称と現行法令名のズレをMCPで埋める
e-Gov法令MCP(@codeagentjp/egov-law-mcp)のsearch_lawsは法令名マッチのため、下請法・電帳法・景表法といった通称は0件で返ります。実測ログをもとに、通称→正式名称の解決手順と、改題された法令の扱いを整理します。
mcp / claude-code / cursor / egov / japanese-law / troubleshooting -
Claude Opus 5の実力：Fable級を半額で使えるのか
Claude Opus 5の実力、料金、Fable 5・Sonnet 5との違い、Claude CodeとAPIの移行注意点を、Anthropic公式情報から実務目線で解説します。
claude / claude-opus-5 / anthropic / claude-code / ai-agent / api-cost -
ハーネスを60行で自作する: Claude Codeの中身を理解する最短ルート
Claude Codeの正体である「ハーネス」をPython約60行で自作し、エージェントループ・ツール実行・ガードレールの仕組みをコードで理解します。写経して動かせる最小実装付き。
harness-engineering / ai-agent / claude-code / python / tool-use / claude-api -
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 -
AIエージェントに秘密情報を読ませない — .gitignore・権限・sandboxの実務
鍵やトークンをAIエージェントとログから守る方法を、読ませない・コミットさせない・残さないの3層で解説します。
security / secrets / claude-code / permissions / tips -
AIコーディングエージェント選定ガイド — 用途・予算・チーム規模から選ぶ
AIコーディングエージェントはどれを選ぶべきか。唯一の正解はなく、統合形態・コスト・プライバシー・チーム規模の4軸で分岐します。主要5候補を実務目線で整理します。
claude-code / codex-cli / cursor / cline / 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を書いて新セッションで作らせる
大きめの機能は「仕様を固める会話」と「実装する会話」を分けると手戻りが減ります。SPEC.mdをエージェントに書かせ、クリーンな新セッションで実装させる3ステップを解説します。
spec-driven / claude-code / planning / workflow / ai-agent -
ローカルLLMの損益分岐 — サブスク定額で考える3つの分岐点
ローカルLLMがクラウドより得になるのはいつか。token従量ではなく定額サブを前提に、GPU中古相場・電気代・サブスク月額の概算から、ローカルが効く3パターン（機密/上限超え/共有）を比較します（数値は概算）。
local-llm / cost / ollama / claude-code / codex-cli -
自分のPCで J-WorkBench を回す — ローカルLLM実務ベンチの再現手順
日本語実務ベンチ J-WorkBench を自分のPCで再現する手順。Ollamaでモデルをpullし、npm run bench で7カテゴリを採点、結果からサイト用データを生成するまでを通しで解説します。サブスクCLIのフラグは要検証。
local-llm / ollama / benchmark / claude-code / codex-cli -
ローカルLLMはクラウドの何割を肩代わりできるか — J-WorkBench クラウド代替率
日本語の実務7カテゴリで、手元PC（RTX 3090）のローカルLLMがサブスク版クラウドの何割を代替できるかを5軸で測ったベンチ J-WorkBench の実測結果。代替率66〜87%の正直な内訳、互角と苦戦の境界、向く/向かないケースを整理します。
local-llm / ollama / claude-code / codex-cli / benchmark / rag -
Claude Code公式ベストプラクティス全訳＋実例補完(2026年5月版)
Anthropic公式 Best practices for Claude Code を、節ごとに日本語要約と国内開発者向けの実例で再構成。CLAUDE.md・権限・MCP・サブエージェント・並列実行までの判断材料を1本でつかむ。
claude-code / ベストプラクティス / anthropic / claude-md / workflow -
ハーネスエンジニアリング入門: LLMの周りを"配線する"設計
2026年に第3の柱として浮上したハーネスエンジニアリングを、馬具メタファーから3層比較、エージェント・ループ、Claude Code/Cursor/Codexの設計差まで図解で整理します。
harness-engineering / ai-agent / claude-code / context-engineering / prompt-engineering / agents-md -
ライブコーディングでHTML・Markdown・JSONを使い分けるベストプラクティス
AIエージェント時代のライブコーディングで、Markdown、HTML、JSON、YAML、JSX/TSXをどう分業すべきか。仕様、提示、契約、設定、実装の責務ごとに整理します。
live-coding / markdown / html / json / yaml / tsx / claude-code / vscode -
ソブリンクラウドとは何か — AIコーディングエージェント時代のデータ主権を整理する
ソブリンクラウド（主権クラウド）の4つの主権、注目される背景、Claude Code・Codex などAIコーディングエージェント利用時に見落としがちなデータ主権の論点を整理します。
sovereign-cloud / data-sovereignty / security / claude-code / codex / enterprise -
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/Codexで失敗する5つの理由と回避策
AI駆動開発がうまくいかない個人開発者向けに、失敗の典型5パターンと、AGENTS.md・タスク分割・検証設計での回避策を整理します。
失敗 / トラブルシュート / claude-code / codex / ai駆動開発 / agents-md / 個人開発 / コスト管理 -
AIエージェントに実装を任せる前に書くべき指示テンプレート
AIエージェントに実装を任せる前に、何をどう書けば失敗しにくいかをテンプレート付きで解説します。
ai-agent / プロンプト設計 / 指示テンプレート / 個人開発 / claude-code / codex -
AIエージェントとは何か: ChatGPTとの違いと、個人開発での使い方
AIエージェントとは何か、ChatGPTとの違い、個人開発でどの作業を任せるべきかを実務目線で解説します。
ai-agent / 個人開発 / claude-code / codex / cursor / cline -
Claude Code導入ガイド: Windows/macOS/WSLと初期設定
Claude Codeを始める個人開発者向けに、macOS、Windows、WSLでの導入手順とCLAUDE.mdの初期設定を整理します。
claude-code / 導入 / windows / macos / wsl / 個人開発 -
サブエージェントの使いどころ: Claude Code の Task ツールで設計を分離する
Claude Code のサブエージェントを、文脈分離・並列化・役割分担の観点で、個人開発でどう使えば効くのかを整理します。
claude-code / サブエージェント / subagent / ワークフロー / 個人開発 -
Claude CodeとCodexはどっち？違い・比較・使い分けを個人開発目線で解説
Claude CodeとOpenAI Codexはどっちを使うべきか。違い、比較ポイント、個人開発での使い分け、料金・権限まわりの注意点を実務目線で整理します。
claude-code / codex / openai / anthropic / 比較 / どっち / 個人開発 / ai-agent -
Claude Opus 4.7徹底調査: 何が進化し、どこに注意すべきか
Claude Opus 4.7の新機能・破壊的変更・コスト構造・Claude Code品質問題ポストモーテムまで、移行前に知るべきポイントを実務目線で整理します。
claude / claude-opus-4-7 / anthropic / claude-code / ai-agent / api-cost -
Cursor/Cline/Roo Code比較2026: 役割別の選び方
Cursor、Cline、Roo Codeをアーキテクチャ、コスト、運用方針で比較し、速度重視・安全重視・カスタム重視の選び方を整理します。
cursor / cline / roo-code / ai-agent / ツール比較 / ide / claude-code -
Cursor/Cline/Claude Code比較: エディタ統合AIの選び方
Cursor、Cline、Claude Codeを機能、料金、自由度の観点から比較し、用途別の使い分けを整理します。
cursor / cline / claude-code / 比較 / エディタ統合 -
ローカルLLMでAIコーディング: Qwen Coder/DeepSeek-Coderの使い所
クラウドLLMを使いにくい場面で、Qwen CoderやDeepSeek-Coderをローカル実行し、開発ワークフローに載せる判断軸を整理します。
local-llm / qwen-coder / deepseek-coder / claude-code / コスト管理 / セキュリティ -
AGENTS.md / CLAUDE.mdに何を書くべきか: AIエージェント用ルールの最小形
AIエージェントに毎回同じ説明をしないために、プロジェクトルール、禁止事項、検証手順を短く保つ書き方をまとめます。
agent-ops / claude-code / prompts -
MCPとhooksを入れる前に決める、AIエージェントの安全境界
MCPで外部ツールを接続し、hooksで自動化する前に決めておきたい権限・ログ・停止条件を整理します。
agent-ops / mcp / hooks / claude-code