Claude Code入門|公式ベストプラクティスとJob-Automate

AI・DX
この記事は約21分で読めます。

こんにちは。クラフトビール愛好家のりほです。この記事は2025年5月に「AIのoutputが大きくなった今、人間はレビューと意思決定に集中する」という題で書いたものを、2026年11月に全面的に書き直しました。

前の版では、チャットAIに貼り付けて使うプロンプトを紹介していました。今の自分は、その貼り付け作業をほとんどしていません。このブログの記事更新も公開前のレビューも、Claude Code というツールの上で回しています。紹介していたプロンプト集の Job-Automate も、中身がかなり変わりました。

前の版で書いた「AIが生成 → 別のAIがレビュー → 人間が最終判断」という流れは、今の Job-Automate の中心にそのまま残っています。変わったのは、その流れを回す道具のほうです。

▶ 情報の取得日と注意点

Claude Codeとは?チャットAIとの違い

ルネちゃん
ルネちゃん

Claude Code って、ブラウザで話すチャットAIと何が違うワン?

ホップくん
ホップくん

チャットは答えを文章で返すところまでホプ。Claude Code は自分でファイルを開いて、書き換えて、コマンドまで実行するホプ!

公式ドキュメントによると、Claude Code はコードベースを読み、ファイルを編集し、コマンドを実行するエージェント型のコーディングツールです[1]。動かせる場所はターミナル、VS Code などの IDE、デスクトップアプリ、ブラウザです[1]。

チャットAI(ブラウザで会話)Claude Code
ファイルの受け渡し人がコピーして貼り付けるClaude が自分でファイルを開いて読む
変更の反映出てきた文章を人が保存し直すClaude がファイルを直接書き換える
動作確認人がテストを実行して結果を貼るClaude がテストやビルドを実行し、出力を読んで直す[2]
やり直し会話を最初からやり直すEsc で止める、/rewind で巻き戻す[2]

差がいちばん大きいのは三行目です。確認の手段を渡さずに任せると、人は完了したという報告を信じるしかありません。

料金と対応プランは変わりやすいので、この記事には金額を書きません。2026年11月11日に確認した時点では、ほとんどの利用面で Claude のサブスクリプションか Anthropic Console のアカウントが必要と書かれていました[1]。最新の条件は公式の料金ページで確認してください。

自分はこのブログ(WordPress)の運営を Claude Code で回しています。プロジェクトの直下に CLAUDE.md を置き、記事の書き方や公開前に通すレビューの手順を書いています。レビューは書き込み権限を持たない別のエージェントが担当し、テーマの functions.php の編集や本番データベースへの直接書き込みは hook で止めています。公開してよいかを最後に決めるのは自分です。

Anthropic公式ベストプラクティス①:Claudeに伝えること

公式のベストプラクティスのページを2026年11月11日に読み直すと、冒頭の前提がはっきりしていました。新しいセッションでは、たいてい最初の素直なプロンプトだけで正しく動くように作られていて、設定が要るのは、コードを読んでも分からない知識やルールがプロジェクトにある時だけ、という順番です[2]。

CLAUDE.md は短く、コードから分からないことだけ

CLAUDE.md は、Claude Code がセッションの最初に毎回読み込む Markdown ファイルです[3]。何を書くかについて、公式はこう書いています。

Claude がリポジトリを読んでも見つけられないこと、またはそうしなければ毎セッション再発見に時間を費やすことになることだけを書き留めてください。[2]

書く前の確認として挙げられているのは二つの質問です。コードを読めばこれを見つけられるか。実際に探しに行くか。両方とも「はい」なら書かない、というものです[2]。

書く価値があるのは、テストや型チェックの正確なコマンド、誤解を招くコードの場所、会議で決めたようなリポジトリにない決定、それからすでに2回直させたことです[2]。アーキテクチャやファイル構成の説明は、逆に「やめてもよいこと」の表に入っています[2]。

