claude-api — Claude Code 스킬

Claude API/Anthropic SDK 사용을 돕는 공식 스킬 — 모델 id·가격·파라미터·스트리밍·툴 사용·캐싱 레퍼런스. 메모리에 의존하지 않고 정확한 API 정보를 참조.

claude-api는 Anthropic이 배포하는 공식 Claude Code 스킬로, Claude API와 Anthropic SDK를 사용해 LLM 애플리케이션을 만들 때 정확한 레퍼런스를 제공합니다. 핵심 문제는 "기억에 의존한 추측"입니다. 모델 id, 토큰 가격, 요청 파라미터, SDK 메서드 시그니처는 자주 바뀌고 학습 컷오프 이후에 새 모델이 나오기 때문에, 메모리만으로 코드를 쓰면 잘못된 모델 문자열(404)이나 폐기된 파라미터(400)를 만들기 쉽습니다. 이 스킬은 그런 정보를 스킬 내부 문서와 라이브 소스(WebFetch)에서 끌어와 검증된 값만 쓰도록 강제합니다.

다루는 범위는 넓습니다. 현재 모델과 가격, 적응형 사고(adaptive thinking)와 effort 파라미터, 스트리밍, 함수 호출/툴 사용(SDK 툴 러너 또는 수동 에이전트 루프), 서버사이드 툴(코드 실행·웹 검색), 구조화 출력, 프롬프트 캐싱, 토큰 카운팅, 배치·파일 API, MCP 연동, 그리고 모델 마이그레이션 가이드까지 포함합니다. 언어별로 Python, TypeScript(JS 동일), Java/Kotlin/Scala, Go, Ruby, C#, PHP, 그리고 SDK가 없는 환경용 cURL 예제를 갖추고 있어 프로젝트 언어를 감지한 뒤 해당 SDK의 정확한 호출 형태를 안내합니다. 또한 서버가 에이전트 루프를 직접 돌리는 Managed Agents 같은 상위 추상화도 별도로 설명합니다.

누가 쓰면 좋은가: Claude로 분류·요약·추출·챗봇·에이전트·RAG·LLM 심판 등 LLM 기능을 새로 추가하거나 디버깅하는 개발자, 모델을 최신 버전으로 옮기려는 팀, 스트리밍/툴콜/토큰/거절(refusal) 같은 까다로운 동작을 정확히 다뤄야 하는 경우입니다. 트리거 원칙은 명확합니다 — 프롬프트에 Claude/Anthropic/Opus/Sonnet/Haiku 등이 등장하거나 LLM의 가격·모델 선택·한도·캐싱을 묻는 작업이면 기억으로 답하지 말고 이 스킬을 먼저 참조합니다. 반대로 OpenAI/Gemini 등 다른 공급자를 다루는 코드에는 적용하지 않습니다.

언제 쓰나

Claude API/Anthropic SDK로 코드를 추가·수정·디버깅할 때, 즉 분류·요약·추출·챗봇·툴 사용·에이전트·RAG 같은 LLM 기능을 Claude로 구현하거나, 모델을 최신 버전으로 마이그레이션하거나, 스트리밍·토큰·가격·캐싱·거절 처리 같은 세부 동작을 정확히 알아야 할 때 사용합니다. 프롬프트에 Claude/Anthropic/Opus/Sonnet/Haiku가 언급되면 기억 대신 이 스킬을 먼저 참조하세요. 단, OpenAI·Gemini 등 다른 공급자를 다루는 파일에는 쓰지 않습니다.

설치

git clone https://github.com/anthropics/skills 후 skills/claude-api 를 .claude/skills/ 로 복사. 또는 /plugin 공식 마켓플레이스에서 설치.

공식 스킬 저장소를 git clone 한 뒤 skills/claude-api 폴더를 프로젝트 또는 사용자 디렉터리의 .claude/skills/ 아래로 복사하거나, Claude Code의 공식 /plugin 마켓플레이스에서 설치합니다. 환경변수나 별도 API 키는 필요 없습니다(스킬은 참조 문서일 뿐 직접 API를 호출하지 않음). 다만 스킬이 안내하는 코드를 실제로 실행하려면 ANTHROPIC_API_KEY 같은 자격증명과 해당 언어 SDK 패키지가 따로 필요합니다. "최신" 정보가 필요할 때는 라이브 문서 WebFetch가 동작하도록 네트워크 접근이 권장됩니다.

보안 주의

이 스킬 자체는 추가 권한이나 비밀키를 요구하지 않습니다. 하지만 스킬이 생성한 코드를 실행하려면 ANTHROPIC_API_KEY(또는 OAuth 토큰)가 필요하며, 키는 환경변수·시크릿 매니저로 관리하고 코드·로그·프롬프트에 하드코딩하지 마세요. 키 유출은 직접 과금 피해로 이어집니다. 툴 러너는 Claude 요청 시 함수를 자동 실행하므로 메일 발송·DB 변경·삭제 등 부수효과 툴은 입력 검증과 승인 게이트(수동 루프)를 두는 게 안전합니다. 사용자 입력이나 외부 콘텐츠가 프롬프트에 들어가면 인젝션 위험이 있으니, 운영 지시는 신뢰 가능한 system 채널로 전달하세요.

자주 묻는 질문

claude-api 스킬을 쓰면 Claude를 자동으로 호출하나요?

아니요. 이 스킬은 정확한 API 정보를 참조해 올바른 코드를 작성하도록 돕는 레퍼런스입니다. 실제 API 호출은 스킬이 생성한 코드를 ANTHROPIC_API_KEY와 SDK로 직접 실행할 때 일어납니다.

어떤 언어를 지원하나요?

Python, TypeScript/JavaScript, Java/Kotlin/Scala, Go, Ruby, C#, PHP의 공식 SDK 예제와, SDK가 없는 환경용 cURL/raw HTTP 예제를 제공합니다. 스킬이 프로젝트 언어를 감지해 해당 SDK의 정확한 호출 형태를 안내합니다.

OpenAI·Gemini 등 다른 LLM에도 쓸 수 있나요?

아니요. 이 스킬은 Claude/Anthropic SDK 코드를 위한 것입니다. 다른 공급자를 다루는 파일에는 적용하지 않으며, 최신 모델 id나 가격이 불확실할 때는 공식 문서 확인을 권장합니다.