JD.SemanticKernel.Connectors.ClaudeCode 0.1.22

JD.SemanticKernel.Connectors.ClaudeCode

A Semantic Kernel connector that bridges your local Claude Code OAuth session into Microsoft Semantic Kernel — no manual API key management needed.

Features

• Zero-config authentication — automatically reads ~/.claude/.credentials.json
• Multi-source credential resolution — options → env vars → local session, in priority order
• OAuth & API key support — handles sk-ant-oat* (Bearer) and sk-ant-api* (x-api-key) tokens
• 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

Quick Start

Install

dotnet add package JD.SemanticKernel.Connectors.ClaudeCode

Kernel Builder (Recommended)

using JD.SemanticKernel.Connectors.ClaudeCode;

var builder = Kernel.CreateBuilder();
builder.UseClaudeCodeChatCompletion(); // 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
});

Configuration Binding

{
  "ClaudeSession": {
    "ApiKey": null,
    "OAuthToken": null,
    "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