一から書く必要はありません。/init でコードベースから最初の版を作れて、公式はそこからの作業は主に行を削ることだと書いています。メモリのページでは、1ファイル200行未満を目標にしています[2][3]。個人の好みは CLAUDE.local.md に分けて .gitignore に入れます[2]。

耳の痛い話です。このブログの CLAUDE.md は、失敗するたびにルールを足してきた結果、自分で決めたサイズの上限を超えたままです。いまは詳しい手順を別のファイルへ移し、CLAUDE.md には索引だけを残す形に寄せている途中です。

りほくん
りほくん

書きたくなることの大半は、Claude がコードを読めば分かっちゃうんだよね。だから CLAUDE.md は足すより削る方が大事なんだ。

仕様を先に固めてから、新しいセッションで作る

何を作りたいかがまだ固まっていない時は、Claude にインタビューさせて仕様を SPEC.md に書かせる方法が紹介されています。仕様ができたら新しいセッションを始め、まっさらな状態と書面の完了条件から作り始めます[2]。調べて決める段階と、作る段階を分ける使い方です。

Job-Automate の記録を見ると、以前の公式ページには Explore first, then plan, then code(探索、計画、実装の順)という節がありました[9]。2026年11月11日の現行ページにはこの節名が見当たらず、代わりに仕様を先に書かせる方法が説明されています[2]。公式の推奨は書き換わることがあります。この件は Job-Automate の節でもう一度出てきます。

チームの手順は skills に

リリース手順や社内の書き方のように、モデルが知らないチーム固有の手順は skill にします。.claude/skills/<名前>/SKILL.md に置くファイルで、/名前 で呼び出せます[4]。CLAUDE.md と違って普段は名前と説明だけが読み込まれ、本文は使う時に読まれます。長い手順を置いても、無関係な作業の負担になりません[2][4]。

リリースのように副作用のある手順には disable-model-invocation: true を付けます。Claude が自分の判断で始めることはなくなり、人が /release と打った時だけ動きます[2]。

Anthropic公式ベストプラクティス②:確認・レビュー・強制

ホップくん
ホップくん

AIの「終わりました」は、確かめる手段があって初めて信用できるホプ。

合否が返るチェックを渡す

公式のページでいちばん紙幅を割いているのがここです。Claude は作業が終わったように見えた時点で止まります。テストファイルやビルドの終了コード、リンターのように合格か不合格かを返すものを渡せば、Claude は変更して確かめて直すループを自分で回せます[2]。

そのうえで、Claude には証拠を出させるよう勧めています。実行したコマンドとその出力、またはスクリーンショットです。テストが全部通ったという一文だけでは、ほとんど何も分からないからです[2]。

書いていない人にレビューさせる

ターミナルの /code-review は、それまでの会話を一度も見ていない新しいサブエージェントで差分をレビューします[2]。2つ目のセッションを開き、書かれる過程を見ていない側にレビューさせる方法も挙げられています[2]。

注意書きも付いています。問題を探せと頼まれたレビュアーは必ず何かを見つけるので、依頼文の skip style(見た目の好みは見ない)を削らず、正しさに関わる指摘だけを返させる、というものです[2]。

サブエージェントの定義で tools に Read と Grep と Glob だけを与えると、編集できないレビュアーになります。この制限はプロンプトでのお願いではなく、Claude Code が強制します[2][6]。一方で公式は、同じ作業をサブエージェントに渡しても答えが賢くなるわけではないとも書いています。効くのは並列作業、長い出力の切り離し、推論を見ていないレビュアー、ツールを絞った作業の場面です[2]。

ルネちゃん
ルネちゃん

CLAUDE.md に「絶対に〜しない」って太字で書いても、守られない時があるワン?

例外を許さないルールは hook と拒否ルールへ

