# Claude Agent SDKの便利で実践的な使い方 🔐 ツールアクセスを段階的に制御して、安全と生産性のバランスを取りましょう。 パーミッションの設定は、`allowed_tools` / `disallowed_tools` / `permission_mode` でエージェントのツール利用を多段階に制御し、安全な運用を実現する機能です。 📌 タイトル：パーミッションの設定 🔗 URL： 🧩 概要 評価順序は「フック→拒否ルール→パーミッションモード→許可ルール→canUseTool」です。`disallowed_tools` はスコープ付き拒否（例: `Bash(rm *)`）に対応し、`bypassPermissions` でもブロックされる最終防衛線です。 🛠 使い方 `allowed_tools` で自動承認するツールを、`disallowed_tools` でブロックするツール（スコープ付き拒否も可：`"Bash(rm *)"`）を、`permission_mode` で全体のモード（`default` / `acceptEdits` / `dontAsk` / `plan` / `bypassPermissions`）を設定します。 🏗 実践的な使い方 ・`allowedTools: ["Read","Glob","Grep"]` + `permissionMode: "dontAsk"` で許可ツール以外は即拒否する読み取り専用ロックダウンを構築します。 ・`default` で開始し、初期アプローチをレビュー後に `acceptEdits` へ動的切替。プロトタイピングの反復を高速化します。 ・`plan` モードで読み取り専用ツールのみ実行し、Claude にソース変更なしで計画だけ立てさせます。コードレビューや変更前承認フローに最適です。 ・CI/隔離環境では `bypassPermissions` を使用しつつ、`disallowed_tools=["Bash(rm -rf /)"]` で最終防衛線を設けます。 💡 ユースケース 🔒 読み取り専用のコード分析エージェント 📋 plan モードによる変更前承認フロー 🚀 段階的信頼レベルの動的切替 ⚠️ 注意点 `allowed_tools` は `bypassPermissions` を制限しません。危険操作のブロックには必ず `disallowed_tools` を使用してください。サブエージェントは親のパーミッションモードを継承し、上書きできません。 #ClaudeAgentSDK# #AI#

# Claude Agent SDKの便利だけど知られていない機能 🌍 Bashは使わせたいけどrmは禁止したい？スコープ付きルールでコマンド単位の制御ができます！ Claude Agent SDKでは、`Bash(npm *)` のようにツール名にスコープを付けて、コマンド単位で許可・拒否を細かく制御できます。 📌 タイトル：コマンド単位のスコープ指定 🔗 URL： 🧩 概要 `allowed_tools` や `disallowed_tools` にスコープ付きのルール（例：`Bash(npm *)`）を指定すると、ツール内の特定コマンドだけを許可・拒否できます。スコープなしでツール名を `disallowed_tools` に入れると（例：`Bash`）、ツール定義自体がClaudeのコンテキストから除去され、Claudeはそのツールの存在すら認識しません。一方、スコープ付きの拒否ルール（例：`Bash(rm *)`）は、Bashツール自体は利用可能に保ちつつ、マッチするコマンドだけを拒否します。 🛠 使い方 ```python # Python - npmコマンドのみ許可し、rmを明示的に禁止 import asyncio from claude_agent_sdk import query, ClaudeAgentOptions async def main(): async for message in query( prompt="依存関係をインストールしてテストを実行してください", options=ClaudeAgentOptions( allowed_tools=[ "Read", "Grep", "Glob", "Bash(npm *)", # npmコマンドのみ自動承認 "Bash(npx jest *)", # テスト実行も許可 ], disallowed_tools=[ "Bash(rm *)", # 削除は禁止（bypassPermissionsでも拒否） "Bash(sudo *)", # sudoも禁止 ], permission_mode="dontAsk", ), ): if hasattr(message, "result"): print(message.result) ``` ```typescript // TypeScript const options = { allowedTools: [ "Read", "Grep", "Glob", "Bash(npm *)", // Only npm commands auto-approved "Bash(npx jest *)", // Test execution allowed ], disallowedTools: [ "Bash(rm *)", // Delete denied even in bypassPermissions "Bash(sudo *)", // sudo also denied ], permissionMode: "dontAsk" }; ``` 🏗 本番システムへの組み込み方 ・CIエージェントで `Bash(npm *)` や `Bash(make *)` だけを許可し、それ以外のシェル操作を禁止します ・`disallowed_tools` のスコープ付きルールは `bypassPermissions` モードでも有効なため、最終防衛ラインとして使えます ・ベアネーム（スコープなし）の拒否はツールをコンテキストから完全に除去し、スコープ付き拒否はステップ2で評価される点を理解して設計します ・環境ごとに異なるスコープルールを設定し、開発/ステージング/本番で適切な制限を適用します 💡 ユースケース 🔧 ビルドエージェントで `npm install` と `npm test` だけを許可する 🛡 `rm -rf` や `sudo` を全モードで禁止する安全ガードレール 📦 パッケージマネージャのコマンドだけを許可するデプロイエージェント ⚠️ 注意点 ・ベアネーム拒否（`disallowed_tools=["Bash"]`）はツール定義自体を除去するため、Claudeはそのツールを使おうとすらしません ・スコープ付き拒否（`disallowed_tools=["Bash(rm *)"]`）はBashを残したまま特定パターンだけを拒否します ・スコープパターンのマッチングはグロブベースです。複雑なコマンドチェーンやパイプには注意してください ・`allowed_tools` に入れたスコープルールは自動承認ですが、`bypassPermissions` を制限するものではありません ✨ スコープ付きルールを使えば、「このツールは使えるけど、この操作だけはダメ」という精密な制御が可能です。安全なエージェントの設計に欠かせない機能です！ #ClaudeAgentSDK# #AIAgent#

