
开源项目 One Code 在 pi 上复刻 Claude Code 的大多数功能并支持任意模型
来源标题:Show HN: One Code, almost all of Claude Code's features on pi, with any model
One Code 是一个基于 pi 构建的独立开源实现,把 Claude Code 的工作流搬到任意模型或提供商上。子代理、Git worktree、自动模式、计划模式、权限与上下文管理都内置于 harness,现有 CLAUDE.md、skills、commands 和权限规则可直接沿用,无需导入。它可通过 npm 安装,支持会话中切换模型或为各子代理单独指定模型。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Claude Code,模型槽位开放。完整工作流,开源,可跑在任何模型或服务商上。
One Code 围绕你选择的模型重建 Claude Code 工作流。子代理、Git worktree、自动模式、计划模式、权限和上下文管理都住在 harness 里,所以无论你放进去什么模型,它们都跟着走。你的 CLAUDE.md、skills、commands、agents 和权限规则原样沿用,不需要导入步骤。
如果你已经在用 Claude Code,这里没有需要重新学的东西。选一个模型,给它一个任务,审阅它的计划,然后让它干活。可以在会话中途切换模型,也可以给每个子代理分配自己的模型和服务商:主任务用前沿模型,探索和测试用更便宜的。
One Code 是一个独立的开源实现,构建在 pi 之上。它重建了编码工作流;依赖 Claude Code 托管服务或桌面服务的功能不在它的范围内。
用户指南 · 复用你的 Claude Code 配置 · 与 Claude Code 的差异 · 命令参考
安装 Node.js 22.19 或更高版本,然后运行:
npm install -g @one-ai/one-code cd your-project onecode
在 One Code 里,运行 /login 连接服务商,然后运行 /model 选择模型。你也可以通过环境变量提供 API key,例如 ANTHROPIC_API_KEY、OPENAI_API_KEY 或 OPENROUTER_API_KEY。
One Code 直接读取现有的 CLAUDE.md 和 .claude/ 配置。如果目录里没有 CLAUDE.md,它会回退到 AGENTS.md。对于新项目,运行 /init 起草一个 CLAUDE.md。
要检查你的配置,运行 onecode doctor,或在会话内运行 /doctor report。报告会列出服务商凭据、模型分配、检测到的配置和缺失的程序。运行 /doctor 可获得带代理辅助修复的检查。
One Code 在 macOS 上开发,并在 macOS、Linux 和 Windows 上验证。WSL 也可用。关于原生 Windows 安装及已验证的内容,见 Windows 指南。
One Code 在 MIT 许可证下免费。模型访问、使用费用和速率限制取决于你的服务商。连接选项见服务商与模型。
Homebrew,会为你安装 Node.js:
brew install isurumaduranga/one-ai/onecode
Windows 安装器,会安装 Node.js 和 One Code:
powershell -c "irm https://raw.githubusercontent.com/IsuruMaduranga/one-code/master/install.ps1 | iex"
已有的 pi 安装:
pi install npm:one-code-extension
@one-ai/one-code 应用包捆绑了一个固定版本的 pi,并提供 onecode 命令。one-code-extension 包使用你现有的 pi 安装,并在 pi 1.0.0 到 1.5 版本上测试过。对于扩展包,用 pi 代替 onecode。
应用默认在全屏终端界面中打开。显示设置和更多安装细节见安装指南。
按任务选择模型。使用 Anthropic、OpenAI、Gemini、OpenRouter 或本地模型。用 /model 在会话中途切换主模型。
在一个会话中混合服务商。给主代理和每个子代理各自的模型和服务商,无需配置路由网关。
复用你的 Claude Code 配置。One Code 读取项目指令、skills、commands、agents、plugins、权限规则和 Model Context Protocol (MCP) 服务器配置。没有导入步骤。
让引导适配模型。四个能力层级会调整提示和工具引导,对较小的模型给出更明确的指令。
扩展 harness。One Code 是一个由扩展构建的 pi 包。添加你自己的扩展、主题和设置。
检查和修改代码。该项目在 MIT 许可证下开源。
🤔 为什么不给 Claude Code 加个 URL 覆盖来用?
你可以用 ANTHROPIC_BASE_URL 把 Claude Code 指向另一个端点。如果该端点支持 Claude Code 期望的 API,这足以在熟悉的界面里使用替代模型。
覆盖改变的是请求发往哪里。它本身不会让提示、服务商功能、认证或辅助模型调用去适配接收它们的模型。你的端点或网关必须弥合这些差距。
One Code 把这种适配构建进 harness:
当你有一个兼容端点就能满足需求时,用 URL 覆盖。当你想要 Claude Code 工作流、并且模型选择内建于提示、工具、认证和代理协调中时,用 One Code。
完整对比和兼容边界见与 Claude Code 的差异。
把首选模型留在主任务上,把探索、测试或审阅委派给另一个模型或服务商。
用 /subagent <provider/model-id> 设置子代理和工作流代理的默认模型。
用子代理调查认证代码及其测试。让它们汇报发现,然后在主会话中进行修复。
.claude/agents/ 中的代理定义可以指定自己的模型、工具和指令。用 /agents 跟踪它们的进度,用 /model 随任务变化更改主模型。
成本与输出质量取决于模型、任务以及你委派了多少工作。配置细节见子代理与工作流。
One Code 直接读取 Claude Code 配置,并将自己的设置分开保存。它把 ~/.claude 视为只读,只有一个刻意的例外:按仓库划分的记忆会写入 Claude Code 自己的记忆文件夹,因此两个工具共享它。
Claude Code 的工具名如 Read、Bash、Edit 和 Task 在权限规则和 hook 匹配器中可用。
兼容性覆盖配置和工作流。依赖 Claude Code 托管服务或桌面服务的功能和 skills 不包含在内。
见配置兼容性和 Skills、plugins 与 MCP。
子代理与 Git worktree
给一项调查独立的上下文窗口,并把结果带回主对话。子代理在后台运行,接受后续消息,并可在需要其上下文时分叉对话。
One Code 包含三个代理定义:general-purpose、explore 和 plan。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。