Claude Codeの使い方の全体像(作業フォルダ・CLAUDE.md・knowledge・shell・SSH・並列の分担・再開・scratchpad・ログ)
要点
Claude Codeはコードを書くだけでなく、ファイル整理・検索・検査・自動処理・サーバー操作(SSH/WP-CLI)・ナレッジ整備に使える。作業フォルダとCLAUDE.mdでルールを固定し、knowledgeを検索してから作業、一時ファイルはscratchpad、中断したら状態確認から再開する。
チャット型AIとの使い分けは HP制作でのAIの役割分担(チャット型AIとClaude Codeの使い分け)。
コードを書く場所だけではない
| 使い方 | 例 |
|---|---|
| ファイル整理 | 原稿・画像・出力ファイルの仕分け、命名の統一、一覧表(CSV)の作成 |
| 検索 | 大量のファイルから該当箇所を探す、knowledge 検索(Claude Code が作業前にナレッジを検索・追加する手順) |
| 検査 | HTTP・リンク・横スクロール・差分の一括確認スクリプトを作って実行(AIでサイト検査を自動化する考え方(サーバー側差分・HTTP・実ブラウザの3層)) |
| 自動処理 | テンプレートからHTMLを量産、文字数チェック、変換 |
| サーバー操作 | SSH・WP-CLI での確認・公開(cc-wp-cli-pipeline) |
| ナレッジ整備 | 作業で分かったことを knowledge に追記、索引の再生成 |
構成要素
| 要素 | 役割 | 注意 |
|---|---|---|
| 作業フォルダ | Claude Code を起動したフォルダ。ここを基準にファイルを読み書きする | 案件ごとにフォルダを分ける |
| CLAUDE.md | そのフォルダで毎回守るルール(CLAUDE.mdに書くこと・書かないこと(恒久ルールだけ短く、詳細はknowledgeへ)) | 巨大化させない |
| knowledge/ | 再利用する知識。作業前に検索して必要なものだけ読む | 全文を毎回読まない(Claude消費量を抑える検査・作業ルール) |
| shell | PowerShell / Git Bash などでコマンド実行 | PowerShell 5.1 は文字コードに注意(Windows PowerShell 5.1 で日本語スクリプトが壊れる(UTF-8 BOM が必要)) |
| SSH | サーバーでの確認・作業 | 書き込みは手順とバックアップ付き。認証情報は保存しない(認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない) |
| Auto mode | 安全そうな操作を自動で進め、危険な操作は確認・停止(Claude CodeのAuto modeの考え方(自動で進む操作・確認が出る操作・確認画面で見るべき点)) | 確認が出たら内容を読む |
| サブエージェント | 調査・原稿作成などを並列で分担(Claude Codeのサブエージェントの使い方(並列作業・分担・統合と、同じファイル・重複・品質差・消費・待機の注意)) | 同じファイルを触らせない |
| scratchpad | セッション用の一時フォルダ。途中ファイル・検査結果の置き場 | 消える可能性がある。残すものはプロジェクト側へコピー |
| ログ・会話履歴 | 過去の作業内容・コマンドの結果 | 再開時の状態確認に使える。認証情報を貼らない |
| バックアップ | 変更前の控え(バックアップ方針(作業前に必ず取り、削除しない)) | Claude Code 側の「元に戻す」機能に頼り切らない |
作業の進め方(この環境で定着した流れ)
- 依頼を目的・対象・禁止事項・検査・報告の形で渡す(AIへの作業依頼の型(目的・対象・禁止事項・検査・報告形式))。
- 最初に knowledge を検索し、関係するルールだけ読む。
- 調査だけ → 報告 → 変更、の順。
- 変更はバックアップ → 小さく試す(最初は3ページ以下)→ 検査。
- 結果と再利用できる知識を knowledge に保存し、
build-index.ps1/check.ps1。
中断後に再開するとき
- 中断・API Error・コンテキスト切れのときは Claude Codeが途中で止まる(APIエラー・応答停止・サブエージェント待機・コンテキスト切れ)、再開手順は 作業の再開方法(途中停止・API Error・コンテキスト切れのあと)。
- 再開時は「何が完了し、何が途中か」を調査だけさせてから続ける。状態は作業ファイル(例: ページ一覧.csv)に残しておくと再開が速い。