ナレッジ
知識・原因・設定・過去のノウハウを探す場所です。やりたいこと・症状・ツール名で探せます。
「トークン節約」の検索結果 27件
絞り込みを解除- 認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない パスワード・秘密鍵の中身・APIキー・トークン・ドメイン移管の認証コード・DBパスワード(wp-config.phpの値)はknowledgeに書かない。書いてよいのは「どこにあるか」「どの種類か」まで。貼られていたら伏せ字にする。
- APIの実務の基本(GET/POST/PUT/PATCH/DELETE・JSON・ヘッダー・認証/トークン・レート制限・ページング・タイムアウト・リトライ) APIは「URL+方法(GET/POST等)+ヘッダー(認証・形式)+本文(JSON)」で頼み、ステータスコードとJSONで答えが返る。認証キーはサーバー側だけに置きブラウザのJSに書かない。レート制限・ページング・タイムアウト・リトライを前提に作る。
- Claude消費量を抑える検査・作業ルール 毎回全サイト監査はしない。新規・変更部分を重点検査し、全体監査は節目だけ。ファイルは検索で絞ってから必要箇所だけ読む。
- Claude Codeのサブエージェントの使い方(並列作業・分担・統合と、同じファイル・重複・品質差・消費・待機の注意) サブエージェントは独立した作業(小カテゴリごとの原稿、分野ごとの調査・分類・比較)を並列にするのに向く。担当ファイルを分けて同じファイルを触らせない、共通ブリーフを渡す、戻り値は要点だけ、最後にメインで統合と検査をする。大量生成では生成役と検査役を分ける。
- APIエラーの見方(200系・400・401・403・404・422・429・500系でどこを疑うか) 400系は「送った側」、500系は「相手側」の問題が基本。401は認証(キー・トークンの誤り・期限切れ)、403は権限・プラン・IP制限、404はURLや対象ID、429は回数制限、500系は相手の障害。まずエラー本文(JSON)を読む。
- ログは推測の前に見る証拠(PHPログ・debug.log・Webサーバーログ・Console・APIレスポンス・Claude Codeログ)と保存時の注意 原因を推測する前に、該当する層のログを見る。PHP・WordPress・Webサーバーはサーバー側、JSはConsole、通信はNetworkとAPIの応答本文、AI作業はClaude Codeの出力・作業ファイル。ログには個人情報・トークンが含まれるので、共有・保存するときは伏せる。
- DevToolsのConsoleの見方(JavaScriptエラー・warning・CORS・404・外部script・フォーム/イベントが動かない) 赤はエラー(処理が止まっている可能性)、黄色は警告。1つのJSエラーで以降の処理(メニュー・スライダー・フォーム)が全部止まることがある。最初に出たエラーから、ファイル名と行を見る。AIに渡すときはURL内のトークンや個人情報を伏せる。
- AIでトラブル原因を切り分ける方法(静的チェックで終わらせず実ブラウザで確かめる) 症状・再現条件・期待結果を渡し、仮説を並べさせてから実ブラウザで1つずつ確かめさせる。guidepocket.net ではHTML/CSSの静的チェックで「問題なし」とされた不具合が、実クリック調査で透明ヘッダーの重なりと特定できた。
- 安全な変更の流れ(バックアップ→DRY RUN→本番反映→検査→復旧手段の確認) 戻せる状態を作ってから変える。バックアップ→書き込みなしの試し実行→本番→差分検証→表示検査。普段は変更部分だけ検査し、全件検査は大きな節目だけ。
- Claude Codeが途中で止まる(APIエラー・応答停止・サブエージェント待機・コンテキスト切れ) 止まったらまず「何が完了し、何が途中か」を調査だけさせてから再開する。API一時エラーはファイル状態を確認して再実行、安全チェックの停止は回避せず許可を求める、長いコマンドや大きいヒアドキュメントは分割する。
- AIでサイト検査を自動化する考え方(サーバー側差分・HTTP・実ブラウザの3層) AIに検査スクリプトを書かせ、①サーバー側でバックアップとの差分、②HTTP・H1・href="#"、③ヘッドレスChromeでPC/390pxの実クリック・横スクロール・スクショを機械的に判定する。AIの目視判定に頼らない。
- 不具合の原因を切り分ける 表示されない・エラー・押せない・急に崩れたときに、いきなり直さず、症状・いつから・範囲・層(DNS/サーバー/WordPress/ブラウザ)の順に絞り込む。
- ネットショップ(EC)の作り方の選び方と必須ページ(BASE・STORES・Shopify・WooCommerce・特商法表記・API連携) 小規模ならBASE/STORES、拡張性ならShopify、WordPressに統合したいならWooCommerce(保守・セキュリティの負担大)。どれでも特商法表記・プライバシーポリシー・返品条件・最終確認画面の表示が必要。
- お問い合わせフォームのスパム対策(ハニーポット・reCAPTCHA・Turnstile・送信テスト・誤判定) まずプラグイン標準のハニーポット(見えない入力欄)を有効にし、それで足りなければ reCAPTCHA v3 か Cloudflare Turnstile を追加。導入後は必ずPC・スマホで実際に送信テストする(誤判定で正規の問い合わせが消えるのが一番の事故)。人が送る営業メールは完全には防げない。
- Gitの安全な使い方(commit前にstatus/diff・秘密情報をcommitしない・.gitignore・消しても履歴に残る) commit前に git status と git diff で対象と中身を確認し、git add . をむやみに使わない。.env・wp-config.php・鍵・APIキーは .gitignore で除外する。一度commitした秘密情報は、後で消しても履歴・コピー先に残るので、まずその認証情報を無効化・変更する。
- AIに渡す指示テンプレート集(CSS修正・HTML修正・WordPress修正・トラブル調査・画像制作・検査・大量ページ制作) 用途別(A〜G)に、目的・変更対象・変更禁止・期待結果・PC/SP・出力形式・検査の7項目で書く短いテンプレート。汎用の型は ai-work-request-template、「他は変更しない」の定型文は ai-no-other-changes。
- WordPressのバックアップ対象と種類の使い分け(DB・wp-content・フル/DBのみ/差分・世代管理)と「戻せるか」の確認 WordPressは「DB」と「wp-content(テーマ・プラグイン・uploads)+wp-config.php・.htaccess」を分けて考える。作業直前は変える範囲に合わせてDBのみ・ページ単位でもよいが、大きな変更前はフル。バックアップは「ある」ではなく「戻せる」ことが重要で、復元手順を事前に確認する。
- サブエージェントで記事原稿を並列執筆する方法(共通ブリーフ) 小カテゴリ1つ(8記事)ごとにサブエージェントを1つ立て、共通ブリーフで原稿を書かせる。戻り値はファイルパスとH2一覧だけにして本文を返させない。文字数は len.ps1 で確認する。
- WordPressのフォームメール・通知メールが届かない(迷惑メールに入る・自動返信が来ない) 「送信処理が失敗している」か「送れているが受信側で弾かれる」かを分ける。SMTPプラグインのテストメールとメールログで確認し、From・Reply-Toの設定、SPF/DKIM、受信側の迷惑メールを順に見る。
- SNS各社(Instagram・X・Facebook・YouTube・LINE)固有の仕様メモ(変化が速いので要確認) 各SNSの埋め込み・フィード・シェアの手段の目安。どれも仕様が変わりやすいので needs-review。作業時は必ず最新公式仕様を確認し、確認した日付と結果をここに追記する。
- CLAUDE.mdに書くこと・書かないこと(恒久ルールだけ短く、詳細はknowledgeへ) CLAUDE.mdは作業フォルダで毎回守るプロジェクト固有ルールの置き場。変更禁止・作業範囲・検索/検査ルール・noindexなどの恒久ルール・優先順位を短く書き、手順や詳しい知識は knowledge に置いてリンクや検索で参照させる。
- AIツールの最新仕様メモ(モデル名・料金・機能制限は確認日付きで管理) 変わりやすいAIの仕様を置く場所。現時点では確認済みの内容はなく、使う前に公式情報を確認し、確認日付きで表に追記する。
- curl・HTTP確認コピペ集(ステータス200確認・ヘッダー・robots.txt・HTML取得・リダイレクト確認・PowerShellのcurl注意) Windows PowerShell 5.1 では curl が Invoke-WebRequest の別名なので、本物の curl は curl.exe と書く。ステータスは curl.exe -s -o NUL -w "%{http_code}"、ヘッダーは -I、リダイレクトは -IL で追う。すべて読み取りだけ。
- HPトラブル時にDevToolsのどこを見るか(Elements・Styles・Computed・Console・Network・Application・レスポンシブ表示) 見た目・CSSはElements/Styles/Computed、JSのエラー・警告はConsole、ファイルやAPIの読み込み・ステータス・速度はNetwork、Cookie・保存データはApplication、スマホ幅はデバイスツールバー。症状から見る場所を選ぶ。
- DevToolsのNetworkタブの見方(HTTPステータス・CSS/JS/画像・API(Fetch/XHR)・読み込み時間・キャッシュ) Networkを開いてから再読み込みし、種類(CSS/JS/Img/Fetch/XHR)で絞る。赤い行・404/500を探し、URLとステータスを確認。APIは行をクリックしてHeaders・Payload・Responseを見る。Disable cacheでキャッシュを除外、Preserve logで画面遷移後も記録を残す。
- JSONの読み方(object・array・key・value・文字列・数値・boolean・null)HP制作とAPI連携で困らない範囲 JSONは {} のobject(key: valueの組)と [] のarray(並び)でデータを表す。値は文字列("で囲む)・数値・true/false・null・object・array。keyは必ず"で囲む、末尾カンマ不可、コメント不可が典型的なつまずき。
- Claude CodeのAuto modeの考え方(自動で進む操作・確認が出る操作・確認画面で見るべき点) Auto modeはローカルの読み取り・検索・新規ファイル作成など安全な操作を自動で進め、削除・上書き・本番サーバー書き込み・外部サービスへの送信などは確認や停止になることがある。確認が出たのは失敗ではない。削除・本番変更・認証情報・大量上書きの確認は内容を読んでから許可する。