HumanLayer

一句话介绍

HumanLayer是一套面向软件团队的AI编程智能体环境，可把任务、智能体会话、研究文档、设计稿、实施计划和代码工作树集中在同一工作区。

工具简介

HumanLayer强调让工程师持续参与关键决策，而不是把复杂需求直接交给模型一次性生成代码。结构化工作流会在实现前完成澄清、代码库研究、设计审阅和分阶段计划。

当前产品与早期同名SDK并非同一定位。早期HumanLayer主要为高风险智能体工具调用加入人工审批，现行产品则已发展为AI编程环境和团队级智能体编排平台。

主要功能

任务、会话与工件统一管理

每个Task可以集中关联多个智能体会话、研究和设计工件、实施计划以及代码工作树。团队成员能够围绕同一任务查看进度，减少上下文散落在聊天窗口和文档工具中的问题。

QRSPI结构化工作流

平台把复杂开发任务拆分为Questions、Research、Design、Structure、Plan和Implement六个阶段。每个阶段都留下可审阅成果，使错误假设有机会在大量代码生成前被发现。

多种任务工作流

除完整的QRSPI流程外，任务创建界面还提供RPI、RPI Outline、PRD-Oriented、Oneshot和Freeform等模式。用户可以根据改动规模选择深度研究、从提纲实施、产品需求驱动或直接处理简单任务。

研究、设计与计划工件

研究文档、设计说明、结构提纲、模型生成的界面草图和实施计划会成为与任务绑定的工件。工件可版本化和共享，团队不必依赖一段不断增长且难以审阅的对话记录。

评论驱动的设计审阅

工程师、产品经理和技术负责人可以直接在设计工件中评论，智能体再根据讨论结果调整方案。评论与实现流程相连，适合在编码前暴露架构误解和产品遗漏。

完整会话可见性

平台展示任务下各会话的状态、时间和关联工件，便于查看智能体正在研究、等待还是实施。团队可以在同一界面切换任务与会话，并继续向智能体补充反馈。

多仓库工作区与Worktree

一个任务可以关联多个代码仓库，并为选中的仓库创建隔离工作树。该能力适合同时修改服务端、前端和共享类型库，又不希望不同智能体会话互相覆盖工作目录的团队。

本地与云端并行智能体

本地守护进程能够在电脑上并行运行多个智能体会话，长期任务也可以交给云端守护进程。平台会同步状态，使用户能够通过网页、桌面端或手机界面查看进度。

快捷键与命令面板

HumanLayer提供面向键盘操作的任务、会话、工件和动作切换方式。高频开发者可以减少在编辑器、终端、工单和文档页面之间反复寻找上下文的时间。

支持的智能体与模型渠道

HumanLayer采用BYOK方式，用户接入已有的AI订阅或API密钥。现行页面列出Claude Code、Codex、Copilot和Fireworks，并表示会继续增加新的模型或订阅渠道。

BYOK并不等于使用成本为零。HumanLayer不另收按令牌计算的平台费用，但模型订阅、API令牌、云端计算和企业基础设施仍可能产生独立支出。

典型使用流程

用完整工作流处理复杂需求

1. 创建任务，从文字描述、Linear工单或Jira工单导入需求。
2. 选择参与的代码仓库，并决定立即创建、稍后创建或不创建工作树。
3. 让智能体先生成澄清问题，补充业务目标、技术约束和验收标准。
4. 进入研究阶段，检查其对代码库结构、依赖和既有模式的理解。
5. 审阅设计文档并通过行内评论纠正接口、数据流与架构判断。
6. 确认结构和实施计划包含文件位置、测试用例、验收项与回滚思路。
7. 批准后进入实现，并在每个阶段查看代码、测试和智能体反馈。
8. 完成后由人工执行代码审查、测试、安全检查和合并决策。

用轻量流程处理小改动

