Cmd. /claude-api
Claude API/Anthropic SDK 레퍼런스와 Managed Agents 자료를 불러오는 번들 skill 명령
핵심 요약
/claude-api는 프로젝트 언어(Python·TypeScript·Java·Go·Ruby·C#·PHP·cURL)에 맞는 Claude API와 Managed Agents 레퍼런스를 컨텍스트로 불러오는 번들 스킬입니다.- 도구 사용·스트리밍·배치·구조화 출력과 흔한 함정을 다루며, 코드가
anthropic또는@anthropic-ai/sdk를 import하면 자동 활성화됩니다. /claude-api migrate는 기존 코드를 새 모델로 업그레이드하며 모델 ID·thinking 설정 등 버전 간 변경 파라미터를 갱신합니다./claude-api managed-agents-onboard는 새 Managed Agent를 처음부터 만드는 대화형 워크스루를 실행합니다.
명령어 원본 선언
/claude-api [migrate|managed-agents-onboard]- 인자 없이 실행하거나,
migrate또는managed-agents-onboard서브커맨드를 붙일 수 있습니다.
공식 설명 요약
/claude-api는 Claude Code에 기본 포함된 번들 skill입니다. 프로젝트 언어(Python, TypeScript, Java, Go, Ruby, C#, PHP, cURL)에 맞는 Claude API 레퍼런스 자료와 Managed Agents 레퍼런스를 컨텍스트로 불러옵니다.
도구 사용(tool use), 스트리밍, 배치(batches), 구조화 출력(structured outputs), 흔한 함정(common pitfalls)을 다룹니다.
- 코드가
anthropic또는@anthropic-ai/sdk를 import하면 이 skill이 자동으로 활성화됩니다. /claude-api migrate: 기존 Claude API 코드를 더 새로운 모델로 업그레이드합니다. Claude가 어떤 파일을 스캔하고 어떤 모델을 타깃으로 할지 물어본 뒤, 모델 ID와 thinking 설정, 버전 간 바뀐 나머지 파라미터를 갱신합니다./claude-api managed-agents-onboard: 새 Managed Agent를 처음부터 만드는 대화형 워크스루를 실행합니다.
번들 skill은 고정 로직을 직접 실행하는 일반 내장 명령과 달리 프롬프트 기반입니다. Claude에게 상세한 지침을 주면 Claude가 도구를 써서 작업을 직접 오케스트레이션합니다.
최소 지원 버전
- 공식 명령 레퍼런스(
commands)에는/claude-api의 최소 버전이 별도로 명시되어 있지 않습니다. - 아래 "최근 변경"의 버전 정보는 Changelog/릴리스 노트 기준의 역사적 맥락입니다.
사용법
# 프로젝트 언어에 맞는 Claude API 레퍼런스를 불러와 구현 시작
/claude-api Next.js에서 Anthropic SDK로 스트리밍 챗 API 라우트를 만들어줘# 기존 코드를 더 새로운 모델로 마이그레이션
/claude-api migrate# 새 Managed Agent를 대화형으로 생성
/claude-api managed-agents-onboard최근 변경
v2.1.91:/claude-apiskill 가이드가 agent design patterns까지 확장되어, 도구 표면(tool surface), 컨텍스트 관리, 캐싱 전략 판단을 함께 다룹니다.v2.1.97~v2.1.98:/claude-apiskill이 Managed Agents alongside Claude API 기준으로 갱신되어, 단순 SDK 호출 예제뿐 아니라 에이전트 기반 서비스 설계의 출발점으로 쓸 수 있습니다.
좋은 사용 예
- 프로젝트 언어에 맞는 Claude API 레퍼런스를 불러와 도구 사용/스트리밍/배치 구현 시작
- 코드에
anthropic/@anthropic-ai/sdk를 추가한 뒤 skill 자동 활성화로 구현 도움 받기 /claude-api migrate로 모델 ID·thinking 설정 등 버전 간 변경 파라미터 일괄 업그레이드/claude-api managed-agents-onboard로 새 Managed Agent를 처음부터 구성
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/claude-api | Claude API/SDK·Managed Agents 레퍼런스 로딩 skill | Anthropic SDK 앱 개발·마이그레이션 시작 |
/mcp | 외부 도구/서버(MCP) 연결 관리 | 도구 연결/운영이 목적일 때 |
/agents | 서브에이전트 설정 관리 | 위임할 에이전트를 구성/관리할 때 |
활용 사례
- SDK 통합 시 흔한 함정과 구조화 출력 패턴을 빠르게 점검
- 모델 버전 업그레이드 시
migrate로 모델 ID·thinking 설정 변경을 자동 반영 - Managed Agents 기반 triage/review/orchestrator 역할 분리 설계의 출발점
주의사항
- 번들 skill은 프롬프트 기반이라 결과는 프로젝트 컨텍스트에 따라 달라집니다. 생성된 예시는 인증/권한/에러 처리 정책을 팀 기준으로 보완한 뒤 사용하세요.
- 자동 활성화는 코드가
anthropic또는@anthropic-ai/sdk를 import할 때 트리거됩니다. OpenAI 등 다른 SDK를 쓰는 파일에서는 동작하지 않습니다. migrate는 대상 파일과 타깃 모델을 먼저 확인하므로, 적용 전 스캔 범위와 모델 선택을 점검하세요.- 모델/요금제/토큰 한도 정책은 환경별로 별도 검토가 필요합니다.
출처
- Commands 레퍼런스: https://code.claude.com/docs/en/commands
- Skills(번들 skill): https://code.claude.com/docs/en/skills