Claude Code SDK Ts

Claude Code SDK for TypeScript

[](https://www.npmjs.com/package/@instantlyeasy/claude-code-sdk-ts) [](https://www.npmjs.com/package/@instantlyeasy/claude-code-sdk-ts) [](https://opensource.org/licenses/MIT) [](https://www.typescriptlang.org/) [](https://nodejs.org/)

Unofficial TypeScript SDK for [Claude Code](https://github.com/anthropics/claude-code) - the powerful CLI tool for interacting with Claude.

**✨ What's New in v0.3.3:**

• 🎬 Interactive streaming session with working visual typewriter effects
• 🛡️ Advanced error handling with retry strategies and typed errors
• 📊 Token streaming analysis with honest documentation about current behavior
• 🔧 Production-ready examples that actually work as advertised

**Note**: For the classic async generator API, see [Classic API Documentation](docs/CLASSIC_API.md).

Installation

npm install @instantlyeasy/claude-code-sdk-ts
# or
yarn add @instantlyeasy/claude-code-sdk-ts
# or  
pnpm add @instantlyeasy/claude-code-sdk-ts

**Latest Version:** `v0.3.3` with enhanced features and working visual streaming!

**Prerequisites:**

• Node.js 18 or later
• Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)

Quick Start

import { claude } from '@instantlyeasy/claude-code-sdk-ts';

// Simple query
const response = await claude()
  .query('Say "Hello World!"')
  .asText();

console.log(response); // "Hello World!"

Authentication

This SDK delegates all authentication to the Claude CLI:

# One-time setup - login with your Claude account
claude login

The SDK does not handle authentication directly. If you see authentication errors, authenticate using the Claude CLI first.

Core Features

🎯 Fluent API

Chain methods for clean, readable code:

const result = await claude()
  .withModel('sonnet')              // Choose model
  .allowTools('Read', 'Write')      // Configure permissions

...