# Claude Codeの機能と実践的な使い方 🔒 「どこまで自律的に動かすか」を細かく制御できる。信頼できない調査は読み取り専用、信頼環境では自動承認と、安全と効率を両立する仕組みです。 📌 タイトルと機能のURL タイトル: 権限 / サンドボックス URL: 📝 概要 Claude Codeは、エージェントが何をできて何をできないかを正確に指定できる、きめ細かい権限システムを備えています。allow/ask/denyのルールと権限モードを組み合わせ、設定はバージョン管理に含めてチーム全体へ配布できます。さらにサンドボックスでOSレベルの隔離も可能です。 🔧 機能の説明 ・読み取り専用ツール（ファイル読み込みやGrep）は承認不要、Bashコマンドやファイル編集は承認が必要、という階層型の権限制御です。 ・ルールは「deny → ask → allow」の順で評価され、最初に一致したものが結果を決めます。denyはどのスコープにあっても最優先で、allowで上書きできません。 ・権限モードはdefault / acceptEdits / plan / auto / dontAsk / bypassPermissionsがあります。planは読み取りと読み取り専用コマンドのみ、bypassPermissionsはほぼ全許可で危険です。 ・権限ルールはモデルではなくClaude Codeが強制します。CLAUDE.mdの指示は「何を試みるか」を変えても「何を許可するか」は変えません。 🛠 実践的な使い方 ・セッション中は「/permissions」で全ルールと出所のsettings.jsonを確認・編集できます。 ・ルール構文は「Tool」または「Tool(specifier)」です。例: Bash(npm run build) / Read(./.env) / WebFetch(domain: ・settings.jsonのpermissions.allow / deny 配列に記述します。例: allowに「Bash(npm run *)」、denyに「Bash(git push *)」「Read(./.env)」。 ・読み取り専用で調査したいときはplanモードを使うか、denyに「Edit」「Write」を入れ、Bashを絞ります。サブエージェントはAgent(Explore)等で制御します。 ・追加ディレクトリへのアクセスは「--add-dir」や「/add-dir」、永続化はadditionalDirectoriesで付与します。 🎯 ユースケース ・信頼できないリポジトリの調査時はplanモードで、ソースを書き換えずに構造把握だけ行う。 ・チーム共有の.claude/settings.jsonに安全なallow/denyを定義し、全員に同じガードレールを配布する。 ・コンテナやVM内ではbypassPermissionsで承認をスキップし、CIや一括作業を高速化する。 ・サンドボックスの ⚠️ 注意点 ・bypassPermissionsは.gitや.claude等への書き込みも承認をスキップするため、隔離環境でのみ使用してください（rm -rf / 等はサーキットブレーカーで停止）。 ・curlのURLを引数で縛る権限パターンは脆弱です。Bashネットワークツールをdenyし、WebFetch(domain:...)で許可ドメインを指定する方が確実です。 ・Read/Edit のdenyは組み込みファイルツールと認識可能なBashコマンドにのみ効き、Python等のスクリプトが直接開くファイルには及びません。全プロセスを縛るならサンドボックスを使います。 ・managed settingsは他のどのスコープからも上書きできません。組織方針はここで強制します。 #ClaudeCode# #DevTools#

Claude Codeでアーキテクチャ図とかシーケンス図を作るskill「diagram-design」 27種、出力は単体のHTML+SVG 角丸だらけの汎用図を避けて、色とフォントをサイトから寄せられる こういう図作るの大変だからめっちゃ助かるマダガスカル

Claude Codeの別セッションに送れるの便利ですね。送り先セッションを雑に探してくれます。 コンテキストを引き継ぎいだベースの指示が自動で可能なので、 ・コンテキストが埋まった時に/clear後が楽 ・/forkでもよかったが、全コンテキストを引き継がなくて良いので、時によって使い分けができる

