Claude Code活用

Claude Codeプランモードで書き込みが止まる条件と使い方

Claude Codeのプランモードを、使い捨てgitリポジトリでclaude -p 14回・対話画面の自動操作9回(CLI 2.1.289→2.1.302)で検証。計画中にpytestを頼むと、-pでも分類器が承認して__pycache__と.pytest_cacheが増えた。useAutoModeDuringPlan:falseで拒否に変わったが、共有の.claude/settings.jsonに書いた場合は警告なしで無視された(settings.local.jsonでは効いた)。bypassで起動してShift+Tabで入ったプランモードと--allow-dangerously-skip-permissions付きの対話起動では確認が出ず、--permission-mode plan起動では承認ダイアログで止まった。plansDirectoryで計画をプロジェクト内に置き、計画(13.15秒・0.102ドル)→人が読む→実装(10.39秒・0.096ドル・3 passed)の2段実行、--allowedToolsがプロンプトを飲み込むつまずき、対話の自動操作でdefaultModeがautoに書き換わった事故も記載。
Claude Code活用

Claude Codeに.envを読ませない設定と抜け道の塞ぎ方

Claude Codeで.envなど読ませたくないファイルを除外する設定を、CLI 2.1.289のclaude -p 29回(約0.92ドル)で実測。.claudeignoreは公式に効果なしと明記されRead ツールでそのまま読めた。permissions.denyのRead()ルールはReadツールとcatを止めたが、grep -r とnode/uv run pythonのスクリプトは素通り(macOSではGrep/Globツールが既定で無く検索はBash経由)。sandbox.enabledを足すとRead denyがOSレベルの禁止になりdenyReadへの二重記述は不要だった一方、bypassPermissionsではdangerouslyDisableSandboxでの再実行で読めたため、allowUnsandboxedCommands:falseで閉じると5通りの読み方がすべて止まった。denyReadに文字列以外を1つ書くとdenyルールごと警告なしで無効になるIssue #92365も2.1.289で再現。0ドルの点検スクリプトと漏れ確認プロンプト付き。
Claude Code活用

Claude Codeサブエージェントが呼ばれない5つの原因と作り方

Claude Codeのサブエージェントを.claude/agentsに作る手順と、呼ばれない・効かない5つの原因をCLI 2.1.289のclaude -p 25回(約3.19ドル)で実測。1行目の前の空行は無言でスキップされvalidateもデバッグログも無反応、description漏れはValidation passedのまま読み込まれない、スキル用のallowed-toolsと書くとツール制限が無言で消え実際にWriteされた(2.1.301ではデバッグログにのみ警告、validate --strictは無反応)、既定のOpus 5.5は名前を出さないと6回とも委任せず名前指定・@agent-・CLAUDE.mdの1行では全回委任、同じ実行内で作ったエージェントはAgent type not found、を確認。.claude/は保護パスでacceptEditsの-pでは作成を断られる点、haikuのサブエージェントが末尾改行を空行と9回中8回誤報告した点も記載。0ドルで点検するagent-check.shを掲載。
Claude Code活用

Claude Codeに自作MCPサーバーをつなぐ手順とつながらない原因

Claude Codeに自作のPython MCPサーバー(uv・PEP 723の1ファイル)をつなぐ手順と、つながらない5つの原因をCLI 2.1.289で実測。古い記事のfrom mcp.server.fastmcpはmcp 2.x(2.0.0は2026-07-28公開)で動かず一覧にはCONNECTION_CLOSEDしか出ない、相対パス登録はサブディレクトリ起動で失敗(gitリポジトリ内ならlocalスコープは拾われるのにCLAUDE_PROJECT_DIRは起動ディレクトリだった)、claude -pでは失敗したサーバーが黙って外れる、ToolError以外の例外はモデルにError executing toolの1行しか届かない、.mcp.jsonはlistでPending approvalのまま-pでは接続される、を確認。0ドル約3秒の/contextのmcp_serversと、未文書化のmcp-logsからエラー行を拾うmcp-check.shを掲載。有料実行10回・約0.85ドル。
Claude Code活用

Claude Codeを日本語で返答させる設定と英語に戻る時の対策

Claude Codeのlanguage設定("japanese")は返答の言語だけに効く。CLI 2.1.289・Opus 5.5のclaude -pで同じ実装タスクを4条件・計16回実行すると、英語の依頼には日本語で答えるようになる一方、コミットメッセージは設定なし・languageのみの8回とも英語、コメントも8回中7回が英語だった。CLAUDE.mdに言語ルールを書いた8回はコミットもコメントも日本語。英語に戻ったのはツール実行の合間の短い1行だけで、PostToolUseフックのadditionalContextで毎回日本語を促した5回では途中経過6行がすべて日本語だった(回数が少なく断定はしない)。綴り間違いのjapaneaseや日本語という値でも動くこと、未承認のワークスペースでもプロジェクトのlanguageとフックが効くことも確認。0ドルの設定確認grepと、途中経過までJA/ENで判定するlang-check.shを掲載。
Claude Code活用

