[开源自荐] cc-agent-sdk 将 Claude Code 封装成 API 提供服务 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
nightwhite
V2EX    OpenAI

[开源自荐] cc-agent-sdk 将 Claude Code 封装成 API 提供服务

  •  
  •   nightwhite 2025 年 12 月 30 日 774 次点击

    基于 Claude Code 官方 SDK ,兼容 Skills / 支持 Sub Agent ( API 形态)

    我把一套“Claude Code 风格的 Agent 能力”抽成了 API 形式的 SDK/服务cc-agent-sdk。它的定位是:基于 Claud Code 官方 SDK 做封装与扩展,让你更容易落地 skillssub agent 等能力,用同一套后端能力去支撑 Web/CLI/IDE 等不同客户端形态。


    cc-agent-sdk 是什么?

    cc-agent-sdk 是一个面向 Agent 的后端/API 能力层:

    • 基于 Claude Code 官方 SDK 做二次封装
    • 对外以 API 提供“可编排的 Agent 执行 + 工具调用”能力
    • 你只需要实现你自己的 UI/客户端,能力层复用 cc-agent-sdk 即可
    • 我做的 Web Demo 只是一个很薄的展示壳,用来演示交互效果

    为什么做这个?

    很多人想做“Claude Code 类体验”,但落地时常见两类阻力:

    • 能力堆在 Prompt 里,越写越长、难维护
    • 客户端形态绑定太死( CLI/IDE/Web 互相不通用)

    cc-agent-sdk 的思路是:在官方 SDK 的基础上,把能力工程化抽出来:
    skills 组织能力、sub agent 拆分任务、API 统一承载。客户端只管交互层。


    核心能力

    1) 兼容 Skills:能力模块化、可插拔

    • 用 skills 描述不同阶段/能力(分析、设计、开发、验证、总结……)
    • 能力可复用、可组合,便于规模化迭代
    • 更像真实工程流程,而不是“一次性 Prompt 工程”

    2) Sub Agent:多代理分工协作

    • 支持 sub agent (子代理)把复杂任务拆分处理
    • 主 agent 负责统筹,子 agent 负责专项任务(实现/排查/验证/文档等)
    • 更适合复杂需求与长链路任务

    3) API 形态:客户端更自由

    • SDK 以 API 方式提供能力,客户端只负责交互层
    • Web / CLI / IDE 插件都能用同一套后端能力复用
    • Web Demo 只是一个示例封装:证明“接 API 就能跑起来”

    快速开始

    具体运行与配置以仓库 README 为准(例如服务地址配置 AGENT_SDK_ENDPOINT 等):


    欢迎试用 / 反馈

    5 条回复    2026-01-01 13:06:05 +08:00
    nightwhite
        1
    nightwhite  
    OP
       2025 年 12 月 30 日
    漏写了,基于 claude-code 官方 API 封装,能力上可以等同于 claude-code
    dnslint
        2
    dnslint  
       2025 年 12 月 31 日
    本质上是 Claude code 在运行对吧,这里有个问题 如果有多个会话会不会造成性能问题
    nightwhite
        3
    nightwhite  
    OP
       2025 年 12 月 31 日
    @dnslint 用的是 claude code 官方的 ts SDK ,多个会话可以做多个容器做负载
    steveway
        4
    steveway  
       15 天前
    Good job! 如果 demo 前端也能开源就好了哈哈哈
    nightwhite
        5
    nightwhite  
    OP
       15 天前
    @steveway 前端比较简单,不是重点
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     2733 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 31ms UTC 14:41 PVG 22:41 LAX 06:41 JFK 09:41
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86