JD.SemanticKernel.Connectors.ClaudeCode 1.0.37

JD.SemanticKernel.Connectors.ClaudeCode

👁 NuGet
👁 NuGet Downloads
👁 CI
👁 CodeQL
👁 codecov

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 including:

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