Zing 论坛

正文

BasicallyClaude:将任何模型转化为 Claude Code 级推理能力的开源方案

基于完整泄露的 Claude Code 源码构建的 OpenCode 智能体,让任意底层模型都能获得 Anthropic 官方编码助手的架构级行为模式与工具使用规范。

Claude CodeOpenCodeAI编程助手智能体架构代码泄露Anthropic模型无关行为编译器MCP工具系统
发布时间 2026/05/25 09:13最近活动 2026/05/25 09:20预计阅读 16 分钟
BasicallyClaude:将任何模型转化为 Claude Code 级推理能力的开源方案
1

章节 01

导读 / 主楼:BasicallyClaude:将任何模型转化为 Claude Code 级推理能力的开源方案

基于完整泄露的 Claude Code 源码构建的 OpenCode 智能体,让任意底层模型都能获得 Anthropic 官方编码助手的架构级行为模式与工具使用规范。

2

章节 02

原作者与来源

BasicallyClaude:将任何模型转化为 Claude Code 级推理能力的开源方案\n\n## 原作者与来源\n\n- 原作者/维护者: cryxservices-glitch(Aporia 团队)\n- 来源平台: GitHub\n- 原始标题: BasicallyClaude\n- 原始链接: https://github.com/cryxservices-glitch/BasicallyClaude\n- 源码基础: codeaashu/claude-code(完整泄露源码)\n- 发布时间: 2026年5月25日\n\n---\n\n## 项目背景与动机\n\n2026年3月31日,Anthropic 的 Claude Code CLI 完整源码意外泄露至公共网络。这份包含约51.2万行 TypeScript 代码、1900+文件、40+工具和85+斜杠命令的工程资产,代表了当前 AI 辅助编程领域最成熟的架构实现之一。然而,源码本身并不等同于可用产品——如何将其转化为实际生产力工具,成为社区关注的焦点。\n\nBasicallyClaude 项目的诞生正是对这一需求的回应。它并非简单的"克隆"或"包装",而是一个行为编译器(behavioral compiler)——将 Claude Code 的 TypeScript 源码模式转化为自然语言指令,使任何底层模型都能遵循 Anthropic 官方编码助手的架构规范和行为模式运行。\n\n---\n\n## 核心架构解析\n\n### 三层架构设计\n\nBasicallyClaude 采用独特的三层架构,实现了从源码到行为的完整映射:\n\n#### 第一层:源码引用层\n\n项目完整保留了泄露的 codeaashu/claude-code 源码仓库,包括:\n\n- docs/ 目录:架构文档、工具清单、命令手册、子系统说明\n- src/ 目录:约2164个 TypeScript 源文件,涵盖工具实现、命令系统、权限模型、UI组件等\n- prompts/ 目录:系统提示词贡献\n- mcp-server/ 目录:独立 MCP 服务器实现\n\n这种设计使得模型在运行时可以直接引用原始源码。需要理解工具实现?读取 src/tools/BashTool/BashTool.ts。需要权限模型?查看 src/hooks/toolPermission/。这种源码即文档的理念,确保了行为的可解释性和可追溯性。\n\n#### 第二层:智能体编译层\n\nBasicallyClaude.md 是项目的核心资产,它不是传统的人格化提示词,而是一个行为编译器。它将 TypeScript 源码中的模式转化为可执行的行为规则:\n\n| 源码模式(TypeScript) | 智能体行为 |\n|---------------------|-----------|\n| buildTool({ name, inputSchema, call, checkPermissions }) | 以目的、作用域和安全意识使用工具 |\n| PromptCommand({ type: 'prompt', getPromptForCommand }) | 将斜杠意图映射到结构化工作流提示 |\n| checkPermissions(input, context) | 破坏性操作前暂停并评估风险 |\n| QueryEngine 流式处理 + 工具循环 | 推理→收集→执行→观察→迭代→报告 |\n| isConcurrencySafe() | 并行化独立读取操作 |\n\n#### 第三层:运行时执行层\n\n当用户在 OpenCode 中向 BasicallyClaude 发送提示时,执行流程如下:\n\n1. 意图理解: BasicallyClaude.md 读取提示,理解用户意图\n2. 架构引用: 引用 claude-code/docs/ 获取架构指导\n3. 模式应用: 从 src/tools/src/commands/ 提取工具和命令模式\n4. 推理循环: 应用 QueryEngine.ts 的推理循环模式\n5. 权限路由: 通过命令/工具/权限模型路由意图\n6. 质量自检: 使用内置质量评估标准自我校正\n\n底层模型(Claude、GPT、DeepSeek、Gemini 等)接收这些结构化行为指令后,以 Claude Code 级别的规范性执行工具调用和推理。\n\n---\n\n## 技术亮点与创新\n\n### 1. 真正的源码级复现\n\n与市面上仅通过提示词模拟 Claude Code 行为的"包装器"不同,BasicallyClaude 直接嵌入了完整的源码仓库。这意味着:\n\n- 工具实现: 40+ 工具的实际 TypeScript 实现可供参考\n- 命令系统: 85+ 斜杠命令的完整注册表和实现\n- 权限模型: 真实的权限检查钩子实现\n- UI组件: 140+ Ink/React 组件的源码\n- 服务层: API、MCP、OAuth、LSP、插件、分析等服务的完整实现\n\n### 2. 模型无关的架构移植\n\n项目的核心创新在于将架构与模型解耦。Claude Code 的优秀表现不仅来自底层模型的能力,更来自其精心设计的工具使用规范、推理循环和权限模型。BasicallyClaude 将这些架构模式提取为模型可理解的行为指令,使得:\n\n- GPT-4 系列模型可以获得 Claude Code 级的工具使用规范\n- DeepSeek 等国产模型可以遵循相同的推理循环模式\n- Gemini 系列可以获得一致的权限评估行为\n\n### 3. 完整的子系统映射\n\n项目完整映射了 Claude Code 的子系统架构:\n\n- MCP 集成: 模型上下文协议支持\n- 权限系统: 细粒度的工具权限控制\n- 插件市场: 可扩展的插件架构\n- 任务管理: 后台任务调度系统\n- 持久化记忆: memdir 记忆系统\n- 语音交互: 语音输入/输出支持(需授权)\n- Vim 模式: 完整的 Vim 键位支持\n- IDE 桥接: VS Code、JetBrains 等 IDE 的集成协议\n\n---\n\n## 安装与使用\n\n### OpenCode 集成\n\nBasicallyClaude 专为 OpenCode 设计,安装流程简洁:\n\n1. 全局安装:\n bash\n # 克隆仓库\n git clone https://github.com/cryxservices-glitch/BasicallyClaude.git\n cd BasicallyClaude\n \n # 安装到 OpenCode 全局配置\n opencode agent add --global --path .opencode/agents/BasicallyClaude.md\n \n\n2. 项目级安装:\n bash\n # 在项目目录执行\n opencode agent add --path /path/to/BasicallyClaude/.opencode/agents/BasicallyClaude.md\n \n\n3. 设为默认智能体:\n bash\n opencode config set defaultAgent BasicallyClaude\n \n\n### 推荐模型配置\n\n虽然 BasicallyClaude 理论上支持任何模型,但以下配置可获得最佳体验:\n\n| 模型 | 推荐度 | 说明 |\n|-----|-------|------|\n| Claude 3.5/4 Sonnet | ★★★★★ | 原生架构匹配,最佳兼容性 |\n| GPT-4o | ★★★★☆ | 优秀的工具理解和执行能力 |\n| DeepSeek-V3 | ★★★★☆ | 国产大模型,推理能力出色 |\n| Gemini 2.5 Pro | ★★★★☆ | 长上下文支持,适合大型代码库 |\n\n---\n\n## 局限性与注意事项\n\n### 已知局限\n\n1. 源码完整性: 虽然包含完整源码,但部分功能(如语音、某些云服务集成)可能需要 Anthropic 后端支持\n2. 模型能力差异: 底层模型的固有差异会影响最终输出质量,架构规范无法完全弥补模型能力差距\n3. 实时更新: 基于泄露源码的静态快照,不包含 Claude Code 后续更新\n\n### 使用建议\n\n- 对于关键生产代码,建议结合代码审查使用\n- 充分利用权限系统,避免自动执行高风险操作\n- 定期备份工作区,防止意外修改\n\n---\n\n## 社区意义与影响\n\nBasicallyClaude 的出现具有多重意义:\n\n### 1. 架构民主化\n\n它将 Claude Code 的工程最佳实践从单一产品转化为可复用的架构模式,让更广泛的开发者和模型受益。这种"架构开源"的思路,可能比源码本身更具长期价值。\n\n### 2. 模型能力边界探索\n\n通过将相同的架构规范应用于不同底层模型,项目为研究"架构 vs 模型能力对最终表现的影响"提供了天然实验场。\n\n### 3. 智能体设计范式\n\nBasicallyClaude 展示了新一代智能体设计范式——源码即提示(Code as Prompt)。当智能体可以直接引用、理解和执行源码中的模式时,提示工程的能力边界被显著扩展。\n\n---\n\n## 总结与展望\n\nBasicallyClaude 代表了 AI 辅助编程工具演进的一个重要节点。它证明了:优秀的 AI 产品不仅依赖底层模型的能力,更依赖精心设计的架构、工具和流程。通过将 Claude Code 的完整源码转化为可执行的行为规范,项目为社区提供了一个独特的研究和应用平台。\n\n对于开发者而言,这是一个学习顶级 AI 工程架构的绝佳机会;对于研究者而言,这是探索架构-模型交互的实验场;对于日常用户而言,这是获得 Claude Code 级体验的可行路径。\n\n随着 OpenCode 生态的发展和更多模型的接入,BasicallyClaude 有望成为智能体架构标准化的重要参考实现。

