Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
SharpClaw Code는 .NET 생태계에서 코딩 에이전트 경험을 구축하고 운영하기 위한 오픈 소스 런타임입니다. C#과 .NET 네이티브 아키텍처를 기반으로 하며, 내구성 있는 세션 관리와 권한 인식 도구 실행 기능을 제공합니다. CLI 및 임베디드 호스트 SDK를 모두 지원하여 다양한 개발 환경에 적용 가능합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Coding Assistants의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기.NET 10
C%23 13
MCP
Cross-platform
SharpClaw Code는 AI 개발 도구, 에이전트형 CLI(CLI), 그리고 MCP 지원 워크플로우를 구축하는 팀을 위한 C# 및 .NET 네이티브 코딩 에이전트 런타임입니다.
이는 내구성 있는 세션(durable sessions), 권한 인식 도구 실행(permission-aware tool execution), 제공자 추상화(provider abstraction), 구조화된 원격 측정(structured telemetry), 그리고 실제 .NET 시스템에 맞춰진 자동화 친화적인 명령줄 인터페이스를 결합합니다: 명시적이고, 테스트 가능하며, 운영적으로 가독성이 높습니다.
해당 레포지토리는 이제 터미널 우선 에이전트 런타임과 SharpClaw.Code를 통한 임베디드 호스트 SDK를 모두 제공하여, 독립형 CLI, 로컬 에디터 백엔드, 그리고 테넌트 인식 임베디드 서비스에 활용 가능하게 만들었습니다.
SharpClaw Code는 .NET 생태계에서 코딩 에이전트 경험을 구축하고 운영하기 위한 오픈 소스 런타임입니다. claude code가 C#의 opencode와 만난 느낌이라고 생각할 수 있습니다.
이는 다음을 위해 설계되었습니다:
임시 스크립트를 조합하는 대신 C# 코딩 에이전트 런타임을 원하는 팀
강력한 기계 판독형 출력을 갖춘 AI 기반 CLI 도구를 구축하는 개발자
MCP 통합, 플러그인 검색(plugin discovery), 그리고 권한 인식 도구 실행이 필요한 제품
내구성 있는 세션 상태, 추가 전용 기록(append-only history), 그리고 재현 가능한 런타임 이벤트가 필요한 워크플로우
Windows 안전 동작에 대한 의도적인 주의를 기울인 크로스 플랫폼 환경
.NET 네이티브 아키텍처: .NET 10, C# 13을 중심으로 하며, 관용적인 DI(Dependency Injection), System.Text.Json, System.CommandLine, 그리고 Spectre.Console을 활용합니다.
내구성 있는 런타임 모델 (Durable runtime model): 세션, 체크포인트, 추가 전용 이벤트 로그(append-only event logs), 내보내기/가져오기 흐름(export/import flows), 그리고 복구 인식 오케스트레이션(recovery-aware orchestration)을 지원합니다.
디폴트 안전성 (Safety by default): 권한 모드, 승인 게이트(approval gates), 작업 공간 경계 강제(workspace-boundary enforcement), 그리고 매개된 도구 실행(mediated tool execution) 기능을 제공합니다.
확장 가능한 표면 (Extensible surface): 프로바이더(providers), MCP 서버, 플러그인, 스킬(skills), ACP 호스팅, 런타임 명령을 명시적인 이음매(explicit seams)를 통해 통합할 수 있습니다.
자동화 준비 인터페이스 (Automation-ready interface): 안정적인 JSON 출력, 운영 명령어(operational commands), 그리고 사람과 스크립트 모두에게 작동하는 깔끔한 CLI 우선 워크플로우를 제공합니다.
프레임워크 의존형 NuGet CLI 도구와 집계 SDK 패키지는 ASP.NET Core 10 공유 런타임(shared runtime)을 필요로 하며, 이는 .NET 10 SDK에 포함되어 있습니다. 자급자족적 네이티브 아카이브(Self-contained native archives)에는 필요한 런타임이 포함됩니다.
버전 태그가 지정된 릴리스는 x64 및 ARM64용 Windows, Linux, macOS의 네이티브 바이너리를 포함하도록 구성되었습니다. 일치하는 아카이브를 추출하고 sharpclaw version을 실행하면 됩니다. 기본적인 명령어는 설치된 .NET 런타임이 필요하지 않습니다. 하지만 시맨틱 프로젝트 로딩(Semantic project loading) 및 빌드/테스트 검증에는 여전히 .NET SDK와 복원된 에셋(restored assets)이 필요합니다. 패키징 및 스모크 게이트에 대한 자세한 내용은 바이너리 배포를 참조하십시오.
dotnet tool install --global SharpClaw.Code.Cli --prerelease
권한, 전제 조건 및 예시에 대한 자세한 내용은 .NET 인텔리전스, 검증(verification), 그리고 MCP 서버를 참조하십시오.
git clone https://github.com/clawdotnet/SharpClawCode.git
cd SharpClawCode
dotnet build SharpClawCode.sln
...
dotnet run --project src/SharpClaw.Code.Cli -- [arguments]
# 대화형 REPL 시작
dotnet run --project src/SharpClaw.Code.Cli
dotnet run --project src/SharpClaw.Code.Cli -- repl
...
내장된 REPL 슬래시 명령어에는 /help, /status, /doctor, /session, /commands, /mode, /editor, /export, /undo, /redo, 그리고 /version이 포함됩니다. /help를 사용하여 발견된 워크스페이스 사용자 정의 명령어를 포함한 활성 명령어 세트를 확인할 수 있습니다.
패리티 지향(Parity-oriented) 명령어에는 다음이 추가되었습니다:
index / /indexmemory / /memorymodels / /modelsusage / /usagecost / /coststats / /statsconnect / /connecthooks / /hooksskills / /skillsagents / /agentstodo / /todoshare / /shareunshare / /unsharecompact / /compactserve / /serveworktree / /worktree/sessions (/session list의 더 사용자 친화적인 별칭)주요 워크플로우 모드:
build: 일반 코딩 에이전트(coding-agent) 실행plan: 도구 변경을 차단하고 계획 소유 세션의 할 일 목록(todo)과 동기화하는 구조적 심층 계획(structured deep planning)spec: docs/superpowers/specs/<date>-<slug>/ 아래에 Kiro 스타일 사양(spec) 아티팩트를 생성합니다.| 기능 | 중요한 이유 |
|---|---|
| 영속적인 세션 (Durable sessions) | 더 오래 실행되는 에이전트 작업의 대화 상태, 턴 기록, 체크포인트 및 복구 메타데이터를 보존합니다. |
| ... |
| 영역 | 프로젝트(들) |
|---|---|
| 임베드 가능한 SDK (Embeddable SDK) | SharpClaw.Code |
| ... | |
| 의존성 경계 및 프로젝트 책임에 대해서는 docs/architecture.md와 AGENTS.md를 참조하세요. |
솔루션에는 examples/ 아래에 임베드 가능한 호스트 샘플이 포함되어 있습니다.
MinimalConsoleAgentWebApiAgentWorkerServiceHostMcpToolAgentMcpToolAgent는 또한 모델 제공자 키 없이 익명의 웹 검색 및 페이지 추출을 위해 SharpClaw 도구 레지스트리(tool registry)와 권한 실행기(permission executor)를 통해 실행 가능한 병렬 검색 MCP 예제를 제공합니다.
# 모든 테스트 실행
dotnet test SharpClawCode.sln
...
| 프로젝트 | 목적 |
|---|---|
SharpClaw.Code.UnitTests | 도구, 권한, 세션, 제공자(providers), 상태 기계(state machine), 원격 측정(telemetry), 직렬화 등을 포함하는 빠른 단위 테스트 |
| ... |
| 옵션 | 설명 |
|---|---|
--cwd <path> | 작업 디렉터리; 현재 디렉터리에 기본값 설정 |
| ... | |
하위 명령어에는 prompt, repl, doctor, status, session, index, memory, models, usage, cost, stats, connect, hooks, skills, agents, todo, share, unshare, compact, serve, commands, worktree, mcp, plugins, tool-packages, acp, bridge, 및 version이 포함됩니다. |
| Doc | 주제 |
|---|---|
| docs/architecture.md | 솔루션 레이아웃, 종속성(dependencies), 실행 흐름 |
| ... |
SharpClaw Code는 표준 .NET 구성 스택(appsettings.json, 환경 변수, CLI 인자)과 계층화된 SharpClaw JSONC 설정 파일을 모두 사용합니다:
~/.config/sharpclaw/config.jsonc%AppData%\SharpClaw\config.jsonc<workspace>/sharpclaw.jsonc우선순위는 다음과 같습니다:
CLI 인자 > workspace sharpclaw.jsonc > user config.jsonc > appsettings/environment 기본값
주요 런타임 구성 섹션(Key runtime configuration sections):
usage summary, usage detail, tool-packages 명령을 통해 이러한 엔터프라이즈 표면(enterprise surfaces)을 미러링하며, 기존의 작업 공간 로컬 usage, cost, 및 stats 흐름을 유지합니다.--output-format json을 통해 안정적인 JSON 출력을 지원하여, 스크립트, 에디터 및 자동화에 적합합니다..NET 10과 C# 13을 사용하세요. 프로젝트 경계, 직렬화 규칙(serialization conventions), 로깅 기대치, 크로스 플랫폼 규칙에 대해서는 AGENTS.md를 따르세요.
PR을 열기 전에:
dotnet build SharpClawCode.sln
dotnet test SharpClawCode.sln
dotnet build examples/WebApiAgent/WebApiAgent.csproj
...
이 프로젝트는 MIT License에 따라 라이선스가 부여됩니다.