サイト改善のため、同意した場合だけGoogle AnalyticsとPostHogを読み込みます。拒否しても、学習コンテンツとお問い合わせは利用できます。詳細
株式会社BlueAI||法人向けAI導入・内製化支援
株式会社BlueAI 代表取締役CEO / ソフトウェアエンジニア / プロダクトエンジニア / Google Cloud Architect / 元AIスタートアップ(Doorkel)
Claude Code と VS Code の連携手順を3ステップで解説。拡張機能のインストール、ターミナル統合、Ctrl+G などショートカット、設定ファイルの書き方まで網羅。
CursorとClaude Codeの料金・機能・作業画面・自動化・チーム管理を比較。どちらを選ぶか、同じリポジトリで安全に併用する方法を解説します。
Claude Code・OpenAI Codex・Cursorを、作業画面、ローカル・クラウド実行、指示ファイル、自動化、チーム運用の観点で比較。仕事別の選定手順を公式情報に基づいて解説します。
連携先を増やす前に、作業範囲と確認ポイントをレッスンで整理します。
「Claude Code API」という名前の単一APIがあるわけではありません。プログラムから利用する方法は、目的によって次の3つに分かれます。
| やりたいこと | 選ぶ方法 |
|---|---|
| シェルやCIからClaude Codeを1回実行する | Claude Code CLIの-p |
| Claude Codeと同じAgentループをアプリへ組み込む | Claude Agent SDK |
| Claude APIを直接呼び、ツールループも自作する | Anthropic Client SDK / Messages API |
この記事では、2026年8月14日時点の公式仕様を基準に、認証、コード、料金、セキュリティを分けて解説します。
claude -p、製品組み込みならAgent SDKclaude -p既存のClaudeサブスクリプションでCLIを使える場合でも、自社製品へAgent SDKを組み込む認証条件は同じとは限りません。
Claude Codeは、モデルへの問い合わせだけでなく、次のAgent実行環境を含みます。
Messages APIをClient SDKから直接呼ぶ場合、アプリ側がリクエスト、ツール定義、ツール実行、会話状態、再試行、権限を実装します。細かい制御ができる一方、Agentループは自分で作ります。
Agent SDKは、Claude Codeを支えるAgentループ、組み込みツール、コンテキスト管理をTypeScriptまたはPythonから利用するライブラリです。CLIを画面操作するのではなく、自分のプロセス内でAgentを動かします。
claude -pでCLIを自動実行するClaude Codeがインストール済みなら、-p（--print）で1回の処理を実行できます。
claude -p "このリポジトリの構成を3行で説明してください"claude -p \
"変更差分をレビューし、重大度・ファイル・理由を返してください" \
--output-format json出力を別プログラムへ渡す場合は、人間向けテキストを解析せず、JSONまたはstream-jsonを選びます。
git diff --staged | claude -p \
"この差分だけをレビューし、重大な問題がなければOKと返してください"信頼できないログや差分をシェルへ再入力させないようにし、Claudeの出力をそのままコマンドとして実行しないでください。
CLIでは、日付付きの固定IDではなくモデルエイリアスを使えます。
claude -p "lintエラーの原因を分類して" --model haiku
claude -p "認証設計のリスクをレビューして" --model opussonnet、opus、haikuなどのエイリアスは、プロバイダーに応じた推奨バージョンへ更新されます。再現性のため特定バージョンを固定する必要がある場合だけ、公式の現行モデル名を指定します。
無人実行では承認画面を出せないため、事前許可した範囲以外を拒否するdontAskと、具体的なpermissionsを使います。
{
"permissions": {
"defaultMode": "dontAsk",
"allow": [
"Bash(npm run lint)",
"Bash(npm run test *)",
"Bash(git diff *)"
],
"deny": [
"Read(./.env)",
"Read(./.env.*)",
"Bash(git push *)"
],
"disableBypassPermissionsMode": "disable"
}
}CIのトークンには、読み取り専用など必要最小限の権限を付けます。確認を広く省略する--dangerously-skip-permissionsを、共有ランナーや本番資格情報のある環境で使わないでください。
npm install @anthropic-ai/claude-agent-sdk
npm install --save-dev tsxNode.js 18以降が必要です。SDKは通常、ネイティブのClaude Codeバイナリも依存関係として導入します。
export ANTHROPIC_API_KEY="<secret>"実値をソースコード、Git管理下の.env、CLAUDE.mdへ書かず、実行環境のシークレット管理から渡します。SDKは.envを自動では読み込みません。
import { query } from "@anthropic-ai/claude-agent-sdk";
for await (const message of query({
prompt: "src配下を確認し、未使用importを削除してください。",
options: {
allowedTools: ["Read", "Edit", "Glob", "Grep"],
permissionMode: "acceptEdits",
},
})) {
if (message.type === "assistant") {
console.log(message.message.content);
}
if (message.type === "result") {
console.log(message.subtype);
}
}query()は非同期イテレーターを返します。Agentが考え、ツールを呼び、結果を確認して終了するまで、メッセージが順に流れます。
上の例はBashを許可していません。テスト実行が必要になった場合だけ追加します。
const options = {
allowedTools: ["Read", "Edit", "Glob", "Grep", "Bash"],
permissionMode: "acceptEdits" as const,
};Bashを追加すると、任意コマンドへ到達できる範囲が広がります。SDK側のpermission callback、hooks、sandbox、コンテナの資格情報・ネットワーク制限を組み合わせてください。
Anthropic公式は、事前承認を受けていない第三者開発者が、製品内でclaude.aiログインやその利用枠を提供することを認めていません。Agent SDKで顧客向け製品を作る場合は、公式Quickstartが示すAPIキー等の認証方式とCommercial Termsを確認してください。
Agentループが不要で、Messages APIを直接制御したい場合はClient SDKを選びます。
npm install @anthropic-ai/sdkimport Anthropic from "@anthropic-ai/sdk";
const anthropic = new Anthropic();
const message = await anthropic.messages.create({
model: "claude-sonnet-5",
max_tokens: 1024,
messages: [
{
role: "user",
content: "TypeScriptのResult型を短い例で説明してください。",
},
],
});
console.log(message.content);Client SDKはAPI呼び出しを簡単にしますが、Claude CodeのファイルツールやAgentループを自動で提供するものではありません。
対象のPro、Max、Team、Enterpriseなどの利用枠でClaude Codeを使います。完全な無制限ではなく、プラン、モデル、usage creditsなどの条件があります。
Anthropic APIのモデル単価と実際の入力・出力・キャッシュトークンで課金されます。2026年8月14日時点の公式基本単価は次のとおりです。
| モデル | 入力 / 100万token | 出力 / 100万token |
|---|---|---|
| Claude Sonnet 5 | 2ドル | 10ドル |
| Claude Opus 5 | 5ドル | 25ドル |
| Claude Haiku 4.5 | 1ドル | 5ドル |
| Claude Fable 5 | 10ドル | 50ドル |
キャッシュ、Batch API、長いコンテキストなどは別条件があります。単価は変更されるため、実装時にAnthropic公式モデル一覧を確認してください。
料金全体の比較は
を参照してください。
/context：現在のコンテキスト内訳/usage：利用状況/cost：/usageのエイリアス。APIセッションではトークンと概算コストを確認サブスクリプションで表示される概算値を、そのまま請求額と解釈しないでください。
APIレスポンスやAgent SDKのresultメッセージから、入力・出力・キャッシュ・コスト情報を収集します。組織全体ではConsole、Admin API、OpenTelemetryなどを使い、利用者、モデル、タスク単位で追跡します。
haiku、日常実装はsonnet、難しい判断だけopusなどタスクで分ける/clearでセッションを分ける/compactで整理するmaxTurns、対象ディレクトリ、利用可能ツールを明示して探索範囲を制限する「10回話したら50%削減」のような固定率は、コード量や会話内容で変わるため根拠にしません。実際のusageで比較します。
Read denyへ登録した詳しい設定は
を参照してください。
claude -pが最短@anthropic-ai/claude-agent-sdk@anthropic-ai/sdk