Claude CodeをAPI課金にせずサブスクで使う確認手順

Claude CodeでPro/Maxのつもりが従量課金になる原因は、ANTHROPIC_API_KEYなどがサブスクのログインより優先されること。CLI 2.1.289で無効なダミーキーだけを使って確かめると、プロジェクトのsettings.jsonのenvに書いたキーはclaude auth statusに出ず(Claude Pro accountと表示)、connectorsの警告も出ないまま-p実行で使われた。unsetや空文字での起動では外れない。claude -p "/context"のsystem/initにあるapiKeySourceなら0ドル・約3秒で実際の値が分かる(ANTHROPIC_AUTH_TOKENはnoneと出るので別途確認)。apiKeyHelperの無効キーは再試行で4分26秒かかり、環境変数なら約0.3秒で失敗。.envは単独では読まれなかった。cron用にapiKeySourceで止めるauth-guard.shを作り、終了コード3で本番を止められることを確認した。
Claude Code活用

Claude Codeのコミットに付くCo-Authored-Byを消す手順

Claude Codeがコミットに付けるCo-Authored-Byを消す方法を、使い捨てgitリポジトリ12個とCLI 2.1.289/2.1.280のclaude -p(有料15回・約2.74ドル)で比べた。attribution.commitを空文字にすれば消え、"attribution": falseも2.1.289では効いたが、2.1.280で読ませると署名行が残るうえ同じファイルのSessionStartフックまで黙って無視された(終了コード0・stderr空)。claude doctorのInvalid settings欄で検出できるが末尾はNo installation issues found.と出る。includeCoAuthoredByはattribution.commitがあると無視される。CLAUDE.mdの禁止ルールは4回中4回守られたが強制ではないため、gitのcommit-msgフックで署名行を取り除く最終防衛線までを1本のフローにした。プロンプトの「と」が「両方」と解釈され集計が0件になったつまずきも記載。
Claude Code活用

Claude CodeのCLAUDE.mdを/initで作る4手順と確認点

既存プロジェクトでClaude Codeの/initを使ってCLAUDE.mdを作る手順を、テスト3件のダミーNode.jsプロジェクトとCLI 2.1.289のclaude -pで検証した(有料実行10回・約1.91ドル)。acceptEditsだけではBashが許可されずテスト未確認のCLAUDE.mdになり、テストコマンドを--allowedToolsで許可するとTZ=UTCで失敗することまで確かめて書く。引数なしは英語、引数で日本語指定が効いた。2回目の/initは提案で止まらず直接3行追記(手書きの節は保持)。CLAUDE.md作成後はAGENTS.mdが読まれなくなるため@AGENTS.mdインポートに置き換える。CLAUDE_CODE_NEW_INIT=1はPreToolUseフックまで提案するが、.claude/は保護パスでacceptEditsでは作られず、費用は約5倍。提案どおりの正規表現はcatまで止めたため絞り込み、bypassPermissionsでもフックが実行を止めることを確認した。コピペ用プロンプト4本つき。
Claude Code活用

Claude Codeをcronで回すときの失敗検知: 判定4点と実測表

claude -pをcronやシェルスクリプトで回すときの失敗検知を、使い捨て環境でCLI 2.1.289を使って8つの失敗パターンを実際に起こして検証した。dontAskでの権限拒否と存在しないスラッシュコマンドは終了コード0・success、存在しないモデル名はis_error=trueなのにsubtype=success、SIGTERMでは終了コード143でJSONが0バイト(空入力のjqは終了コード0)、--max-budget-usd 0.001でも実費約0.0188ドルで停止、HOMEとPATHだけの最小環境ではUSERが無いと未ログイン扱いになることを実測。zshのechoがJSON内の\nを改行に変えてjqを壊す落とし穴も確認した。対策として、claude auth statusでの無料事前確認(約0.1秒)、終了コード+is_error+permission_denialsの3点判定、自前のタイムアウトをまとめたラッパースクリプト(8パターン通しで約49秒・約0.12ドル)と、期待結果・成功判定つきのコピペ用プロンプト3本を掲載。
Claude Code活用

Claude Codeの自作スラッシュコマンド: 作り方と実測5つの落とし穴

Claude Codeで自分専用のスラッシュコマンドを作る手順を、使い捨て環境での実機検証(CLI 2.1.289、claude -pで約20回)をもとに、置き場所→引数→シェル埋め込み→点検→自動化の1本の流れにまとめた。同名ならskillsがcommandsより優先されること、$0が1番目で$1は2番目、足りない番号は$2のまま残ること、!の直前に記号があると展開されないことを実測。さらに、claude -pではシェル埋め込みが失敗しても終了コード0・success・空の結果・0ドルになること(Issue #80223)、引数を!`echo $ARGUMENTS`に入れるとbypassPermissionsでは引数中のtouchまで実行され、モデルの「実行しない」という返答は実行後だったこと(defaultモードでは権限チェックで中断)を確認した。完結例としてgit履歴から日報メモを作る/daily-report(約16秒・約0.033ドル)と、期待結果・成功判定つきのコピペ用プロンプト3本を掲載。