Cmd. /claude-api
Claude API/Anthropic SDK 레퍼런스와 Managed Agents 자료를 불러오는 번들 skill 명령
핵심 요약
- Claude API·Managed Agents 지원 skill
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
Claude API·Managed Agents 지원 skill
/claude-api [migrate|upgrade|managed-agents-onboard|prompt-audit|cost-optimize|build-eval|hillclimb]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 번들 스킬 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
하위 작업별 지원 버전이 다릅니다. build-eval·hillclimb는 v2.1.259+에서 확인됩니다.
사용 예
/claude-api prompt-audit# 프로젝트 언어에 맞는 Claude API 레퍼런스를 불러와 구현 시작
/claude-api Next.js에서 Anthropic SDK로 스트리밍 챗 API 라우트를 만들어줘# 기존 코드를 더 새로운 모델로 마이그레이션
/claude-api migrate# API 코드의 비용 최적화 기회를 분석하고 적용
/claude-api cost-optimize# 새 Managed Agent를 대화형으로 생성
/claude-api managed-agents-onboard선택 시점
- 프로젝트 언어에 맞는 Claude API 레퍼런스를 불러와 도구 사용/스트리밍/배치 구현 시작
- 코드에
anthropic/@anthropic-ai/sdk를 추가한 뒤 skill 자동 활성화로 구현 도움 받기 /claude-api migrate로 모델 ID·thinking 설정 등 버전 간 변경 파라미터 일괄 업그레이드/claude-api managed-agents-onboard로 새 Managed Agent를 처음부터 구성/claude-api cost-optimize전후에 같은 traffic·품질 지표로 비용을 측정해 변경 효과 검증
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/claude-api | Claude API/SDK·Managed Agents 레퍼런스 로딩 skill | Anthropic SDK 앱 개발·마이그레이션 시작 |
/mcp | 외부 도구/서버(MCP) 연결 관리 | 도구 연결/운영이 목적일 때 |
/agents | 서브에이전트 설정 관리 | 위임할 에이전트를 구성/관리할 때 |
실행 결과와 유지 범위
프로젝트 언어에 맞는 API 지침을 불러오거나 선택한 하위 작업을 수행합니다. 마이그레이션·최적화가 파일을 바꿀 때는 diff를 확인합니다.
/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 upgrade: 현재 공식 reference 기준 PythonanthropicSDK 0.x 코드를 1.x로 옮깁니다. timeout도httpx.Timeout이 아니라anthropic.Timeout을 사용하도록 마이그레이션합니다./claude-api cost-optimize(v2.1.247 release note): 기존 API spend를 profile한 뒤 prompt caching, token hygiene, Message Batches, effort, model choice를 검토하고 한 번에 하나의 측정 가능한 변경을 적용합니다./claude-api managed-agents-onboard: 새 Managed Agent를 처음부터 만드는 대화형 워크스루를 실행합니다.
번들 skill은 고정 로직을 직접 실행하는 일반 내장 명령과 달리 프롬프트 기반입니다. Claude에게 상세한 지침을 주면 Claude가 도구를 써서 작업을 직접 오케스트레이션합니다.
주의사항
- 번들 skill은 프롬프트 기반이라 결과는 프로젝트 컨텍스트에 따라 달라집니다. 생성된 예시는 인증/권한/에러 처리 정책을 팀 기준으로 보완한 뒤 사용하세요.
- 자동 활성화는 코드가
anthropic또는@anthropic-ai/sdk를 import할 때 트리거됩니다. OpenAI 등 다른 SDK를 쓰는 파일에서는 동작하지 않습니다. migrate는 대상 파일과 타깃 모델을 먼저 확인하므로, 적용 전 스캔 범위와 모델 선택을 점검하세요.upgrade는 현재 reference상 일반적인 “모든 언어 최신화”가 아니라 Python SDK 0.x→1.x migration입니다. 다른 언어는/help와 해당 SDK 공식 migration guide를 별도로 확인하세요.cost-optimize는 여러 최적화를 한꺼번에 섞지 말고 baseline을 기록한 뒤 한 변경씩 측정하세요. 출력된 절감 추정치는 실제 invoice가 아닙니다.- 모델/요금제/토큰 한도 정책은 환경별로 별도 검토가 필요합니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록