claude-api

Files (2)

• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

# Claude API

Anthropic Claude API 및 SDK를 사용하여 애플리케이션을 구축합니다.

## 활성화 시점

- Claude API를 호출하는 애플리케이션 구축 시
- 코드에 `anthropic` (Python) 또는 `@anthropic-ai/sdk` (TypeScript) 임포트가 있을 때
- 사용자가 Claude API 패턴, 도구 사용, 스트리밍 또는 비전에 대해 질문할 때
- Claude 에이전트 SDK를 사용하여 에이전트 워크플로우 구현 시
- API 비용, 토큰 사용량 또는 대기 시간 최적화 시

## 모델 선택

| 모델 | ID | 용도 |
|-------|-----|----------|
| Opus 4.1 | `claude-opus-4-1` | 복잡한 추론, 아키텍처, 조사 |
| Sonnet 4 | `claude-sonnet-4-0` | 균형 잡힌 코딩, 대부분의 개발 작업 |
| Haiku 3.5 | `claude-3-5-haiku-latest` | 빠른 응답, 대량 처리, 비용 민감 작업 |

심층 추론(Opus)이나 속도/비용 최적화(Haiku)가 필요한 작업이 아니라면 Sonnet 4를 기본으로 사용하세요. 프로덕션 환경에서는 별칭(alias)보다 고정된 스냅샷 ID를 사용하는 것이 좋습니다.

## Python SDK

### 설치

```bash
pip install anthropic
```

### 기본 메시지

```python
import anthropic

client = anthropic.Anthropic()  # 환경 변수에서 ANTHROPIC_API_KEY를 읽음

message = client.messages.create(
    model="claude-sonnet-4-0",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Explain async/await in Python"}
    ]
)
print(message.content[0].text)
```

### 스트리밍

```python
with client.messages.stream(
    model="claude-sonnet-4-0",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Write a haiku about coding"}]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)
```

### 시스템 프롬프트

```python
message = client.messages.create(
    model="claude-sonnet-4-0",
    max_tokens=1024,
    system="You are a senior Python developer. Be concise.",
    messages=[{"role": "user", "content": "Review this function"}]
)
```

## TypeScript SDK

### 설치

```bash
npm install @anthropic-ai/sdk
```

### 기본 메시지

```typescript
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // 환경 변수에서 ANTHROPIC_API_KEY를 읽음

const message = await client.messages.create({
  model: "claude-sonnet-4-0",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "Explain async/await in TypeScript" }
  ],
});
console.log(message.content[0].text);
```

### 스트리밍

```typescript
const stream = client.messages.stream({
  model: "claude-sonnet-4-0",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Write a haiku" }],
});

for await (const event of stream) {
  if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
    process.stdout.write(event.delta.text);
  }
}
```

## 도구 사용 (Tool Use)

도구를 정의하고 Claude가 이를 호출하도록 합니다:

```python
tools = [
    {
        "name": "get_weather",

From kypo42/everything-claude-code-kr, MIT.

More from kypo42/everything-claude-code-kr