公式は指示を2種類に分けています。プロンプトや CLAUDE.md や skill はモデルが読んで判断するもので、従う保証はありません。hook や拒否ルールや管理設定は、Claude Code そのものが毎回実行します[2]。メモリのページにも、CLAUDE.md は強制される設定ではなく、読み込まれる情報として扱われると書かれています[3]。

hook は、ツールの実行前後やセッション開始時、Claude が止まろうとした時などに、自分で用意したシェルコマンドを走らせる仕組みです[5]。PreToolUse の hook が終了コード2を返せばファイルの編集を止められ、Stop の hook なら型チェックが通るまで Claude を作業に戻せます[2][5]。.env を読ませたくない場合は、どの権限モードでも効く deny ルールに書きます[2]。

強制を増やせばよいという話でもありません。何度強調しても守られない行は hook にすべきサインで、単なる好みに hook を付けているなら消して Claude に任せる、と公式は両方向で書いています。強制するものは少なく保ち、40個もあるなら大半はおそらく好みだ、とまで書いてあります[2]。

セッションの舵取りと、やめてよい古い習慣

最初の1分を見守り、逸れたら Esc で止める。2回直してもだめなら、3回目の修正をせずに /clear してプロンプトを書き直す[2]。無関係なタスクの合間にも /clear が勧められていて、理由は焦点の絞れた会話のほうが答えが良く、費用も下がるからです[2]。

IMPORTANT や大文字での強調、think hard という書き方、コンテキストウィンドウ(Claude が一度に読める量)の節約は、どれも「やめてもよいこと」の表に移りました[2]。前の版で自分は、プロンプトを上手に書く技術より出てきた結果をどう扱うかが大事になると書きました。公式の書き方も、同じ方向に寄ってきたと感じています。

Job-Automateとは:公式ベストプラクティスを他のプロジェクトに入れる仕組み

りほくん
りほくん

ここからは自分が公開している Job-Automate の話。前はプロンプト集だったけど、今は他のプロジェクトを公式の推奨どおりにセットアップするための道具になってるんだ。

Job-Automate は、GitHub に MIT ライセンスで公開しているリポジトリです[7]。README の冒頭に書いた中心の目的は、他のプロジェクトの CLAUDE.md と rules と skills を、公式ベストプラクティスに準拠した状態にセットアップすることです[7]。

対象プロジェクトに clone してセットアップを頼むと、Claude Code が CLAUDE.md と rules と skills を生成します。選べば hooks も入り、結果は別のエージェントが検証します[8]。

公式由来と著者の好みを分けて管理する

自分の運用には、公式の推奨と、失敗から覚えた自分の癖が混ざっています。課題ファイルの置き方や、セッションをまたぐ引き継ぎメモの書き方がその例です。これを丸ごと他人のプロジェクトに写すと、要らない運用まで持ち込んでしまいます。

そこで、要素ごとに由来を記録した台帳 provenance.json を作りました[10]。2026年11月11日時点で75要素あり、内訳は公式由来6、公式原則の具体化18、著者の運用嗜好42、業務プロンプト4、このリポジトリ固有4、第三者由来1です[10]。セットアップでは、公式由来は必ず入り、公式原則の具体化は最初から選ばれた状態で提示され、著者の嗜好は利用者が選んだものだけが入ります[8][17]。

ルネちゃん
ルネちゃん

自分の好みを他の人に押しつけない仕組み、ってことワン?

由来移植時の扱い例
公式由来必ず入るCLAUDE.md の行の要否判定
公式原則の具体化推奨(外せる)review-gate、harness-setup-review
著者の運用嗜好選んだものだけ入るissue フォルダ管理、引き継ぎメモの規約
このリポジトリ固有移植しないworkflow-coverage-and-structure

公式は強制するものを少なく保てと書いています[2]。著者の嗜好を既定で入れない作りは、それと同じ向きだと自分は考えています。選ばなかった要素も含めて全要素の採否が対象側の harness-selection.json に残るので、後から何を外したかを確かめられます[8]。

