JD.SemanticKernel.Connectors.ClaudeCode 0.1.24

JD.SemanticKernel.Connectors.ClaudeCode

A Semantic Kernel connector for Anthropic models with API-key-first authentication and optional local Claude Code OAuth support.

Features

• API-key-first authentication — supports sk-ant-api* via options or ANTHROPIC_API_KEY
• Optional local OAuth support — sk-ant-oat* is opt-in and interactive-only
• Multi-source credential resolution — options/env API key first, then local OAuth sources
• Full Semantic Kernel integration — IKernelBuilder.UseClaudeCodeChatCompletion() one-liner
• DI-friendly — IServiceCollection.AddClaudeCodeAuthentication() for ASP.NET Core / Generic Host
• Broad TFM support — netstandard2.0, net8.0, net10.0

Compliance Defaults

• OAuth token support is disabled by default.
• OAuth usage requires EnableOAuthTokenSupport = true and an interactive session.
• Unattended or automated OAuth workflows are intentionally blocked.
• For service, CI, or unattended usage, use Anthropic API keys (sk-ant-api*).
• Anthropic Consumer Terms (effective October 8, 2025) apply to consumer-service usage: https://www.anthropic.com/legal/consumer-terms
• Anthropic API keys are governed by Anthropic Commercial Terms: https://www.anthropic.com/legal/commercial-terms

Quick Start

Install

dotnet add package JD.SemanticKernel.Connectors.ClaudeCode

Kernel Builder (Recommended)

using JD.SemanticKernel.Connectors.ClaudeCode;

var builder = Kernel.CreateBuilder();
builder.UseClaudeCodeChatCompletion(apiKey: "sk-ant-api..."); // defaults to ClaudeModels.Default (Sonnet)
var kernel = builder.Build();

var result = await kernel.InvokePromptAsync("Hello, Claude!");
Console.WriteLine(result);

Service Collection (ASP.NET Core)

builder.Services.AddClaudeCodeAuthentication(options =>
{
    options.CredentialsPath = "/custom/path/.credentials.json"; // optional
    options.EnableOAuthTokenSupport = true; // only for local interactive OAuth use
});

Configuration Binding

{
  "ClaudeSession": {
    "ApiKey": null,
    "OAuthToken": null,
    "EnableOAuthTokenSupport": false,
    "CredentialsPath": null
  }
}

builder.Services.AddClaudeCodeAuthentication(builder.Configuration);

Credential Resolution Order

Sample CLI Tools

This repo includes sample projects demonstrating agentic workflows with Semantic Kernel:

Install the CLI tools as global tools:

dotnet tool install -g JD.Tools.GherkinGenerator
dotnet tool install -g JD.Tools.PullRequestReviewer
dotnet tool install -g JD.Tools.CodebaseExplorer

Models

Well-known model constants are available via ClaudeModels:

builder.UseClaudeCodeChatCompletion(ClaudeModels.Opus);   // claude-opus-4-6
builder.UseClaudeCodeChatCompletion(ClaudeModels.Sonnet);  // claude-sonnet-4-6 (default)
builder.UseClaudeCodeChatCompletion(ClaudeModels.Haiku);   // claude-haiku-4-5

Documentation

Full documentation is available at the DocFX site including:

• Getting Started
• Credential Resolution
• Kernel Builder Integration
• Service Collection Integration
• HttpClientFactory
• Configuration Reference
• Sample Tools Guide

Building

dotnet build
dotnet test

Build Documentation

cd docs
dotnet tool restore
dotnet docfx docfx.json

Shared Abstractions

This connector implements the JD.SemanticKernel.Connectors.Abstractions interfaces, enabling multi-provider bridging:

Use the same abstractions across providers:

ISessionProvider provider = isClaudeCode
    ? claudeCodeProvider
    : copilotProvider;

var creds = await provider.GetCredentialsAsync();

Related Projects

• JD.SemanticKernel.Connectors.GitHubCopilot — Same pattern for GitHub Copilot subscriptions
• JD.SemanticKernel.Extensions — SK extensions for skills, hooks, plugins, compaction, and semantic memory

License

MIT