claude-api

Overview

claude-api로 할 수 있는 일

claude-api 스킬은 Claude API, 공식 Anthropic SDK, 그리고 제공되는 경우 Agent SDK 자료를 활용해 Claude 기반 LLM 애플리케이션을 구축할 때 참고할 수 있는 실용적인 레퍼런스입니다. 언어별로 체계적으로 구성되어 있어, 개발자가 설정부터 실제 요청 전송, streaming 응답 처리, tool use, 백엔드 통합 패턴까지 빠르게 이어서 확인할 수 있습니다.

이 스킬은 특히 Claude를 사용하기로 이미 결정했고, 일반적인 AI 개요보다 실제 구현 가이드가 필요한 경우에 유용합니다. 리포지토리에는 C#, Go, Java, PHP, Ruby, Python, TypeScript용 언어별 문서가 포함되어 있으며, curl/ 아래에는 raw HTTP 예제도 제공됩니다.

이런 사용자에게 적합합니다

claude-api는 다음과 같은 경우에 잘 맞습니다:

• Claude를 서비스, 워커, 내부 도구에 통합하는 백엔드 개발자
• 직접 HTTP 호출과 공식 SDK 중 어떤 방식을 쓸지 검토하는 API 개발자
• Python, TypeScript, Go, Java, PHP, Ruby, C# 중에서 표준 스택을 정하기 전에 언어 지원 범위를 비교하는 팀
• streaming, tool use, batching, Files API 사용, 오류 처리 예제가 필요한 개발자
• Python 또는 TypeScript Agent SDK 자료를 사용하는 에이전트 개발자

해결해 주는 문제

여기저기 흩어진 예제를 직접 조합할 필요 없이, claude-api는 자주 맞닥뜨리는 구현 의사결정에 대해 구조화된 출발점을 제공합니다:

• 어떤 SDK 또는 API 인터페이스를 써야 하는지
• 어떤 언어 폴더를 먼저 읽어야 하는지
• ANTHROPIC_API_KEY로 어떻게 인증하는지
• 첫 메시지 요청을 어떻게 보내는지
• 긴 출력에서 언제 streaming을 우선 고려해야 하는지
• tool use, batches, Files API, prompt caching, 모델 참조, 오류 코드를 어디서 확인할 수 있는지

또한 shared/error-codes.md, shared/models.md, shared/prompt-caching.md, shared/live-sources.md, shared/tool-use-concepts.md 같은 공통 레퍼런스 파일도 포함되어 있어, 단순한 hello-world 예제를 넘어 실제 백엔드 동작 기준으로 확인이 필요할 때 도움이 됩니다.

리포지토리에서 지원하는 주요 문서 영역

리포지토리 기준으로 다음과 같은 핵심 영역이 확인됩니다:

• csharp/
• curl/
• go/
• java/
• php/
• python/agent-sdk
• python/claude-api
• ruby/
• typescript/agent-sdk
• typescript/claude-api
• shared/

즉, claude-api는 단일 언어용 코드 스니펫 모음이 아닙니다. Claude API 생태계를 위한 다중 언어 백엔드 통합 스킬로 이해하는 편이 더 정확합니다.

claude-api가 특히 잘 맞는 경우

다음과 같은 경우 claude-api를 사용하는 것이 좋습니다:

• 코드베이스에서 anthropic, @anthropic-ai/sdk, claude_agent_sdk를 가져와 사용하고 있는 경우
• 공식 Anthropic SDK 사용 패턴이 필요한 경우
• 서버 사이드에서 Claude API를 통합하는 실전 예제가 필요한 경우
• 구현 전에 언어별 설치 가이드를 먼저 확인하고 싶은 경우
• streaming, tool use, batches, Files API 지원 같은 기능을 이해해야 하는 경우

claude-api가 적합하지 않은 경우

다음과 같은 경우에는 이 스킬이 최선의 선택은 아닙니다:

• 프로젝트가 openai 같은 다른 AI 제공업체 SDK를 사용하는 경우
• Claude 통합과 무관한 일반적인 프로그래밍 도움이 필요한 경우
• API나 백엔드 워크플로가 아니라 프론트엔드 UI 패턴을 찾고 있는 경우
• 리포지토리에서 다루지 않는 언어가 필요하고, curl/의 raw HTTP 예제를 사용할 의향도 없는 경우

How to Use

스킬 설치하기

Anthropic skills 리포지토리에서 claude-api를 추가하세요:

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

설치한 뒤에는 먼저 SKILL.md를 읽고, 그다음 자신의 코드베이스에 맞는 언어 폴더로 이동하면 됩니다.

먼저 올바른 폴더를 선택하세요

claude-api를 가장 빠르게 제대로 활용하는 방법은 구현 세부 내용을 읽기 전에 언어별 경로부터 정하는 것입니다.

리포지토리에서 유용한 시작 지점은 다음과 같습니다:

