SDK

# 単一のプロンプトを実行して終了（プリントモード）
$ claude -p "フィボナッチ数を計算する関数を書いてください"

# パイプを使用して標準入力を提供
$ echo "このコードを説明して" | claude -p

# メタデータを含むJSON形式で出力
$ claude -p "hello world関数を生成して" --output-format json

# JSONの出力を到着次第ストリーミング
$ claude -p "Reactコンポーネントを構築して" --output-format stream-json

# 最新の会話を続行
$ claude --continue

# 続行して新しいプロンプトを提供
$ claude --continue "今度はパフォーマンス向上のためにリファクタリングして"

# セッションIDで特定の会話を再開
$ claude --resume 550e8400-e29b-41d4-a716-446655440000

# プリントモード（非インタラクティブ）で再開
$ claude -p --resume 550e8400-e29b-41d4-a716-446655440000 "テストを更新して"

# プリントモード（非インタラクティブ）で続行
$ claude -p --continue "エラー処理を追加して"

# システムプロンプトを上書き（--printでのみ機能）
$ claude -p "REST APIを構築して" --system-prompt "あなたはシニアバックエンドエンジニアです。セキュリティ、パフォーマンス、保守性に焦点を当ててください。"

# 特定の要件を持つシステムプロンプト
$ claude -p "データベーススキーマを作成して" --system-prompt "あなたはデータベースアーキテクトです。PostgreSQLのベストプラクティスを使用し、適切なインデックス作成を含めてください。"

# システムプロンプトを追加（--printでのみ機能）
$ claude -p "REST APIを構築して" --append-system-prompt "コードを書いた後、必ず自分でコードレビューを行ってください。"

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/files"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your-github-token"
      }
    }
  }
}

# 設定からMCPサーバーを読み込む
$ claude -p "プロジェクト内のすべてのファイルをリストアップして" --mcp-config mcp-servers.json

# 重要：MCPツールは--allowedToolsを使用して明示的に許可する必要があります
# MCPツールは次の形式に従います：mcp__$serverName__$toolName
$ claude -p "TODOコメントを検索して" \
  --mcp-config mcp-servers.json \
  --allowedTools "mcp__filesystem__read_file,mcp__filesystem__list_directory"

# 非インタラクティブモードで権限プロンプトを処理するためのMCPツールを使用
$ claude -p "アプリケーションをデプロイして" \
  --mcp-config mcp-servers.json \
  --allowedTools "mcp__permissions__approve" \
  --permission-prompt-tool mcp__permissions__approve

// ツール呼び出しが許可される
{
  "behavior": "allow",
  "updatedInput": {...}, // 更新された入力、または元の入力をそのまま返す
}

// ツール呼び出しが拒否される
{
  "behavior": "deny",
  "message": "..." // 権限が拒否された理由を説明する人間が読める文字列
}

const server = new McpServer({
  name: "Test permission prompt MCP Server",
  version: "0.0.1",
});

server.tool(
  "approval_prompt",
  '権限チェックをシミュレート - 入力に "allow" が含まれている場合は承認し、それ以外は拒否します',
  {
    tool_name: z.string().describe("権限を要求しているツール"),
    input: z.object({}).passthrough().describe("ツールの入力"),
  },
  async ({ tool_name, input }) => {
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(
            JSON.stringify(input).includes("allow")
              ? {
                  behavior: "allow",
                  updatedInput: input,
                }
              : {
                  behavior: "deny",
                  message: "テストapproval_promptツールによって権限が拒否されました",
                }
          ),
        },
      ],
    };
  }
);

claude -p "..." \
  --permission-prompt-tool mcp__test-server__approval_prompt \
  --mcp-config my-config.json

$ claude -p "src/components/Header.tsxファイルを説明して"
# 出力: これはReactコンポーネントで...を表示しています

$ claude -p "データレイヤーはどのように機能しますか？" --output-format json

{
  "type": "result",
  "subtype": "success",
  "cost_usd": 0.003,
  "is_error": false,
  "duration_ms": 1234,
  "duration_api_ms": 800,
  "num_turns": 6,
  "result": "ここに応答テキスト...",
  "session_id": "abc123"
}

$ claude -p "アプリケーションを構築して" --output-format stream-json

type SDKMessage =
  // アシスタントメッセージ
  | {
      type: "assistant";
      message: Message; // Anthropic SDKから
      session_id: string;
    }

  // ユーザーメッセージ
  | {
      type: "user";
      message: MessageParam; // Anthropic SDKから
      session_id: string;
    }

  // 最後のメッセージとして出力される
  | {
      type: "result";
      subtype: "success";
      cost_usd: float;
      duration_ms: float;
      duration_api_ms: float;
      is_error: boolean;
      num_turns: int;
      result: string;
      session_id: string;
    }

  // 最大ターン数に達した場合、最後のメッセージとして出力される
  | {
      type: "result";
      subtype: "error_max_turns";
      cost_usd: float;
      duration_ms: float;
      duration_api_ms: float;
      is_error: boolean;
      num_turns: int;
      session_id: string;
    }

  // 会話の開始時に最初のメッセージとして出力される
  | {
      type: "system";
      subtype: "init";
      session_id: string;
      tools: string[];
      mcp_servers: {
        name: string;
        status: string;
      }[];
    };

#!/bin/bash

# Claudeを実行して終了コードをチェックするシンプルな関数
run_claude() {
    local prompt="$1"
    local output_format="${2:-text}"

    if claude -p "$prompt" --output-format "$output_format"; then
        echo "成功！"
    else
        echo "エラー：Claudeは終了コード$?で失敗しました" >&2
        return 1
    fi
}

# 使用例
run_claude "CSVファイルを読み込むPython関数を書いて"
run_claude "このデータベースクエリを最適化して" "json"

# ファイルをClaude経由で処理
$ cat mycode.py | claude -p "このコードのバグをレビューして"

# 複数のファイルを処理
$ for file in *.js; do
    echo "$fileを処理中..."
    claude -p "このファイルにJSDocコメントを追加して:" < "$file" > "${file}.documented"
done

# パイプラインでClaudeを使用
$ grep -l "TODO" *.py | while read file; do
    claude -p "このファイル内のすべてのTODO項目を修正して" < "$file"
done

# セッションを開始してセッションIDをキャプチャ
$ claude -p "新しいプロジェクトを初期化して" --output-format json | jq -r '.session_id' > session.txt

# 同じセッションを続行
$ claude -p --resume "$(cat session.txt)" "ユニットテストを追加して"