claude-api: 공식 SDK로 Claude에 붙고, 먼저 폐기된 인자를 피한다

누구에게 맞나

claude-api는 프롬프트가 Claude 또는 Anthropic을 지목하고 모델, 인자, 스트리밍, 도구, 캐시 등의 참고가 필요한 사람용이다. Claude API / Anthropic SDK 참고이며 또 하나의 설치기가 아니다. 프롬프트가 어떤 형태로든 Claude/Anthropic을 지목하면 먼저 이 설명을 읽고, 「한 문장처럼 보인다」고 건너뛰지 말 것.

더 잘 맞는 쓰임은 기존 프로젝트에 Claude 호출을 더하거나 고칠 때이며, 그 프로젝트 언어에 이미 공식 Anthropic SDK가 있을 때다. 설명의 요구: Claude 기능을 구현할 때는 그 언어의 공식 SDK를 통해 호출해야 한다. 지정되지 않은 SDK의 의사코드를 대충 쓰거나 페이지 경로를 설치 명령으로 보는 사람에게는 맞지 않는다.

기본 모델은 Claude Opus 5로 적혀 있고 정확한 문자열은 claude-opus-5이다. 조금 복잡한 요청은 기본으로 adaptive thinking을 쓴다. 설명은 설치 명령을 주지 않는다. 현재 도우미가 아직 이 참고대로 코드를 고치지 못하면 기존 설명은 여기까지다. 주소에서 스킬 디렉터리를 역추산하지 말 것.

3분 안에 첫 시도 끝내기

공식 첫 경로는 참고에 따라 한 곳의 호출을 검사하거나 고치는 것이며 설치가 아니다. 설명 페이지는

https://raw.githubusercontent.com/anthropics/skills/main/skills/claude-api/SKILL.md

그 페이지의 제약만 따른다. 나타나지 않은 설치 문구를 쓰지 말고 코드에 비밀 자리 표시도 넣지 말 것.

전제: 현재 도우미가 이미 claude-api로 일할 수 있고, 버려도 되는 호출 조각이나 빈 함수가 있으며, 이 기기에는 그 언어의 공식 Anthropic SDK가 있다. 설치 명령이 없으므로 「위치」는 이 프로젝트 코드이며 추측한 스킬 디렉터리가 아니다.

저위험 첫 작업: 먼저 읽기 전용 검사를 한다. 기존 호출이 공식 SDK를 거치는지, 모델이 claude-opus-5인지, thinking이 adaptive인지, 폐기된 budget_tokens이 있는지를 보게 한다. 먼저 실제 계정에 긴 요청을 보내지 말 것. 성공 신호는 도우미가 위 네 가지 중 어긋남을 가리키고 코드를 고치기 전에 확인을 위해 멈추는 것이다.

고쳐야 하면 모델 문자열과 thinking 모양만 바꾼다: thinking: {type: "adaptive"}. 설명은 Claude 4.6+에서 budget_tokens이 폐기되었고 Opus 4.6 / Sonnet 4.6에서는 거부되어 400을 반환한다고 쓴다. 쓰기 확인이 보이면 먼저 비밀을 저장소에 쓰지 않았는지 확인한다.

사용 사례

사례 1: 프로젝트에 Claude 기능을 더한다. 프롬프트가 Claude/Anthropic을 지목하면 먼저 참고를 읽는다. 구현은 프로젝트 언어의 공식 Anthropic SDK를 통하고 모델은 claude-opus-5, 조금 복잡한 요청은 기본 adaptive thinking. 이미 언어를 고르고 호출만 맞게 쓰면 될 때 맞다. 기존 문장은 「공식 SDK」라는 한 경로만 펼치며 다른 SDK 이름을 쓰지 않는다. 지목되지 않은 래퍼로 바꾸지 말 것. 대조 페이지는

https://raw.githubusercontent.com/anthropics/skills/main/skills/claude-api/SKILL.md

사례 2: 400을 내는 옛 thinking 인자를 뺀다. Claude 4.6+에서는 thinking: {type: "adaptive"}를 써야 한다. budget_tokens은 Opus 4.6 / Sonnet 4.6에서 폐기되었고 거부되어 400을 반환한다. 옛 예에서 thinking 설정을 방금 복사해 요청이 바로 400일 때 맞다. 먼저 여기만 고친 뒤 실제 요청을 보낼지 정한다. 설명은 폐기된 필드를 모두 나열하지 않으므로 확인할 수 있는 것은 이 budget_tokens 한 줄뿐이다.

사용 경계

설치 명령 없음: 페이지 경로를 설치기로 쓰지 말 것. 트리거 경계: 프롬프트가 어떤 형태로든 Claude/Anthropic을 지목하면 먼저 읽고 한 문장으로 건너뛰지 말 것. 호출 경계: 기능 구현은 프로젝트 언어의 공식 Anthropic SDK를 거쳐야 한다. 기존 문장은 다른 병렬 방식을 펼치지 않는다. 모델 경계: 기본은 Claude Opus 5, 문자열 claude-opus-5. 복잡한 요청은 기본 adaptive thinking. 인자 경계: 지목된 4.6 모델에서 budget_tokens은 400을 낸다. 비밀 경계: 비밀 자리 표시를 쓰거나 코드에 비밀을 넣지 말 것. 이 참고는 가격, 스트리밍, 도구 등도 다루지만 기존 문장은 그 주제의 단계별 예를 주지 않는다.