章节 01
导读 / 主楼:BasicallyClaude:将任何模型转化为 Claude Code 级推理能力的开源方案
基于完整泄露的 Claude Code 源码构建的 OpenCode 智能体,让任意底层模型都能获得 Anthropic 官方编码助手的架构级行为模式与工具使用规范。
正文
基于完整泄露的 Claude Code 源码构建的 OpenCode 智能体,让任意底层模型都能获得 Anthropic 官方编码助手的架构级行为模式与工具使用规范。
章节 01
基于完整泄露的 Claude Code 源码构建的 OpenCode 智能体,让任意底层模型都能获得 Anthropic 官方编码助手的架构级行为模式与工具使用规范。
章节 02
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 有望成为智能体架构标准化的重要参考实现。章节 03
原作者与来源
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 有望成为智能体架构标准化的重要参考实现。