Do I need an Anthropic API key to use this SDK?

No, the SDK wraps the Claude CLI binary and utilizes your existing Pro or Max subscription billing, which removes the need for a separate API key.

Does this SDK support Model Context Protocol (MCP)?

Yes, it provides full configuration support for MCP servers, allowing your automated agents to interact with any MCP-compliant data source or tool.

Can I stream responses in real-time with this SDK?

Yes, the core query() function returns an AsyncGenerator that emits events for text deltas, tool usage, and system initializations as they happen.

What is the difference between query() and createConversation()?

query() is designed for single tasks that may involve multiple turns, while createConversation() maintains a persistent CLI process for continuous, low-latency back-and-forth sessions.

How does the SDK handle structured data?

The SDK integrates with Zod through the zodToOutputFormat and parseStructuredOutput helpers, ensuring Claude's responses conform to your specific data models.

Claude CLI SDK

Name: Claude CLI SDK
Author: nklisch

bynklisch

•

開発者ツール

Enables programmatic control of the Claude CLI to build autonomous agents and automation workflows using your existing Pro/Max subscription.

The @nklisch/claude-cli-sdk provides a comprehensive TypeScript/JavaScript interface for the official Claude CLI, allowing developers to integrate Claude's capabilities directly into their own applications and scripts. It wraps the CLI binary as an async generator, facilitating real-time streaming of responses and tool interactions without requiring an Anthropic API key. This SDK is ideal for creating custom plugins, managing persistent conversations, and implementing structured data extraction via Zod, making it a powerful tool for developers looking to automate complex coding tasks and build sophisticated AI-driven development environments.

主な機能

01Supports structured output with Zod schema validation

022 GitHub stars

03Uses existing Pro/Max subscription billing to bypass API key requirements

04Provides typed helper functions for building skills, plugins, and tool patterns

05Full integration for MCP (Model Context Protocol) servers and sub-agents

06Wraps Claude CLI as an async generator for real-time streaming

ユースケース

01Building custom autonomous coding agents that leverage local file system and tool access

02Automating repetitive development tasks like bulk code reviews, linting, and git operations

03Creating specialized Claude Code skills and plugins with programmatic configuration

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nklisch/skills claude-cli-sdk

For use in Claude.ai and ChatGPT