Claude Code JS

The Claude Code JS SDK provides developers with a powerful JavaScript/TypeScript interface for integrating with Claude Code, the official CLI tool developed by Anthropic for enhanced AI-driven software engineering capabilities.

Overview

This SDK streamlines interactions with Claude Code, allowing for seamless programmatic access to AI features that can support a range of tasks in software development—from troubleshooting and debugging to automated code reviews and generating test cases.

Key Features

• AI-Powered Assistance: Interact with AI to get explanations, code reviews, and suggestions for improvements.
• Session Management: Utilize sessions for multi-turn conversations, track session history, and use forking techniques to explore different solutions concurrently.
• Direct Command Execution: Execute commands and retrieve real-time output, making it ideal for running and debugging code within development environments.
• TypeScript Support: Full TypeScript compatibility ensures type safety and aids in building more robust applications.

Quick Start

Basic Setup

To initialize the SDK, the following code can be used:

import { ClaudeCode } from 'claude-code-js';

const claude = new ClaudeCode({
  apiKey: process.env.CLAUDE_API_KEY,
  model: 'claude-3-sonnet',
  workingDirectory: './my-project',
  verbose: false
});

Example Use Cases

• Single Chat with Claude:

const response = await claude.chat({
  prompt: 'Explain this error: TypeError: Cannot read property of undefined',
  systemPrompt: 'You are a helpful coding assistant'
});

• Run Commands:

const result = await claude.runCommand('Fix the failing tests in src/utils.test.js');

• Interactive Debugging Session:

await debugSession.prompt({
  prompt: 'I have a React component that re-renders infinitely. Help me debug it.'
});

• Generate Unit Tests:

const response = await claude.chat({
  prompt: `Generate Jest unit tests for this function: ...`
});

Advanced Usage

Working with Multiple Sessions

Work independently on different tasks by creating multiple sessions. This is beneficial for code reviews, debugging, or generating tests:

const codeReviewSession = claude.newSession();
const debugSession = claude.newSession();

Chaining Commands and Reverting Sessions

Utilize outputs from one session as the inputs for another. You can also revert changes in a session to correct mistakes easily:

const validationSession = claude.newSession();
const validationResult = await validationSession.prompt({ prompt: mathResult.result });

Configuration Management

Modify configuration parameters dynamically to adapt to different use cases:

claude.setOptions({ model: 'claude-3-opus', verbose: true });

Contribution and Support

Contributions and feedback are encouraged. For issues, feature requests, or improvements, please visit the GitHub Issues page.

For additional support, refer to the documentation.

The claude-code-js SDK is an essential tool for developers seeking to enhance their software engineering processes with AI capabilities.