• SKILL.md
• csharp/claude-api.md
• curl/examples.md
• go/claude-api.md
• java/claude-api.md
• php/claude-api.md
• ruby/claude-api.md
• python/claude-api/README.md
• typescript/claude-api/README.md
• python/agent-sdk/README.md
• typescript/agent-sdk/README.md

스택을 정하기 전에 SDK 지원 범위를 비교 중이라면, 여러 언어 폴더를 나란히 살펴보는 것이 좋습니다. 이 리포지토리는 Python과 TypeScript에서는 직접 Claude API 사용과 Agent SDK 가이드를 명확히 분리해 두고 있습니다.

용도에 맞는 인터페이스를 고르세요

리포지토리 구조를 기준으로 보면, claude-api는 다음과 같은 실용적인 경로를 지원합니다:

• raw HTTP 요청이나 미지원 언어에는 curl/examples.md 사용
• 공식 SDK 패턴이 필요하면 go/, java/, php/, ruby/, csharp/ 같은 언어 폴더 사용
• streaming, tool use, batches, Files API 같은 더 깊은 주제가 필요하면 python/claude-api/ 또는 typescript/claude-api/ 사용
• 직접 메시지 호출보다는 에이전트 워크플로 중심의 프로젝트라면 python/agent-sdk/ 또는 typescript/agent-sdk/ 사용

이 구조는 설치 여부를 판단할 때도 유용합니다. 모든 언어가 동일한 상위 기능을 제공하는 것은 아니기 때문입니다. 예를 들어 리포지토리에는 Python과 TypeScript용 Agent SDK 문서가 명시적으로 포함되어 있지만, 다른 언어는 Claude API SDK 사용에 초점을 맞추고 있습니다.

인증은 안전하게 설정하세요

리포지토리 전반의 예제에서 기본 패턴은 비밀값을 코드에 직접 하드코딩하는 대신 ANTHROPIC_API_KEY 환경 변수를 사용하는 것입니다. 그래서 claude-api는 운영 환경을 고려한 백엔드 워크플로와 CI 환경에도 잘 맞습니다.

예제를 테스트하기 전에, 현재 런타임에서 ANTHROPIC_API_KEY를 읽을 수 있는지 확인하세요.

언어별 일반적인 설치 경로

리포지토리에서 확인되는 설치 예시는 다음과 같습니다:

• C#: dotnet add package Anthropic
• Go: go get github.com/anthropics/anthropic-sdk-go
• PHP: composer require "anthropic-ai/sdk"
• Ruby: gem install anthropic
• Java: com.anthropic:anthropic-java 의존성 설정
• Raw HTTP: https://api.anthropic.com/v1/messages에 curl 사용

SDK와 HTTP 중 무엇을 쓸지 고민 중이라면, 지원되는 언어에서는 먼저 SDK로 시작하고, 더 낮은 수준의 요청 제어가 필요하거나 다른 언어를 사용 중이라면 curl/ 예제로 넘어가는 것이 좋습니다.

기본 메시지 요청부터 시작하세요

claude-api의 대부분 언어 가이드는 같은 실용적인 흐름으로 시작합니다:

1. 클라이언트 초기화
2. 환경 변수에서 API 키 읽기
3. Claude 모델로 메시지 요청 전송
4. 응답에서 텍스트 블록 읽기

이런 일관성은 여러 백엔드 언어를 함께 사용하는 팀에 특히 유용합니다. 코드 문법이 달라도 요청 패턴 자체는 표준화할 수 있기 때문입니다.

긴 응답에는 streaming을 활용하세요

리포지토리의 SKILL.md에서는 입력이 길거나 출력이 길 수 있거나 max_tokens가 큰 요청의 경우 기본적으로 streaming을 우선 고려하라고 명시적으로 권장합니다. streaming은 요청 타임아웃을 줄이는 데 도움이 되기 때문입니다. 이 점은 claude-api에서 얻을 수 있는 가장 중요한 운영상 인사이트 중 하나입니다.

애플리케이션에서 긴 답변, 요약, tool loop, 확장된 추론을 생성한다면 먼저 다음 streaming 문서를 검토해 보세요:

• python/claude-api/streaming.md
• typescript/claude-api/streaming.md
• go/claude-api.md, java/claude-api.md, ruby/claude-api.md, csharp/claude-api.md 같은 언어별 파일 안의 streaming 섹션

고급 백엔드 기능도 확인해 보세요

단일 quickstart에만 의존하지 않고 claude-api를 설치할 만한 이유 중 하나는 더 깊이 있는 주제 문서가 리포지토리에 포함되어 있기 때문입니다. 관련 파일은 다음과 같습니다:

• python/claude-api/tool-use.md
• typescript/claude-api/tool-use.md
• python/claude-api/batches.md
• typescript/claude-api/batches.md
• python/claude-api/files-api.md
• typescript/claude-api/files-api.md
• shared/tool-use-concepts.md
• shared/prompt-caching.md
• shared/models.md

