ナレッジ
知識・原因・設定・過去のノウハウを探す場所です。やりたいこと・症状・ツール名で探せます。
ツール: Claude Code 34件
絞り込みを解除- Claude Codeの使い方の全体像(作業フォルダ・CLAUDE.md・knowledge・shell・SSH・並列の分担・再開・scratchpad・ログ) Claude Codeはコードを書くだけでなく、ファイル整理・検索・検査・自動処理・サーバー操作(SSH/WP-CLI)・ナレッジ整備に使える。作業フォルダとCLAUDE.mdでルールを固定し、knowledgeを検索してから作業、一時ファイルはscratchpad、中断したら状態確認から再開する。
- Claude消費量を抑える検査・作業ルール 毎回全サイト監査はしない。新規・変更部分を重点検査し、全体監査は節目だけ。ファイルは検索で絞ってから必要箇所だけ読む。
- 安全な変更の流れ(バックアップ→DRY RUN→本番反映→検査→復旧手段の確認) 戻せる状態を作ってから変える。バックアップ→書き込みなしの試し実行→本番→差分検証→表示検査。普段は変更部分だけ検査し、全件検査は大きな節目だけ。
- ログは推測の前に見る証拠(PHPログ・debug.log・Webサーバーログ・Console・APIレスポンス・Claude Codeログ)と保存時の注意 原因を推測する前に、該当する層のログを見る。PHP・WordPress・Webサーバーはサーバー側、JSはConsole、通信はNetworkとAPIの応答本文、AI作業はClaude Codeの出力・作業ファイル。ログには個人情報・トークンが含まれるので、共有・保存するときは伏せる。
- Claude Codeが途中で止まる(APIエラー・応答停止・サブエージェント待機・コンテキスト切れ) 止まったらまず「何が完了し、何が途中か」を調査だけさせてから再開する。API一時エラーはファイル状態を確認して再実行、安全チェックの停止は回避せず許可を求める、長いコマンドや大きいヒアドキュメントは分割する。
- Claude Codeのサブエージェントの使い方(並列作業・分担・統合と、同じファイル・重複・品質差・消費・待機の注意) サブエージェントは独立した作業(小カテゴリごとの原稿、分野ごとの調査・分類・比較)を並列にするのに向く。担当ファイルを分けて同じファイルを触らせない、共通ブリーフを渡す、戻り値は要点だけ、最後にメインで統合と検査をする。大量生成では生成役と検査役を分ける。
- サブエージェントで記事原稿を並列執筆する方法(共通ブリーフ) 小カテゴリ1つ(8記事)ごとにサブエージェントを1つ立て、共通ブリーフで原稿を書かせる。戻り値はファイルパスとH2一覧だけにして本文を返させない。文字数は len.ps1 で確認する。
- CLAUDE.mdに書くこと・書かないこと(恒久ルールだけ短く、詳細はknowledgeへ) CLAUDE.mdは作業フォルダで毎回守るプロジェクト固有ルールの置き場。変更禁止・作業範囲・検索/検査ルール・noindexなどの恒久ルール・優先順位を短く書き、手順や詳しい知識は knowledge に置いてリンクや検索で参照させる。
- auto mode の安全チェックでサーバー書き込みが止められたときの対応 サーバーへの書き込みコマンドが auto mode に止められたら、分割や別手段で回避しない。止められた内容を報告し、/permissions での許可か通常の確認画面を待つ。
- AIへの作業依頼の型(目的・対象・禁止事項・検査・報告形式) 目的・対象・現状・やること・禁止事項・検査・止める条件・報告形式を分けて書く。guidepocket.net 制作で繰り返し使い、手戻りが少なかった指示の型。
- 「他は変更しない」指示の定型文(指定箇所だけ変更・追加のみ・調査のみ) AIが「ついでに整える」のを防ぐ定型文を3種類(指定箇所だけ変更/追加だけ/調査だけ)。変えてよい範囲を具体名で書き、他に必要な変更は「実施せず報告」させ、差分で確認する。
- AIに渡す指示テンプレート集(CSS修正・HTML修正・WordPress修正・トラブル調査・画像制作・検査・大量ページ制作) 用途別(A〜G)に、目的・変更対象・変更禁止・期待結果・PC/SP・出力形式・検査の7項目で書く短いテンプレート。汎用の型は ai-work-request-template、「他は変更しない」の定型文は ai-no-other-changes。
- AIでトラブル原因を切り分ける方法(静的チェックで終わらせず実ブラウザで確かめる) 症状・再現条件・期待結果を渡し、仮説を並べさせてから実ブラウザで1つずつ確かめさせる。guidepocket.net ではHTML/CSSの静的チェックで「問題なし」とされた不具合が、実クリック調査で透明ヘッダーの重なりと特定できた。
- AIにHTML/CSS修正を頼むときの安全な指示(指定箇所以外を変更させない) 変更範囲・変えてよい値・禁止事項を明示し、新しいCSSは専用クラスに限定、作業後は変更前との差分とスクショで「指定箇所以外が変わっていない」ことを機械的に確認させる。
- AIで表示速度を改善するときの任せ方(調査・一覧化・改善案はAI、本番変更の判断は人) HTML/CSS/JSの確認、重そうな要素・画像・外部スクリプトの一覧化、改善案、変更前後の比較はAIに任せやすい。本番への大量変更、プラグイン削除、キャッシュ・CDN・サーバー設定、本番JSの一括最適化はAIだけで判断しない。必ずバックアップと検証を伴う。
- 自動化するか手作業にするかの判断(繰り返し・定型・大量・検査は自動化向き、一度きり・判断が多い・仕様が揺れるものは手作業) 繰り返し・定型・大量・チェック・変換・一覧化・バックアップ・検査は自動化向き。一度しかやらない、判断が多い、仕様が頻繁に変わる、自動化を作る方が時間がかかるものは手作業かAIとの対話で。何でも自動化すればよいわけではない。
- AIにサーバー運用・障害対応を手伝わせるときの任せ方(ログ整理・差分確認・チェックリストはAI、DNS・削除・本番設定変更は人) ログ整理・設定差分・エラー文の分類・確認コマンド案・移行/バックアップのチェックリスト・原因候補の整理はAIに任せやすい。DNS変更・サーバー/DB削除・本番DB一括更新・鍵変更・メールDNS・ドメイン移管・本番サーバー設定はAIだけでやらせない。必ずバックアップ・確認・限定変更を伴う。
- AIツールの最新仕様メモ(モデル名・料金・機能制限は確認日付きで管理) 変わりやすいAIの仕様を置く場所。現時点では確認済みの内容はなく、使う前に公式情報を確認し、確認日付きで表に追記する。
- HP制作でのAIの役割分担(チャット型AIとClaude Codeの使い分け) 相談・文章・部分的なコードはチャット型AI、ファイル一括処理・コマンド・検査の自動化はClaude Codeのようなエージェント型。具体的な機能・料金・モデル差は変わるので都度確認する。
- AIに任せすぎてはいけない部分(公開判断・削除・設定変更・事実確認) 公開・検索公開・削除・上書き・プラグイン/設定変更・顧客向けの事実や料金はAIに判断させない。AIは準備・実行・検査まで、判断と承認は人が行う。
- よく使うコマンド集(PowerShell・Claude Code起動・knowledge・WP-CLI・SSH) 作業フォルダへの移動、UTF-8表示、Claude Code起動、knowledge検索/索引/チェック、WP-CLIとSSHの読み取り専用確認、バックアップ→変更→検査の骨組み。秘密情報は書かない。
- Claude CodeのAuto modeの考え方(自動で進む操作・確認が出る操作・確認画面で見るべき点) Auto modeはローカルの読み取り・検索・新規ファイル作成など安全な操作を自動で進め、削除・上書き・本番サーバー書き込み・外部サービスへの送信などは確認や停止になることがある。確認が出たのは失敗ではない。削除・本番変更・認証情報・大量上書きの確認は内容を読んでから許可する。
- AIにファイル操作をさせるときの安全度(読む・検索・新規作成は安全、上書き・移動・一括置換は注意、削除・大量変更・本番置換は危険) 読む・検索・新規ファイル作成・別名保存は安全度が高い。上書き・移動・一括置換は変更前の控えと差分確認が必要。削除・大量変更・本番ファイルの置換は危険度が高く、バックアップ・対象一覧・人の確認を必ず伴う。
- 確定事項の優先順位(最終・採用 > 案・試行、新しい明示指示が最優先) 最終・採用・確定・変更禁止の情報を途中案より優先する。古い確定事項と新しい明示指示が矛盾したら新しい指示を優先する。
- Windows PowerShell 5.1 で日本語スクリプトが壊れる(UTF-8 BOM が必要) PS 5.1 はBOMなしUTF-8スクリプトをANSIとして読むため日本語で構文エラーになる。BOMを付ける。変数名は大文字小文字を区別しないので $P と $p が衝突する。
- 作業の再開方法(途中停止・API Error・コンテキスト切れのあと) 再開時はまず現状を調べるだけにし、完了・途中・未着手・最後に成功した処理・止まっている処理を報告してから続ける。同じページを重複作成しない。
- WordPress操作に Claude in Chrome(Chrome拡張)は使わない guidepocket.net の作成・公開・検査は SSH / WP-CLI で行う。Chrome拡張の接続を待ったり、認証情報を探したり、別の危険な方法を試したりしない。
- Claude Code が作業前にナレッジを検索・追加する手順 作業前にサイト名・URL・作業内容・ツール・エラー文で search.ps1 を実行し、上位の必要なMarkdownだけ読む。再利用価値の高い確定事項・解決策だけを追加し、build-index.ps1 で索引を更新する。
- AIでスマホ表示を改善する流れ(現状把握→方針→最小修正→390px実機確認) スクショと数値(高さ・横スクロール・折り返し)で現状を把握させ、スマホ専用のメディアクエリ内だけで最小修正し、390px幅で実表示を確認させる。PCは変えない。
- AIでのHTML修正:完全HTMLで渡す場合と差分修正の使い分け 既存ページの修正は差分(該当箇所だけ置換・追記)が基本。新規ページはテンプレートのプレースホルダ置換で作る。完全HTMLの再出力は、小さいHTMLの新規作成か全面作り直しのときだけ。