Claude API 스킬

claude-api 스킬은 Claude에게 두 가지 Anthropic 표면에서 애플리케이션을 구축하기 위한 상세하고 최신의 참고 자료를 제공하는 오픈소스 Agent Skill입니다:

• Messages API — 단일 요청, 스트리밍 채팅, 도구 사용, 배치 처리, 프롬프트 캐싱, 구조화된 출력 및 사용자 정의 에이전트 루프를 위한 주요 표면입니다.
• Claude Managed Agents (베타) — Anthropic 호스팅 도구 실행, 지속적인 에이전트 구성 및 세션별 컨테이너를 갖춘 서버 관리형 상태 저장 에이전트를 위한 자사 표면입니다.

Messages API에 대해 8가지 프로그래밍 언어(Python, TypeScript, Java, Go, Ruby, C#, PHP 및 cURL)를 지원하며, Managed Agents에 대해 7가지 언어(Python, TypeScript, Java, Go, Ruby, PHP 및 cURL — C#은 현재 지원되지 않음)를 지원합니다.

이 스킬은 Claude Code와 함께 번들로 제공되며, 오픈소스 Anthropic 스킬 저장소에서도 사용할 수 있습니다. Agent Skills를 지원하는 모든 환경에 설치할 수 있습니다.

이 스킬은 점진적 공개를 사용하여 컨텍스트를 효율적으로 유지합니다: Claude는 프로젝트의 언어, 표면(Messages API 또는 Managed Agents) 및 특정 작업(도구 사용, 스트리밍, 배치 등)과 관련된 문서만 로드하며, 모든 것을 한 번에 로드하지 않습니다.

스킬이 제공하는 것

스킬이 활성화되면 Claude에게 다음을 제공합니다:

Messages API의 경우:

• 언어별 SDK 문서: 프로젝트 언어에 대한 설치, 빠른 시작, 일반적인 패턴 및 오류 처리
• 도구 사용 지침: 함수 호출에 대한 언어별 예제 및 개념적 기초, 사용 가능한 경우 베타 도구 실행기 포함
• 스트리밍 패턴: 채팅 UI 구축 및 증분 표시 처리를 위한 구현 세부 사항
• 배치 처리: 50% 비용으로 오프라인 배치 처리
• 프롬프트 캐싱: 접두사 안정성 설계, 중단점 배치 및 자동 무효화 감사
• 모델 마이그레이션: 최신 Claude 모델로 마이그레이션하기 위한 단계별 지침(Claude Opus 4.7의 주요 변경 사항 및 동작 변화 포함)
• 현재 모델 정보: 모델 ID, 컨텍스트 윈도우 크기 및 가격
• 일반적인 함정: API와 통합할 때 자주 발생하는 실수를 피하기 위한 상세 지침

Managed Agents (베타)의 경우:

• 온보딩 흐름: /claude-api managed-agents-onboard 하위 명령을 통해 사용 가능한 새로운 Managed Agent를 처음부터 설정하기 위한 인터뷰 기반 안내
• 언어별 Managed Agents 문서: Python, TypeScript, Java, Go, Ruby, PHP 및 cURL에 대한 지속적인 에이전트 생성, 세션 시작, 스트리밍 이벤트 및 도구 확인 처리
• 클라이언트 패턴: 무손실 스트림 재연결, processed_at 대기/처리 게이트, 인터럽트 처리, 파일 마운트 주의사항 및 자격 증명 처리
• 배포 제약: Managed Agents는 자사 전용입니다(Amazon Bedrock, Google Vertex AI 또는 Microsoft Foundry에서 사용 불가) — 스킬은 타사 배포를 Messages API + 도구 사용으로 라우팅합니다.

스킬이 활성화되는 시점

스킬은 두 가지 방식으로 활성화됩니다:

자동 활성화는 다음과 같은 경우에 발생합니다:

• 코드가 Anthropic SDK를 가져옵니다(Python의 경우 anthropic, TypeScript/JavaScript의 경우 @anthropic-ai/sdk)
• Claude에게 Claude API, Anthropic SDK 또는 Managed Agents를 사용하여 무언가를 구축, 디버깅 또는 최적화하도록 요청합니다
• 파일에서 Claude 기능을 추가, 수정 또는 조정합니다(프롬프트 캐싱, 적응형 사고, 압축, 도구 사용, 배치, 파일, 인용, 메모리) 또는 모델 참조

수동 호출은 스킬이 설치된 모든 환경에서 /claude-api(선택적 하위 명령 또는 텍스트 포함)를 입력하여 수행됩니다.

스킬은 일반 프로그래밍 작업, ML/데이터 과학 작업 또는 다른 AI SDK(예: OpenAI)를 가져오는 코드에 대해 활성화되지 않습니다.

지원되는 언어

스킬은 프로젝트 파일을 검사하여(예: Python의 경우 requirements.txt, TypeScript의 경우 tsconfig.json, Go의 경우 go.mod) 프로젝트의 언어를 자동으로 감지하고 적절한 문서를 로드합니다.

프로젝트에서 여러 언어를 사용하는 경우 Claude는 어느 것이 적용되는지 묻습니다. 지원되지 않는 언어(Rust, Swift, C++)의 경우 스킬은 cURL/원본 HTTP 예제를 제공합니다.

스킬 사용 방법

Claude Code에서 (번들)

스킬은 Claude Code와 함께 제공되며 설치가 필요하지 않습니다. Claude에게 Claude API를 사용하여 무언가를 구축하도록 요청하거나 프로젝트가 이미 Anthropic SDK를 가져올 때 스킬이 자동으로 활성화됩니다.

직접 호출할 수도 있습니다:

/claude-api

Claude Code의 번들 스킬 작동 방식에 대한 자세한 내용은 Claude Code 스킬 문서를 참조하세요.

스킬 저장소에서

스킬 소스는 Anthropic 스킬 저장소에서 사용할 수 있습니다. npx 명령을 사용하여 설치할 수 있습니다:

npx skills add https://github.com/anthropics/skills --skill claude-api

또는 Claude Code 플러그인으로 설치합니다:

/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills

최신 Claude 모델로 마이그레이션

Claude API 스킬은 코드베이스 전체에서 Claude 모델 마이그레이션을 수행할 수 있습니다. /claude-api migrate로 직접 호출합니다:

/claude-api migrate this project to claude-opus-4-7

범위 확인 질문을 건너뛰기 위해 특정 범위를 미리 전달할 수도 있습니다:

/claude-api migrate everything under src/ to claude-opus-4-7
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-4-7

범위가 모호한 경우(예: 단순 /claude-api migrate to claude-opus-4-7), 스킬은 파일을 편집하기 전에 전체 작업 디렉토리, 특정 하위 디렉토리 또는 명시적 파일 목록 중에서 선택하도록 요청합니다. 이는 Messages API 및 Managed Agents 호출자 모두에 적용됩니다.

스킬은 다음을 처리합니다:

• 모델 ID 교환, 모든 지원되는 언어에서 입력된 SDK 상수(Model.CLAUDE_OPUS_4_6 → Model.CLAUDE_OPUS_4_7) 포함, 각 파일을 호출자, 모델 정의자 또는 불투명 문자열 참조로 분류한 후 편집
• 주요 매개변수 변경, Claude Opus 4.7의 경우 temperature, top_p 및 top_k 제거, thinking: {type: "enabled", budget_tokens: N}을 thinking: {type: "adaptive"}로 변환
• 프리필 교체, 해당하는 경우 어시스턴트 메시지 프리필 패턴을 구조화된 출력으로 변환
• 베타 헤더 정리, 대상 모델에서 GA인 헤더 제거(예: effort-2025-11-24, fine-grained-tool-streaming-2025-05-14, interleaved-thinking-2025-05-14) 및 client.beta.messages.create에서 client.messages.create로 다시 전환
• 노력 보정, 대상 모델에 대한 output_config.effort 시작점 권장(예: Claude Opus 4.7의 코딩 및 에이전트 사용 사례의 경우 xhigh)
• 프롬프트 동작 조정, 대상 모델에서 다르게 동작할 수 있는 길이 제어, 도구 트리거, 하위 에이전트 및 지침 준수 프롬프트 플래그 지정
• 자동 기본값 처리, Claude Opus 4.7에서 사용자에게 추론이 표시될 때 사고 요약(thinking.display: "summarized")으로 다시 옵트인

편집하면서 스킬은 각 변경 사항과 그 동기를 인라인으로 설명합니다. 완료 시 수동 확인이 필요한 항목의 체크리스트를 생성합니다(일반적으로 통합 테스트, 길이 제어 프롬프트 조정 및 비용/속도 제한 재기준선).

스킬이 적용하는 모델별 변경 사항의 전체 목록은 Claude Opus 4.7로 마이그레이션을 참조하세요.

Managed Agent 설정

처음부터 새로운 Managed Agent를 스캐폴드하려면 managed-agents-onboard 하위 명령을 호출합니다:

/claude-api managed-agents-onboard

스킬은 Managed Agents 정신 모델(에이전트 구성 대 세션)을 안내하고, 에이전트 구성을 템플릿화하고, 환경 및 도구를 구성하고, 세션 루프를 설정하고, 언어에 대한 실행 가능한 코드를 내보내는 인터뷰를 실행합니다. 스킬은 또한 필수 에이전트(한 번) → 세션(매 실행마다) 흐름을 다룹니다 — model, system 및 tools는 에이전트에 있으며 세션에는 없으며, 에이전트는 한 번 생성되고 ID로 참조되어야 합니다.

Managed Agents는 managed-agents-2026-04-01 베타 헤더가 필요하며, SDK는 모든 client.beta.agents.*, client.beta.environments.*, client.beta.sessions.* 및 client.beta.vaults.* 호출에 대해 자동으로 설정합니다.

사용 예제

스킬이 Claude가 처리하도록 도와주는 작업의 예제입니다:

채팅 애플리케이션 구축:

Build a streaming chat UI with the Claude API in TypeScript

기존 프로젝트 마이그레이션:

/claude-api migrate this codebase to claude-opus-4-7 and re-tune effort

새로운 Managed Agent 온보딩:

/claude-api managed-agents-onboard

각 경우에 스킬은 관련 언어별 문서를 로드하고 현재 API 패턴 및 모범 사례를 사용하여 Claude를 구현 과정에서 안내합니다.

다음 단계