Claude Code

Website: https://docs.anthropic.com/en/docs/claude-code/setup

The Claude Code provider enables you to leverage your current Claude subscription with Sypha. When you hold Claude Max or Pro, this allows Claude usage in Sypha without incurring additional API expenses.

Configuration

Initially, you'll need to deploy and authenticate Claude Code on your system:

1. Deploy Claude Code: Consult Anthropic's official setup guide to install and authenticate the Claude CLI.

2. Configure in Sypha:

   • Access Sypha settings (⚙️ icon)
   • Choose Claude Code from the API Provider selector
   • Specify the path to your Claude CLI executable (typically just claude when it's in your PATH)

Locating your Claude Code path

• macOS / Linux / WSL / Git Bash: which claude
• Windows Command Prompt: where claude

Available Models

The Claude Code provider offers these models:

• claude-sonnet-4-20250514 (Recommended)
• claude-opus-4-1-20250805
• claude-opus-4-20250514
• claude-3-7-sonnet-20250219
• claude-3-5-sonnet-20241022
• claude-3-5-haiku-20241022

Operational mechanism

When utilizing Claude Code with Sypha, here's the underlying process:

Sypha encapsulates the Claude Code CLI to manage your requests. For each message you transmit, Sypha initiates a fresh claude process, forwards your conversation, and streams the response back. The AI reasoning originates from Claude Code, however all actual file modifications, terminal operations, and other tools are managed by Sypha.

The primary distinction you'll observe is that responses don't stream character-by-character like alternative providers. Rather, Claude Code processes your complete request before returning the full response.

Constraints

Several factors to bear in mind with Claude Code:

• Images within your messages undergo conversion to text placeholders since Claude Code doesn't accommodate image uploads via the CLI
• Prompt caching remains unavailable with this provider
• Responses don't stream in real-time like alternative providers

Problem resolution

Should you encounter difficulties:

Authentication challenges: Verify you're authenticated to Claude Code using your subscription account. Execute claude auth status to verify.

Path difficulties: Confirm that the Claude CLI path in Sypha's configuration is accurate. Attempt executing claude --version in your terminal to validate it's operational.

Still experiencing issues? We're continuously enhancing this integration. Submit issues on our GitHub or request assistance in our Discord.

Subscription usage

When you possess a Claude Max subscription, your Sypha usage displays as $0.00 in the billing interface since you're not incurring additional API expenses. Your usage still applies toward your subscription limits, however you won't observe per-token charges.

For additional information about utilizing Claude Code with your subscription, consult Anthropic's documentation:

• Claude Code Setup Guide
• Using Claude Code with Pro/Max Plans