公式の推奨を、取得日つきのJSONで持つ

公式ドキュメントの内容は、anthropic-best-practices.json という1つの JSON に原則ごとに要約して持っています[9]。各原則には出典ページと節名、判定に使う短い原文、確認方法が付き、ファイル全体に取得日と再取得の条件があります[9]。2026年11月11日に数えると85件で、取得日は2026年10月27日でした[9]。

公式は毎回読み直すのではなく、取得から30日を超えた時や、新しいプロジェクトに初めて適用する時などに読み直して突合します[8][9]。

なぜこうしたかは、前の節で触れた節名の件を見ると分かります。10月27日の再突合では、引用の食い違い25件のうち19件を現行の文に貼り替え、残る6件は現行ドキュメントに同じ根拠が見つからないとして verified: false を付けました[11]。探索、計画、実装の順で進める原則も、この6件の1つです[9]。公式の文章を skill の中に書き写していたら、この食い違いには気づけませんでした。

公式の推奨とJob-Automateの実装の対応表

りほくん
りほくん

公式に書いてあることと、リポジトリのどのファイルがそれをやっているかを並べてみたよ。

公式の推奨Job-Automate での形ファイル
CLAUDE.md にはコードから分からないことだけ書く[2]生成時に各セクションへ「削除したら Claude が間違えるか」の基準を当て、時々しか使わない手順は skills や rules に分ける[17]agent-harness-bootstrap
会話を見ていないレビュアーに見せる[2]レビュー役には評価対象と評価基準だけを渡し、実装の意図や会話履歴は渡さない[12]agents.md
編集できないレビュアーはツール制限で作る[2][6]readonly-reviewer は Edit と Write と NotebookEdit を disallowedTools で外している[13]readonly-reviewer.md
合否が返るチェックを渡す[2]工程ごとに別エージェントのレビューを受け、PASS するまで次の工程に進ませない[18]review-gate
例外のないルールは hook と deny ルールへ[2].env と secrets の読み取りを deny、未レビューの skill がある時の git push を PreToolUse hook で止め、セットアップ検証前の終了を Stop hook で止める[15][8].claude/settings.json
副作用のある skill は人が起動する[2]主要なレビュー用コマンドは disable-model-invocation: true で、スラッシュコマンドとしてだけ動く[16]docs/skills-index.md

README に書いてある限界

README には、自分で書いた限界もそのまま載せています。skill を変えた時の別エージェントレビューは必須で、未レビューの skill があると hook が push を止めます。ただし、git の別名や変数やスクリプト経由の push は見ていません[7]。

gate が exit 0 でも、全 skill が別エージェントのレビュー済みという意味ではない。既存 54 skill は負債台帳で免除しており、全件レビューは未実施。[7]

セットアップガイドにも、保証しないものを書いています。構造や語句の検査は機械的に決まりますが、条文の中身が良いかどうかは LLM のレビュアーの判定で、完全には決定的ではありません。生成後のずれも、governance.md や hooks を選んだ場合と再同期の時にしか見つかりません。全プロジェクトが同じ CLAUDE.md になるわけでもなく、揃うのは公式準拠の土台と記録された差分です[8]。

このあたりは自分でもまだ途中です。どこが未完かを README に書いておけば、使う人が信用してよい範囲を自分で決められる。そう考えて、隠さずに載せています。

Job-Automateに入っているskillの例

ホップくん
ホップくん

.claude/skills/ にはセットアップ用以外の skill もたくさん入ってるホプ!

2026年11月11日時点で、.claude/skills/ には共有データ用の _shared を除いて65個の skill があります。セットアップで既定として移されるのは、agent-harness-bootstrap など汎用ガバナンスの6個です[16]。残りは実運用から生まれたサンプルで、選んだ時だけ入ります[16]。