1. 为缺陷修复、文案调整或小范围重构建立独立任务。
2. 选择RPI Outline、Oneshot或Freeform，避免为简单改动建立过重流程。
3. 限制允许修改的仓库、目录和测试范围。
4. 检查智能体的差异、测试结果和未解决问题。
5. 确认没有越权修改或敏感信息后再提交代码。

任务创建与工作区配置

• 任务描述应包含目标、非目标、技术约束和可验证的完成标准。
• 多仓库任务要明确主仓库以及每个配套仓库承担的职责。
• 工作树适合并行隔离变更，但仍需规划分支命名、依赖安装和清理策略。
• 从Linear或Jira导入工单后，应补齐工单中缺少的代码库上下文。
• 高风险迁移、权限和支付逻辑应使用完整工作流并设置人工检查点。

工件与团队协作

• 研究工件记录代码库结构、依赖关系和既有实现模式。
• 设计工件用于讨论技术方案、数据流、接口和替代路径。
• 结构与计划工件把大型改动拆成可检查的小阶段。
• 内联图表和界面草图能够帮助团队更快理解交互与架构。
• 评论和决策会反馈给智能体，使工件成为执行流程的一部分。
• 工件与任务绑定，便于新成员回看为什么采用某种实现。

多仓库与并行开发

价格与套餐

截至2026年8月23日，HumanLayer公开Starter、Pro和Enterprise三档方案。Starter针对三人以内小团队，Pro按用户按月收费，Enterprise需要联系销售确定部署和合同条件。

套餐选择建议

• 个人或三人以内团队可以先用Starter验证工作流，每月200个会话可能限制高频并行开发。
• 需要无限任务、多仓库协作、远程守护进程或团队工件审阅时适合Pro。
• 需要统一身份登录、审计日志、私有网络或本地部署时应选择Enterprise并确认合同。
• 所有套餐都应把模型订阅、API密钥和云端运行成本纳入总体预算。
• 价格、税费和权益可能调整，购买前应以账户结算页或销售报价为准。

BYOK费用说明

平台允许使用已有Claude、Codex等订阅或API密钥，因此HumanLayer账单与模型账单彼此独立。评估成本时应同时统计平台席位、模型消耗、远程运行资源和内部审阅时间。

适合哪些用户

• 需要在大型或多仓库代码库中使用AI智能体的软件工程团队。
• 希望把研究、设计、计划和实施纳入统一审阅流程的技术负责人。
• 同时运行多个编码会话并需要工作树隔离的高级开发者。
• 希望从Linear或Jira工单启动智能体任务的产品研发团队。
• 有远程守护进程、审计日志、私有VPC或本地部署要求的企业。
• 重视可追溯决策和持续积累工程上下文的平台团队。

不太适合的情况

• 只需要单文件补全、简单问答或偶尔生成短代码的用户。
• 无法提供受支持模型订阅或API密钥的团队。
• 不愿维护任务边界、设计审阅和人工批准流程的个人。
• 禁止代码或开发工件进入外部云服务且未采购私有部署的组织。
• 希望依赖完全开源且可自行部署现行平台全部组件的用户。

产品优势

• 把需求澄清、代码库研究、设计、计划和实现组织成连续流程。
• 任务、会话、工件和工作树统一关联，方便团队理解开发状态。
• 设计评论能够直接反馈给智能体，减少文档与执行脱节。
• 支持多仓库与并行工作树，适合复杂工程环境。
• 本地和云端智能体可以共同承担不同持续时间的任务。
• BYOK允许团队继续使用已经采购的模型渠道。
• 免费Starter可供小团队低成本验证协作方式。

使用限制与风险

• 智能体仍可能误解代码、引入缺陷或生成不安全实现，人工审查不能省略。
• 结构化流程会增加前期讨论成本，不一定适合极小改动。
• 多会话并行可能造成重复工作、依赖冲突和更高模型消耗。
• 工作树只能隔离目录，不能替代分支策略、持续集成和权限管理。
• BYOK密钥和开发环境权限需要妥善隔离，避免智能体接触无关生产资源。
• 云端会话可能处理代码、提示词和工件，敏感组织应先完成数据与合规评估。
• 服务、功能和公开套餐仍可能变化，关键采购条件应写入合同。

