{"_id":"@anygpt/claude","name":"@anygpt/claude","dist-tags":{"latest":"1.2.2"},"versions":{"1.2.2":{"name":"@anygpt/claude","version":"1.2.2","description":"Claude Agent SDK connector for AnyGPT","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"publishConfig":{"access":"public"},"dependencies":{"@anygpt/router":"0.6.1","@anthropic-ai/claude-agent-sdk":"^0.1.22","@anthropic-ai/sdk":"^0.65.0"},"gitHead":"56f3ba0d47cbf897012b46a2967d45e3b3f30a1b","_id":"@anygpt/claude@1.2.2","_nodeVersion":"24.10.0","_npmVersion":"11.6.1","dist":{"integrity":"sha512-sj+R/I0lTKWC+mZ4dZZE3gLNC3EUT40YREqoh46BSGb2wOfmOf4tIVgNlSgCkBCQY836ZtgBAQXsfozRx3dT2g==","shasum":"d7b7a24f574970f0b16cf5706c3b9cf877df75d1","tarball":"https://registry.npmjs.org/@anygpt/claude/-/claude-1.2.2.tgz","fileCount":14,"unpackedSize":53961,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDXB+qKQ1ENVJ37Rk6HbtrR52SfmfruCKUe7YGEhQFB2wIhAKdqYYFF/FgsZhT0u795dGc3KXuAoDJWgVX+u0qyhZXy"}]},"_npmUser":{"name":"theplenkov-npm","email":"petr.plenkov@gmail.com"},"directories":{},"maintainers":[{"name":"theplenkov-npm","email":"petr.plenkov@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/claude_1.2.2_1761293996296_0.5851284177188629"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-24T08:19:56.234Z","1.2.2":"2025-10-24T08:19:56.472Z","modified":"2025-10-24T08:19:56.827Z"},"maintainers":[{"name":"theplenkov-npm","email":"petr.plenkov@gmail.com"}],"description":"Claude Agent SDK connector for AnyGPT","readme":"# @anygpt/claude-agent\n\nClaude Agent SDK connector for AnyGPT - provides agentic capabilities with built-in tool support, file operations, code execution, and MCP extensibility.\n\n## Features\n\n- **Agentic Capabilities**: Autonomous agents that can plan, execute, and iterate\n- **Built-in Tools**: File operations, bash execution, web search, and more\n- **MCP Support**: Connect to Model Context Protocol servers for extended functionality\n- **Context Management**: Automatic context compaction and management\n- **Permission System**: Fine-grained control over agent capabilities\n\n## Installation\n\n```bash\nnpm install @anygpt/claude-agent\n```\n\n## Usage\n\n```typescript\nimport { claudeAgent } from '@anygpt/claude-agent';\n\n// Create connector with API key\nconst connector = claudeAgent({\n  apiKey: process.env.ANTHROPIC_API_KEY,\n  model: 'claude-sonnet-4',\n  maxTokens: 4096,\n});\n\n// Use with AnyGPT router\nconst response = await connector.chatCompletion({\n  messages: [\n    { role: 'user', content: 'Read the README.md file and summarize it' }\n  ],\n  model: 'claude-sonnet-4',\n});\n\nconsole.log(response.message);\n```\n\n## Configuration\n\n### Basic Configuration\n\n```typescript\nconst connector = claudeAgent({\n  apiKey: 'your-api-key',\n  model: 'claude-sonnet-4',\n  maxTokens: 4096,\n  temperature: 0.7,\n  systemPrompt: 'You are a helpful assistant',\n});\n```\n\n### With MCP Servers\n\n```typescript\nconst connector = claudeAgent({\n  apiKey: 'your-api-key',\n  mcpServers: {\n    'filesystem': {\n      command: 'npx',\n      args: ['-y', '@modelcontextprotocol/server-filesystem', '/path/to/workspace'],\n    },\n    'github': {\n      command: 'npx',\n      args: ['-y', '@modelcontextprotocol/server-github'],\n      env: {\n        GITHUB_TOKEN: process.env.GITHUB_TOKEN,\n      },\n    },\n  },\n});\n```\n\n### With Permissions\n\n```typescript\nconst connector = claudeAgent({\n  apiKey: 'your-api-key',\n  permissions: {\n    bash: 'allow', // Allow bash execution\n    edit: 'ask',   // Ask before editing files\n    read: 'allow', // Allow reading files\n  },\n});\n```\n\n## Comparison with Anthropic Connector\n\n| Feature | @anygpt/anthropic | @anygpt/claude-agent |\n|---------|-------------------|----------------------|\n| **Purpose** | Direct API access | Agentic workflows |\n| **Tools** | Manual tool definition | Built-in + MCP |\n| **Context** | Manual management | Automatic compaction |\n| **File Ops** | Via custom tools | Built-in |\n| **Code Exec** | Via custom tools | Built-in |\n| **Permissions** | N/A | Fine-grained control |\n| **Use Case** | Chat completions | Autonomous agents |\n\n## When to Use\n\n**Use @anygpt/claude-agent when:**\n- Building autonomous agents that need to perform complex tasks\n- Need built-in file operations and code execution\n- Want automatic context management\n- Require MCP server integration\n- Building SRE, security, or code review agents\n\n**Use @anygpt/anthropic when:**\n- Simple chat completions\n- Custom tool definitions\n- Direct API control\n- Streaming responses\n- Lower-level access\n\n## Examples\n\n### Code Review Agent\n\n```typescript\nconst reviewer = claudeAgent({\n  apiKey: process.env.ANTHROPIC_API_KEY,\n  systemPrompt: 'You are a code review assistant. Review code for best practices, security issues, and performance.',\n  permissions: {\n    read: 'allow',\n    bash: 'allow',\n  },\n});\n\nconst response = await reviewer.chatCompletion({\n  messages: [\n    { role: 'user', content: 'Review the changes in src/index.ts' }\n  ],\n  model: 'claude-sonnet-4',\n});\n```\n\n### SRE Agent\n\n```typescript\nconst sreAgent = claudeAgent({\n  apiKey: process.env.ANTHROPIC_API_KEY,\n  systemPrompt: 'You are an SRE assistant. Help diagnose and fix production issues.',\n  permissions: {\n    bash: 'ask',  // Ask before running commands\n    read: 'allow',\n  },\n  mcpServers: {\n    'kubernetes': {\n      command: 'kubectl-mcp-server',\n    },\n  },\n});\n\nconst response = await sreAgent.chatCompletion({\n  messages: [\n    { role: 'user', content: 'Check the status of the api-server pod and diagnose any issues' }\n  ],\n  model: 'claude-opus-4',\n});\n```\n\n## API Reference\n\n### ClaudeAgentConnectorConfig\n\n```typescript\ninterface ClaudeAgentConnectorConfig {\n  apiKey?: string;              // Anthropic API key\n  model?: string;               // Model to use (default: claude-sonnet-4)\n  maxTokens?: number;           // Max tokens (default: 4096)\n  temperature?: number;         // Temperature (0-1)\n  systemPrompt?: string;        // System prompt\n  mcpServers?: Record<string, MCPServerConfig>;  // MCP servers\n  permissions?: Record<string, 'allow' | 'ask' | 'deny'>;  // Tool permissions\n}\n```\n\n### Methods\n\n- `chatCompletion(request)` - Execute agentic chat completion\n- `getModels()` - Get available models\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-77359bceecae38d55f0edfd9142eca66"}