이 문서들은 단일 요청-응답 예제만으로는 부족한 실제 운영 백엔드 워크플로에서 특히 가치가 큽니다.

문제 해결에는 공통 레퍼런스를 활용하세요

첫 통합이 기대대로 동작하지 않는다면, claude-api에는 디버깅과 설계 검토에 도움이 되는 보조 자료가 포함되어 있습니다:

• HTTP 오류 의미, 재시도 가능 여부, 일반적 원인을 다루는 shared/error-codes.md
• 모델 관련 레퍼런스를 제공하는 shared/models.md
• 소스 관련 가이드를 제공하는 shared/live-sources.md

특히 오류 코드 문서는 429, 500, 529처럼 재시도 가능한 상황과, 400 같은 재시도 불가 요청 문제나 401 같은 인증 문제를 구분해 설명해 주기 때문에 매우 유용합니다.

claude-api 도입 전 실전 체크리스트

프로젝트에서 이 스킬을 채택하기 전에 다음을 점검해 보세요:

• 지원되는 언어 중 하나에서 공식 SDK 예제가 필요한가?
• 긴 출력이 예상되어 streaming 가이드가 필요한가?
• tool use, Files API, batch 처리 예제가 필요한가?
• Python 또는 TypeScript에서 에이전트 워크플로를 구축하려는가?
• curl 기반의 raw HTTP 대안 경로도 필요할까?

여러 항목에 대해 답이 yes라면, claude-api는 좋은 선택일 가능성이 높습니다.

FAQ

이 리포지토리에서 claude-api는 무엇인가요?

claude-api는 anthropics/skills 안에 있는 스킬로, 개발자가 Claude API, Anthropic SDK, Agent SDK 리소스를 사용해 애플리케이션을 만들 수 있도록 돕습니다. 언어별로 구성되어 있으며 공통 레퍼런스 문서가 함께 제공됩니다.

claude-api는 어떻게 설치하나요?

다음을 사용하세요:

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

그다음 SKILL.md와 자신의 스택에 맞는 언어 폴더를 열면 됩니다.

claude-api는 어떤 언어를 지원하나요?

리포지토리 기준으로 C#, Go, Java, PHP, Ruby, Python, TypeScript 문서와 함께 curl 기반 raw HTTP 예제가 제공됩니다.

claude-api에 Agent SDK 가이드도 포함되어 있나요?

네. 다만 리포지토리 구조상 Agent SDK 자료는 python/agent-sdk/와 typescript/agent-sdk/에 특히 마련되어 있습니다. 에이전트 워크플로 예제가 필요하다면 이 폴더부터 보는 것이 좋습니다.

claude-api는 streaming과 tool use에도 도움이 되나요?

네. 리포지토리에는 streaming과 tool use 문서가 포함되어 있으며, 특히 Python과 TypeScript의 Claude API 폴더에서 관련 내용을 자세히 다룹니다. 여러 언어별 가이드에도 streaming 섹션이 포함되어 있습니다.

claude-api는 직접 API 호출에만 해당하나요?

아니요. 직접 Claude API를 사용하는 방식과 SDK 기반 통합 패턴을 모두 다룹니다. 또한 SDK를 쓰고 싶지 않거나 다른 언어에서 작업하는 개발자를 위해 curl/examples.md에 raw HTTP 예제도 포함되어 있습니다.

언제 SDK 대신 curl을 써야 하나요?

raw HTTP 예제가 필요할 때, 이 스킬에서 공식 SDK로 다루지 않는 언어를 사용할 때, 또는 클라이언트 라이브러리를 도입하기 전에 요청과 응답 구조를 직접 확인하고 싶을 때 curl을 사용하면 됩니다.

claude-api에는 오류 처리 가이드도 있나요?

네. shared/error-codes.md에는 HTTP 오류 코드, 일반적 원인, 그리고 어떤 문제가 재시도 가능한지 정리되어 있습니다. 그래서 claude-api는 초기 설정뿐 아니라 운영 환경 통합 설계에도 유용합니다.

claude-api는 일반적인 코딩 도움에도 적합한가요?

아니요. 이 리포지토리는 Claude API와 Anthropic SDK 활용에 초점을 맞추고 있습니다. 작업이 Claude 통합과 무관하다면 이 스킬은 너무 특화되어 있습니다.

claude-api 설치 후 무엇부터 읽어야 하나요?

먼저 SKILL.md를 읽고, 그다음 자신의 언어와 용도에 맞는 파일로 이동하세요. 많은 팀에는 다음 순서가 가장 효율적입니다:

1. SKILL.md
2. go/claude-api.md 또는 php/claude-api.md 같은 언어별 가이드
3. streaming.md, tool-use.md, batches.md, files-api.md 같은 주제별 문서
4. shared/error-codes.md 같은 공통 레퍼런스