skill何をするか
agent-harness-bootstrap対象プロジェクトの CLAUDE.md と rules と hooks を生成する[17]
harness-setup-review選んだ要素の抜けがゼロか、選ばなかった要素の混入がゼロかを、機械検査と別エージェントの突合で確かめる[8]
review-skill作った skill を別エージェントに5軸100点で採点させ、合否の記録を残す[14]
debate-proposal新しい提案を、推進側と反対側と前例調査のエージェントに議論させ、中立の裁定で採否を決める[16]
stop-ai-slop-jpAIっぽい日本語を直す。第三者の OSS を取り込んだもので、同梱のライセンス表記が適用される[7]
slides-proMarkdown からスライドを作る。前の版で紹介したプロンプトを skill にしたもの

前の版で紹介した slides-pro.md や business-idea.md、3エージェント開発の手順は、今は workflows/ 以下にあります。旧版のリンク先だった content/ や dev/ はもう無いので、workflows/README.md から辿ってください。このブログの文章チェックも、Job-Automate の stop-ai-slop-jp と同じ採点基準を取り込んで使っています。

Claude CodeとJob-Automateの始め方

ルネちゃん
ルネちゃん

やってみたいワン。何から始めればいいワン?

Claude Code を入れる

公式の概要ページに載っているネイティブインストールのコマンドは次のとおりです(2026年11月11日確認)[1]。

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

Homebrew(brew install --cask claude-code)や WinGet でも入れられます[1]。入れたら作業したいフォルダに移動して起動します。初回はログインを求められます[1]。

cd your-project
claude

既存のプロジェクトなら、まず /init で CLAUDE.md の初版を作り、コードを読めば分かる行を削っていきます[2][3]。

Job-Automate でセットアップする

セットアップガイドの手順です[8]。対象プロジェクトの直下に .setup-automate/ という名前で clone し、.gitignore に加えます。

cd <対象プロジェクト>
git clone https://github.com/Rih0z/Job-Automate.git .setup-automate && printf '.setup-automate/\n' >> .gitignore
cd .setup-automate
  1. .setup-automate の中で claude を起動する(対象のルートで起動すると Job-Automate の CLAUDE.md が読み込まれない)
  2. 親ディレクトリ(..)をセットアップして、と伝える。言い回しは厳密でなくてよい
  3. 由来別に並んだ一覧から、取り込む著者の嗜好を選ぶ
  4. 生成と検証が終わったら、対象側で CLAUDE.md と .claude/ をコミットする(.setup-automate/ はコミットしない)
  5. 対象のルートで Claude Code を新しく起動し、/context で生成した CLAUDE.md が読み込まれているかを確かめる

hook は Python で状態を読むため、Python が見つからない環境では検証のゲートを評価できない旨が表示されます。対話セッションでは、フォルダの信頼(workspace trust)を承認するまで hook は動きません[8]。

りほくん
りほくん

最初は本番のリポジトリじゃなくて、小さい個人プロジェクトで試すのがおすすめ。何を入れて何を外したかは harness-selection.json に残るから、あとで見直せるよ。

まとめ:Claude Codeで人間に残る仕事

ホップくん
ホップくん

伝える、確かめさせる、例外のないものは強制する。公式の推奨はこの順番ホプ。

前の版で書いた「AIが生成 → 別のAIがレビュー → 人間が最終判断」という流れは、今も変わっていません。変わったのは道具の側です。確認の手段を渡すこと、書いていない者にレビューさせること、例外のないルールを hook に移すことが、公式のページに具体的な設定として書かれるようになりました[2]。

公式は無人実行の節で、人の手元に残る仕事を、実行を始めること、今回の完了が何かを決めること、最後にマージを承認することだと書いています[2]。Job-Automate は、その手前の準備にあたる、公式の推奨どおりの CLAUDE.md とレビューの仕組みを他のプロジェクトに入れる部分のために作りました。完成品ではないので、合わない要素は台帳の選択で外して使ってください。

