Skip to main content

​
Claude Agent SDK Integration

Overcut supports using Anthropic’s Claude Code Agent SDK as an alternative execution engine to the default Overcut Agent architecture. This integration allows you to leverage Claude’s native coding capabilities while maintaining all existing Overcut functionality.

​
Overview

The Claude Agent SDK integration provides:
  • Claude Code Intelligence: Claude’s advanced understanding of code patterns, architecture, and best practices
  • Intelligent Task Delegation: Automatic coordination between specialized agents based on context
  • Seamless Tool Integration: Full access to Overcut’s ticketing, pull request, and workflow tools
  • Consistent Experience: Same agent personalities and capabilities across both execution modes
  • Enhanced Performance: Leverage Claude’s latest capabilities for complex coding tasks

​
Architecture

​
Execution Modes

Overcut supports two execution modes:
  1. Overcut Agent Mode (Default): Uses Overcut’s Agent architecture
  2. Claude Agent Mode: Uses Anthropic’s Claude Code Agent SDK directly
The execution engine is selected when configuring each workflow step.

​
Key Benefits

  • Advanced AI Capabilities: Access to Claude’s state-of-the-art reasoning and code generation
  • Flexible Execution: Choose the best AI engine for each specific task type
  • Seamless Integration: All Overcut tools work with both engine types
  • Intelligent Coordination: Automatic collaboration between multiple agents in sessions

​
Setup and Configuration

​
Prerequisites

  1. Anthropic API Key: Required for Claude SDK access

​
API Key Setup

​
Setting up your Claude API Key

  1. Navigate to Workspace Settings:
    • Click on your workspace name in the top navigation
    • Select “Settings” from the dropdown menu
    • Go to the “Secrets” tab
  2. Add your Claude API Key:
    • Click “Add Secret”
    • Paste your Claude API key (starts with sk-ant-) as the value
    • Click “Update Key”
  3. Verify the setup:
    • The system will automatically detect that you have a Claude API key configured
    • When creating workflow steps, the Claude engine option will be fully available
    • If you select Claude engine without a configured API key, you’ll see a helpful warning with a link to the settings page

​
Model Selection

Claude Agent uses the default models provided by the Claude Agent SDK. No model selection is currently available - the system automatically uses Claude’s optimized model configuration for all tasks.

​
Getting Started

Ready to experience Claude’s advanced AI capabilities in your workflows? Start by configuring your API key and creating your first Claude-powered workflow step. The combination of Overcut’s workflow orchestration with Claude’s reasoning capabilities opens up new possibilities for automated development workflows.