結論
最初にやること:OSのターミナルでclaude agents --jsonを実行します。
Claude Codeは現在、Terminal、VS Code、JetBrains、Desktop、Webを同じエージェント基盤で扱い、単一のCLIラッパーという説明では不十分です。
中心はモデルがRead、Edit、Bash、Web、MCPなどのtoolを選ぶagent loopで、Skills、Hooks、Plugins、subagents、worktrees、Routinesにより拡張できます。
実行場所:OSのターミナルで実行します。
# ターミナルで実行:Claude Codeを指定条件で起動
claude agents --json
# ターミナルで実行:Claude Codeを指定条件で起動
claude -w feature-auth
# ターミナルで実行:非対話モードで単発処理を実行
claude -p "このリポジトリの依存関係をJSONで説明して" --output-format json --max-turns 3
具体的な手順
Agent SDKはClaude Codeと同じagent loopをPython・TypeScriptから利用でき、maxTurnsとmaxBudgetUsdで暴走を制限できます。
第三者向け製品でClaudeの能力を提供する場合は、自分のAPIキーまたは対応クラウド認証を使い、利用者のPro・Max OAuthを代理利用してはいけません。
- UI利用と製品組み込みを分離
CLAUDE.mdとsettingsの適用範囲を設計- tool allowlistとsandboxを設定
- subagent・worktreeで並列処理を隔離
- ResultMessageのcost・usage・exit statusを監視
入力場所:Claude Codeの対話画面へ貼り付けます。
# Claude Codeの対話画面へ貼り付ける依頼文
アーキテクトとしてこのリポジトリへのClaude Code導入案を作成してください。
対話開発、CIレビュー、障害調査、定期メンテナンスを別系統に分けてください。
各系統のsurface、tool、permission mode、sandbox、認証、Secret、予算、監査ログを明記してください。
導入前に脅威モデルと小規模PoCの評価指標も提示してください。
実践プロンプト
次のプロンプトをたたき台にし、対象範囲、禁止事項、完了条件を自分の環境へ合わせて具体化します。
入力場所:Claude Codeの対話画面へ貼り付けます。
開発者向け機能を安全に自動化する計画を作成してください。
対象、必要権限、検証コマンド、停止条件を提示し、承認前には変更を実行しないでください。
注意点
Hooks、MCP、Plugins、ユーザー設定は起動時に読み込まれるため、CIでは--bareや明示設定を使って開発者PCとの差を減らしてください。
並列agentは速度を上げますが同じファイルへの競合と費用増加を招くため、worktree、担当範囲、統合手順を固定してください。