# claude-sdk-integration-patterns

Скилл с готовыми паттернами работы с Claude API и TypeScript SDK: стриминг, вызов инструментов, обработка ошибок, экономия токенов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 434 установки · ★ 62
- Автор: manutej
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/manutej/luxor-claude-marketplace/tree/HEAD/plugins/luxor-ai-integration/skills/claude-sdk-integration-patterns/SKILL.md
- Обновлён: 2026-06-13
- HTML: https://affpapa.org/nevibecode/skills/claude-sdk-integration-patterns

## Что делает

Скилл собирает рабочие примеры интеграции Claude API в приложения на Node.js и TypeScript. Внутри — Messages API, потоковые ответы, tool use через Zod, обработка ошибок и оптимизация расхода токенов. Каждый паттерн идёт с пометкой, когда его брать: простой вопрос-ответ, многошаговый диалог, живой интерфейс с частичной отрисовкой.

Отдельный блок про инструменты: описание схемы через `betaZodTool`, автоматический прогон вызовов через `toolRunner`, стриминг выполнения нескольких инструментов подряд. Есть и отмена потока — `stream.abort()` плюс перехват `Anthropic.APIUserAbortError`, если пользователь закрыл окно или сработал таймаут.

Для работы нужен ключ `ANTHROPIC_API_KEY` и установленный пакет `@anthropic-ai/sdk`. Скилл рассчитан на приложения, а не на сам Claude, поэтому в проекте без Node.js и TypeScript он бесполезен — это повод проверить стек до установки.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill claude-sdk-integration-patterns -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/claude-sdk-integration-patterns/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/claude-sdk-integration-patterns/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill claude-sdk-integration-patterns -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/claude-sdk-integration-patterns/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill claude-sdk-integration-patterns -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/claude-sdk-integration-patterns/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install manutej/luxor-claude-marketplace claude-sdk-integration-patterns
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/claude-sdk-integration-patterns/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill claude-sdk-integration-patterns -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/manutej/luxor-claude-marketplace --path plugins/luxor-ai-integration/skills/claude-sdk-integration-patterns
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/claude-sdk-integration-patterns/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill claude-sdk-integration-patterns -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/manutej/luxor-claude-marketplace/tree/HEAD/plugins/luxor-ai-integration/skills/claude-sdk-integration-patterns/SKILL.md

## Когда брать
- подключить Claude API к приложению на Node.js
- сделать потоковый вывод ответа в чат
- описать инструмент со схемой на Zod
- обработать обрыв потока и таймаут запроса
- сократить расход токенов в многошаговом диалоге

## Примеры запросов агенту
- покажи паттерн стриминга ответов Claude API для TypeScript
- как описать инструмент через betaZodTool и запустить toolRunner
- добавь обработку ошибок и отмену потока в вызов messages.create

## Похожие
- [anthropic-claude-development](https://affpapa.org/nevibecode/skills/anthropic-claude-development.md) — скилл · 728 установок
- [vercel-ai-sdk](https://affpapa.org/nevibecode/skills/wsimmonds-vercel-ai-sdk.md) — скилл · 337 установок
- [claude-api](https://affpapa.org/nevibecode/skills/claude-api.md) — скилл · 74198 установок
- [v4-sdk-integration](https://affpapa.org/nevibecode/skills/v4-sdk-integration.md) — скилл · 729 установок
- [honcho-integration](https://affpapa.org/nevibecode/skills/honcho-integration.md) — скилл · 882 установки
- [zapier-sdk](https://affpapa.org/nevibecode/skills/zapier-sdk.md) — скилл · 1000 установок

Из того же набора: [manutej/luxor-claude-marketplace](https://affpapa.org/nevibecode/by/manutej/luxor-claude-marketplace.md) — 31 карточка

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md