Claude Code SDK, 이제 Claude Agent SDK로

Claude Code를 자동화하는 두 가지 방법

간단한 방법은 CLI의 출력 모드입니다 — claude -p 어떤 언어에서든 JSON 출력으로 사용할 수 있습니다. 전체 기능을 활용하려면 Agent SDK를 사용하면 됩니다. Agent SDK는 루프, 도구 모음, 훅, 권한을 직접 제어할 수 있는 객체로 제공합니다.

Python

import anyio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    options = ClaudeAgentOptions(
        allowed_tools=["Read", "Edit", "Bash"],
        max_turns=8,
    )
    async for message in query(
        prompt="add type hints to utils.py and run the tests",
        options=options,
    ):
        print(message)

anyio.run(main)

TypeScript

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "find and fix the flaky test in this repo",
  options: { allowedTools: ["Read", "Edit", "Bash"], maxTurns: 8 },
})) {
  console.log(message);
}

게이트웨이를 통해 실행하기

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
python agent.py

SDK는 동일한 Claude Code 런타임을 실행하므로 환경 변수만 설정하면 됩니다. 장시간 실행되는 에이전트에서는 게이트웨이 요금이 특히 중요합니다. 자율 루프는 시간당 수백 번 호출할 수 있으며, 정액제 요금제를 사용하면 예상 비용이 고정 금액으로 바뀝니다.

출력 모드에 비해 SDK가 제공하는 추가 기능

• 권한 콜백 — 자체 코드에서 각 도구 호출을 승인하거나 거부합니다.
• 프로세스 내 MCP 서버를 통한 사용자 정의 도구로 에이전트가 사용자의 함수를 호출할 수 있습니다.
• 도구 이벤트, 세션 수명 주기, 오류에 대한 훅입니다.
• 셸 명령을 실행하고 텍스트를 파싱하지 않고도 서브에이전트와 구조화된 출력을 사용할 수 있습니다.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

자주 묻는 질문

AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.