りほくん
りほくん

ビールの話が読みたい人は、下の記事もどうぞ。仕事のあとの一杯だけは、Claude Code に任せられないからね。

この記事の情報について

Claude Code の機能やコマンド、料金、対応プランは頻繁に変わります。この記事の公式ドキュメントの内容は2026年11月11日に取得したもの、Job-Automate の内容は同日時点の main ブランチ(コミット b19ca36)にもとづきます。使う前に、出典の公式ページで最新版を確認してください。Job-Automate はりほが個人で公開しているリポジトリで、Anthropic の公式ツールではありません。

📚 出典・参考情報

  1. 【一次】 Claude Code 公式ドキュメント「Overview」(日本語版) (2026-11-11 取得) ↑本文へ戻る
  2. 【一次】 Claude Code 公式ドキュメント「Claude Code のベストプラクティス」(日本語版) (2026-11-11 取得) ↑本文へ戻る
  3. 【一次】 Claude Code 公式ドキュメント「How Claude remembers your project」(CLAUDE.md とメモリ・日本語版) (2026-11-11 取得) ↑本文へ戻る
  4. 【一次】 Claude Code 公式ドキュメント「Skills」(日本語版) (2026-11-11 取得) ↑本文へ戻る
  5. 【一次】 Claude Code 公式ドキュメント「Automate actions with hooks」(日本語版) (2026-11-11 取得) ↑本文へ戻る
  6. 【一次】 Claude Code 公式ドキュメント「Subagents」(日本語版) (2026-11-11 取得) ↑本文へ戻る
  7. 【一次】 Job-Automate README.md (2026-11-11 取得) ↑本文へ戻る
  8. 【一次】 Job-Automate docs/setup-guide.md(セットアップガイド) (2026-11-11 取得) ↑本文へ戻る
  9. 【一次】 Job-Automate anthropic-best-practices.json(公式ベストプラクティスの構造化データ) (2026-11-11 取得) ↑本文へ戻る
  10. 【一次】 Job-Automate provenance.json(由来台帳) (2026-11-11 取得) ↑本文へ戻る
  11. 【一次】 Job-Automate compliance-status.json(公式との再突合の記録) (2026-11-11 取得) ↑本文へ戻る
  12. 【一次】 Job-Automate agents.md(エージェント分離の説明) (2026-11-11 取得) ↑本文へ戻る
  13. 【一次】 Job-Automate .claude/agents/readonly-reviewer.md (2026-11-11 取得) ↑本文へ戻る
  14. 【一次】 Job-Automate review-skill/SKILL.md (2026-11-11 取得) ↑本文へ戻る
  15. 【一次】 Job-Automate .claude/settings.json (2026-11-11 取得) ↑本文へ戻る
  16. 【一次】 Job-Automate docs/skills-index.md(skill 一覧) (2026-11-11 取得) ↑本文へ戻る
  17. 【一次】 Job-Automate agent-harness-bootstrap/SKILL.md (2026-11-11 取得) ↑本文へ戻る
  18. 【一次】 Job-Automate review-gate/SKILL.md (2026-11-11 取得) ↑本文へ戻る

👉 おすすめクラフトビール特集

🍺 作業のおともに、クラフトビールを自宅で

全国のブルワリーのクラフトビールが毎月届く定期便です。

▶ Otomoni クラフトビール定期便の詳細を見る

※アフィリエイトリンクを含みます(PR)

この記事をシェアする


この記事が気に入ったら、「Next Pint!」ボタンを押してください!

rihobeerをフォローする

Instagramでは最新記事をいち早く配信、Xではビール情報をリアルタイムに発信しています。

Instagram (@rihobeer.craft) ・ X (@rihobeer2)

この記事をシェアする

AI・DXbeer専門コラム
ブルワリー訪問記 250本ビールレビュー記事 191本受賞歴データベース 46,294件と照合
タイトルとURLをコピーしました