公式 Claude Agent SDK：正直で監査可能なパーソナルアシスタント（2026）
Anthropic の Claude Agent SDK は、Claude Code と同じツールループを自前の Python または TypeScript アプリに組み込めます。初めての方へ：まず読み取り専用から始め、正直さを求める system_prompt を付け、監査ログが問題なければ allowed_tools を段階的に広げてください。
関連：SSH 経由の Claude Code、Cursor Rules と Skills、Opus 4.8 エージェントベンチマーク。
公式 SDK から始める理由
ラッパーはどのツールが動き、何がマシンから出るかを隠しがちです。SDK は code.claude.com で Read、Edit、Bash、permissions、hooks、sessions を文書化しています。
24/7 スケジュール用のクラウド Mac は任意です。最初のガード付きヘルパーはノート PC で十分です。
SDK の構成
| 層 | 役割 | 設定項目 |
|---|---|---|
query() | エージェントループ（計画 → ツール → 観察） | agent.py |
| Tools | ファイル、シェル、検索、Web | allowed_tools |
| Permissions | 承認 / 拒否 / プロンプト | permission_mode |
| Policy | 正直さ、スコープ | system_prompt、CLAUDE.md |
| Audit | ツール使用の記録 | hooks |
2026 年 6 月 15 日以降、サブスクリプションは別クレジットプールで Agent SDK を計量します。無人ループには予算を組んでください。
8 ステップのガード付きランブック
ステップ 1 — 前提条件
python3 --version # 3.10+
pip install claude-agent-sdkステップ 2–3 — プロジェクトとインストール
mkdir my-guarded-agent && cd my-guarded-agent
python3 -m venv .venv && source .venv/bin/activate
pip install claude-agent-sdkステップ 4 — API キー
# .env (gitignore this file)
ANTHROPIC_API_KEY=sk-ant-...ステップ 5–6 — 正直プロンプト + 読み取り専用実行
from claude_agent_sdk import query, ClaudeAgentOptions
HONEST = """Say "I don't know" when data is missing.
Never invent paths or command output."""
options = ClaudeAgentOptions(
allowed_tools=["Read", "Glob", "Grep"],
permission_mode="dontAsk",
system_prompt=HONEST,
)実行：python3 agent.py — quickstart 参照。
ステップ 7–8 — 監査 hook、その後編集
Edit と permission_mode="acceptEdits" を有効にする前に、PostToolUse の hooks で audit.log へ記録してください。任意：AskUserQuestion で確認。
トラブルシューティング
API キーが見つからない
対処：同じシェルで ANTHROPIC_API_KEY を export。 .env はコミットしない。
pip: No matching distribution
対処：Python 3.10+ を使用し、.venv を作り直す。
thinking.type.enabled not supported
対処：Opus 4.7+ には Agent SDK を v0.2.111+ にアップグレード（[quickstart](https://code.claude.com/docs/en/agent-sdk/quickstart)）。
想定外のファイル編集
対処：git で戻す。hooks が安全と分かるまで dontAsk と読み取り専用ツールに戻す。
FAQ
query() と ClaudeAgentOptions で埋め込むライブラリです。dontAsk と Read、Glob、Grep のみ。