隐私与数据安全

HumanLayer的运营主体为QueryTale, Inc.。隐私政策覆盖网站、软件和相关服务，并说明可能收集联系人、账户、付款、用户生成内容、使用活动、设备和近似位置等信息。

敏感代码与密钥管理

1. 为HumanLayer和模型渠道创建独立账户或专用密钥。
2. 只授予当前仓库和任务必需的文件、命令与网络权限。
3. 将生产凭证、客户数据和个人信息排除在提示词与工件之外。
4. 在允许云端守护进程处理代码前完成数据分类和跨境审查。
5. 使用代码审查、自动测试、秘密扫描和依赖检查验证输出。
6. 任务结束后撤销临时密钥并清理不再使用的工作树和会话。

开源与GitHub说明

现行官网明确表示HumanLayer平台目前尚未整体开源，但研究、计划、实现工作流已经公开。不能因为历史仓库可查看代码，就把当前云平台、本地守护进程和团队服务全部标记为开源。

早期HumanLayer与CodeLayer仓库曾采用Apache-2.0许可证，现有仓库说明和开发状态存在历史过渡痕迹。早期SDK文档已经标注被CodeLayer取代，相关SDK代码也已从主项目移除。

早期SDK与现行产品的区别

基本信息

常见问题

HumanLayer是什么？

它是一套把AI编程智能体、任务、会话、工程工件和代码工作树组织到一起的团队开发平台。核心价值是让工程师在研究、设计和实施的关键阶段持续审阅。

HumanLayer免费吗？

Starter方案免费，最多支持3名团队成员和每月200个会话。更高用量、多仓库工作区、远程守护进程和高级协作能力可选择Pro或Enterprise。

Pro套餐多少钱？

当前公开价格为每位用户每月100美元。模型订阅或API用量不包含在该席位费中，需要通过BYOK渠道另行承担。

是否支持Codex？

支持。现行产品页面将Codex列入BYOK智能体和模型渠道，同时也列出Claude Code、Copilot与Fireworks。

是否必须使用完整QRSPI流程？

不必须。用户还可以选择RPI、RPI Outline、PRD-Oriented、Oneshot或Freeform，根据任务复杂度减少或增加检查阶段。

能处理多个仓库吗？

可以。Pro方案包含多仓库工作区和工作树，创建任务时可以为多个仓库准备隔离目录。

HumanLayer是开源软件吗？

现行平台尚未整体开源，只有部分工作流和历史项目公开。早期仓库的Apache-2.0许可不能直接代表当前商业平台全部组件。

早期人工审批SDK还能用于新项目吗？

不建议。相关文档已明确说明早期SDK被CodeLayer取代，SDK代码也已从主项目移除，新项目应根据当前产品能力重新评估方案。

代码会一直留在云端吗？

公开隐私政策没有为所有代码与工件承诺统一固定天数，而是按业务目的和法律要求保存。敏感团队应向销售确认具体数据流、保存、删除和私有部署条款。

可以完全取代代码审查吗？

不可以。平台帮助团队更早审查研究、设计和计划，但模型仍可能生成错误或不安全代码，最终测试、权限检查和合并责任仍由团队承担。

总结

HumanLayer适合希望把AI编程从单次聊天升级为团队工程流程的用户。它通过任务、工件、评论、工作树和本地或云端会话，让复杂改动在实施前获得更多可验证的上下文。

选择时应重点比较团队规模、每月会话量、多仓库需求、模型费用、云端代码处理和合规要求。还要区分现行商业平台、公开工作流与已弃用的早期SDK，避免基于历史仓库作出错误部署判断。