# Claude Agent SDKの便利だけど知られていない機能 🌍 セッション途中で権限を変えたい？ストリーミング中に権限モードを動的に切り替えられます！ Claude Agent SDKでは、セッション実行中に `set_permission_mode()` を呼ぶだけで、権限モードを即座に変更できます。 📌 タイトル：ストリーミング中の権限モード動的変更 🔗 URL： 🧩 概要 `set_permission_mode()`（Python）/ `setPermissionMode()`（TypeScript）を使うと、セッションの途中で権限モードをリアルタイムに変更できます。新しいモードは即座に有効となり、以降のすべてのツールリクエストに適用されます。「最初は厳格に、信頼が築けたら緩める」という段階的な権限管理が実現できます。 🛠 使い方 ```python # Python - 段階的に権限を緩和する例 import asyncio from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions async def main(): async with ClaudeSDKClient( options=ClaudeAgentOptions( permission_mode="default", # まずはデフォルトで開始 ) ) as client: await client.query("このコードをリファクタリングしてください") # アプローチを確認後、編集を許可 await client.set_permission_mode("acceptEdits") async for message in client.receive_response(): if hasattr(message, "result"): print(message.result) ``` ```typescript // TypeScript const q = query({ prompt: "Refactor this code", options: { permissionMode: "default" } }); // アプローチ確認後に編集を許可 await q.setPermissionMode("acceptEdits"); for await (const message of q) { if ("result" in message) console.log(message.result); } ``` 🏗 本番システムへの組み込み方 ・「plan → 確認 → acceptEdits」のワークフローで、安全なステップバイステップの自動化を実現します ・ユーザーの信頼度や操作の進行状況に応じて、段階的に権限を拡大するインタラクティブなアプリを構築できます ・エラー検出時に権限を引き締める「フォールバック」パターンにも活用できます ・監視システムと連携し、異常検知時に自動的に制限的なモードへ切り替えることも可能です 💡 ユースケース 🔐 コードレビュー後に編集権限を付与する対話型ワークフロー 📈 タスクの進捗に応じて権限を段階的に拡大するプログレッシブな自動化 🛡 異常を検知したら即座に制限モードに切り替える防御的エージェント ⚠️ 注意点 ・新しいモードは即座に有効になるため、切り替えのタイミングに注意してください ・モード変更は現在のセッション内でのみ有効です ・`bypassPermissions` や `auto` モードに切り替えた場合、サブエージェントにも継承される点に注意が必要です ✨ 権限の動的変更は「最初は安全に、必要に応じて柔軟に」を実現する強力なツールです。段階的な信頼構築のワークフローにぜひ活用してください！ #ClaudeAgentSDK# #AIAgent#

# Claude Agent SDKの便利で実践的な使い方 🤖 サブエージェントに専門タスクを委譲して、メインコンテキストをリーンに保てます。 サブエージェントは、特定のサブタスクを専門エージェントに委譲し、メインエージェントのコンテキストを汚さずに並列・専門処理を実現する機能です。 📌 タイトル：SDK のサブエージェント 🔗 URL： 🧩 概要 `agents` パラメータで専門エージェントを定義し、メインエージェントが `Agent` ツール経由で呼び出します。各サブエージェントには独自のプロンプト・ツール制限・モデル設定が可能で、結果は要約としてメインに返されます。 🛠 使い方 `agents` パラメータに `AgentDefinition`（`description`・`prompt`・`tools`・`model` 等）を定義します。`allowed_tools` に `"Agent"` を含めるとサブエージェント呼び出しが自動承認されます。各サブエージェントは独自のツール制限・プロンプト・モデルを持てます。 🏗 実践的な使い方 ・`research-assistant` サブエージェントに数十ファイルの探索を委譲し、親エージェントには要約だけ返します。メインコンテキストがリーンに保たれます。 ・`style-checker` / `security-scanner` / `test-coverage` を同時実行し、コードレビュー時間を数分→数秒に短縮します。 ・`database-migration` サブエージェントに SQL ベストプラクティス・ロールバック戦略のプロンプトを持たせ、メインを汚さず専門タスクを処理します。 ・ファクトリ関数で実行時条件に応じて `model: "opus"` / `sonnet` を動的に切り替えます。 💡 ユースケース 🔍 大量ファイル探索の委譲 ⚡ 並列コードレビュー（style/security/coverage） 🎯 専門知識エージェントへのタスク分割 ⚠️ 注意点 サブエージェントは自分のサブエージェントを生成できません（1 段階のみ）。大規模オーケストレーションには `Workflow` ツール（TS v0.3.149+）を使用してください。`agentId` と `session_id` をキャプチャすれば `resume` でフォローアップも可能です。 #ClaudeAgentSDK# #AI#

Claude CodeというかAI本当に凄い 特に「複雑なプロセス理解をしよう！」の時 フォルダごとがさっ！と投入すると普通に解説してくれて、資料や大量Excelファイルをコーディングして読み取る。最終成果に向けてどんな事してるか数分で把握。 人が理解するなら何日かかるんだ？がタイムワープ的魔法に

Claude、ＭＡＸで契約しているはずが、無邪気に定期実行タスクを組みすぎたのか、起動して一瞬で今週の利用制限に引っ掛かりそうになっている…が、さすがになんかおかしい気もする。先週より明らかにヘリが早いというか、なんで今週だけこんなに？