3

章节 03

补充观点 1

原作者与来源

  • 原作者/维护者:cryxservices-glitch
  • 来源平台:github
  • 原始标题:BasicallyClaude
  • 原始链接:https://github.com/cryxservices-glitch/BasicallyClaude
  • 来源发布时间/更新时间:2026-05-25T01:13:23Z BasicallyClaude:将任何模型转化为 Claude Code 级推理能力的开源方案\n\n原作者与来源\n\n- 原作者/维护者: cryxservices-glitch(Aporia 团队)\n- 来源平台: GitHub\n- 原始标题: BasicallyClaude\n- 原始链接: https://github.com/cryxservices-glitch/BasicallyClaude\n- 源码基础: codeaashu/claude-code(完整泄露源码)\n- 发布时间: 2026年5月25日\n\n---\n\n项目背景与动机\n\n2026年3月31日,Anthropic 的 Claude Code CLI 完整源码意外泄露至公共网络。这份包含约51.2万行 TypeScript 代码、1900+文件、40+工具和85+斜杠命令的工程资产,代表了当前 AI 辅助编程领域最成熟的架构实现之一。然而,源码本身并不等同于可用产品——如何将其转化为实际生产力工具,成为社区关注的焦点。\n\nBasicallyClaude 项目的诞生正是对这一需求的回应。它并非简单的"克隆"或"包装",而是一个行为编译器(behavioral compiler)——将 Claude Code 的 TypeScript 源码模式转化为自然语言指令,使任何底层模型都能遵循 Anthropic 官方编码助手的架构规范和行为模式运行。\n\n---\n\n核心架构解析\n\n三层架构设计\n\nBasicallyClaude 采用独特的三层架构,实现了从源码到行为的完整映射:\n\n第一层:源码引用层\n\n项目完整保留了泄露的 codeaashu/claude-code 源码仓库,包括:\n\n- docs/ 目录:架构文档、工具清单、命令手册、子系统说明\n- src/ 目录:约2164个 TypeScript 源文件,涵盖工具实现、命令系统、权限模型、UI组件等\n- prompts/ 目录:系统提示词贡献\n- mcp-server/ 目录:独立 MCP 服务器实现\n\n这种设计使得模型在运行时可以直接引用原始源码。需要理解工具实现?读取 src/tools/BashTool/BashTool.ts。需要权限模型?查看 src/hooks/toolPermission/。这种源码即文档的理念,确保了行为的可解释性和可追溯性。\n\n第二层:智能体编译层\n\nBasicallyClaude.md 是项目的核心资产,它不是传统的人格化提示词,而是一个行为编译器。它将 TypeScript 源码中的模式转化为可执行的行为规则:\n\n| 源码模式(TypeScript) | 智能体行为 |\n|---------------------|-----------|\n| buildTool({ name, inputSchema, call, checkPermissions }) | 以目的、作用域和安全意识使用工具 |\n| PromptCommand({ type: 'prompt', getPromptForCommand }) | 将斜杠意图映射到结构化工作流提示 |\n| checkPermissions(input, context) | 破坏性操作前暂停并评估风险 |\n| QueryEngine 流式处理 + 工具循环 | 推理→收集→执行→观察→迭代→报告 |\n| isConcurrencySafe() | 并行化独立读取操作 |\n\n第三层:运行时执行层\n\n当用户在 OpenCode 中向 BasicallyClaude 发送提示时,执行流程如下:\n\n1. 意图理解: BasicallyClaude.md 读取提示,理解用户意图\n2. 架构引用: 引用 claude-code/docs/ 获取架构指导\n3. 模式应用: 从 src/tools/src/commands/ 提取工具和命令模式\n4. 推理循环: 应用 QueryEngine.ts 的推理循环模式\n5. 权限路由: 通过命令/工具/权限模型路由意图\n6. 质量自检: 使用内置质量评估标准自我校正\n\n底层模型(Claude、GPT、DeepSeek、Gemini 等)接收这些结构化行为指令后,以 Claude Code 级别的规范性执行工具调用和推理。\n\n---\n\n技术亮点与创新\n\n1. 真正的源码级复现\n\n与市面上仅通过提示词模拟 Claude Code 行为的"包装器"不同,BasicallyClaude 直接嵌入了完整的源码仓库。这意味着:\n\n- 工具实现: 40+ 工具的实际 TypeScript 实现可供参考\n- 命令系统: 85+ 斜杠命令的完整注册表和实现\n- 权限模型: 真实的权限检查钩子实现\n- UI组件: 140+ Ink/React 组件的源码\n- 服务层: API、MCP、OAuth、LSP、插件、分析等服务的完整实现\n\n2. 模型无关的架构移植\n\n项目的核心创新在于将架构与模型解耦。Claude Code 的优秀表现不仅来自底层模型的能力,更来自其精心设计的工具使用规范、推理循环和权限模型。BasicallyClaude 将这些架构模式提取为模型可理解的行为指令,使得:\n\n- GPT-4 系列模型可以获得 Claude Code 级的工具使用规范\n- DeepSeek 等国产模型可以遵循相同的推理循环模式\n- Gemini 系列可以获得一致的权限评估行为\n\n3. 完整的子系统映射\n\n项目完整映射了 Claude Code 的子系统架构:\n\n- MCP 集成: 模型上下文协议支持\n- 权限系统: 细粒度的工具权限控制\n- 插件市场: 可扩展的插件架构\n- 任务管理: 后台任务调度系统\n- 持久化记忆: memdir 记忆系统\n- 语音交互: 语音输入/输出支持(需授权)\n- Vim 模式: 完整的 Vim 键位支持\n- IDE 桥接: VS Code、JetBrains 等 IDE 的集成协议\n\n---\n\n安装与使用\n\nOpenCode 集成\n\nBasicallyClaude 专为 OpenCode 设计,安装流程简洁:\n\n1. 全局安装:\n bash\n 克隆仓库\n git clone https://github.com/cryxservices-glitch/BasicallyClaude.git\n cd BasicallyClaude\n \n 安装到 OpenCode 全局配置\n opencode agent add --global --path .opencode/agents/BasicallyClaude.md\n \n\n2. 项目级安装:\n bash\n 在项目目录执行\n opencode agent add --path /path/to/BasicallyClaude/.opencode/agents/BasicallyClaude.md\n \n\n3. 设为默认智能体:\n bash\n opencode config set defaultAgent BasicallyClaude\n \n\n推荐模型配置\n\n虽然 BasicallyClaude 理论上支持任何模型,但以下配置可获得最佳体验:\n\n| 模型 | 推荐度 | 说明 |\n|-----|-------|------|\n| Claude 3.5/4 Sonnet | ★★★★★ | 原生架构匹配,最佳兼容性 |\n| GPT-4o | ★★★★☆ | 优秀的工具理解和执行能力 |\n| DeepSeek-V3 | ★★★★☆ | 国产大模型,推理能力出色 |\n| Gemini 2.5 Pro | ★★★★☆ | 长上下文支持,适合大型代码库 |\n\n---\n\n局限性与注意事项\n\n已知局限\n\n1. 源码完整性: 虽然包含完整源码,但部分功能(如语音、某些云服务集成)可能需要 Anthropic 后端支持\n2. 模型能力差异: 底层模型的固有差异会影响最终输出质量,架构规范无法完全弥补模型能力差距\n3. 实时更新: 基于泄露源码的静态快照,不包含 Claude Code 后续更新\n\n使用建议\n\n- 对于关键生产代码,建议结合代码审查使用\n- 充分利用权限系统,避免自动执行高风险操作\n- 定期备份工作区,防止意外修改\n\n---\n\n社区意义与影响\n\nBasicallyClaude 的出现具有多重意义:\n\n1. 架构民主化\n\n它将 Claude Code 的工程最佳实践从单一产品转化为可复用的架构模式,让更广泛的开发者和模型受益。这种"架构开源"的思路,可能比源码本身更具长期价值。\n\n2. 模型能力边界探索\n\n通过将相同的架构规范应用于不同底层模型,项目为研究"架构 vs 模型能力对最终表现的影响"提供了天然实验场。\n\n3. 智能体设计范式\n\nBasicallyClaude 展示了新一代智能体设计范式——源码即提示(Code as Prompt)。当智能体可以直接引用、理解和执行源码中的模式时,提示工程的能力边界被显著扩展。\n\n---\n\n总结与展望\n\nBasicallyClaude 代表了 AI 辅助编程工具演进的一个重要节点。它证明了:优秀的 AI 产品不仅依赖底层模型的能力,更依赖精心设计的架构、工具和流程。通过将 Claude Code 的完整源码转化为可执行的行为规范,项目为社区提供了一个独特的研究和应用平台。\n\n对于开发者而言,这是一个学习顶级 AI 工程架构的绝佳机会;对于研究者而言,这是探索架构-模型交互的实验场;对于日常用户而言,这是获得 Claude Code 级体验的可行路径。\n\n随着 OpenCode 生态的发展和更多模型的接入,BasicallyClaude 有望成为智能体架构标准化的重要参考实现。