Nethür
登录
macOS 版即将推出

博客 · 2026年11月7日

无需共享 API key 的 Claude Code 团队方案

如何让团队共用一个 Claude Code 工作空间,而不用传递 key:每人自己的订阅、共享项目、session 交接,以及其中的取舍。

Nethür 团队工作空间,包含共享项目和 agent session

把工作空间放在团队可以访问的主机上,邀请队友加入共享项目,让每个人登录自己的 Claude 订阅。像 Nethür 这样的工具让大家拥有相同的 worktree、session 和聊天,而不需要共享 API key、共享登录账号或转售的模型账单。

团队第一次尝试共享 Claude Code 时,通常有人创建一个共享 API key 发到 Slack 里。这能撑一周。然后账单来了,却无法分辨谁花了多少;一名队友离职,key 得在所有地方轮换;而 rate limit 是一个共享的桶,所有人一起把它掏空。

替代方案并不是“不协作”。而是把被捆在一起的两件事拆开:共享的工作空间和模型凭证。工作空间应该共享,凭证应该保持个人化。

为什么共享 API key 不适合团队

  • 归属消失。每个请求看起来都来自同一个账号,你无法看出谁在消耗预算,或哪个项目开销大。
  • 离职处理手忙脚乱。一个人离开意味着要在每台机器、每个 CI job 和每个脚本里找到并轮换 key。
  • rate limit 被共享。一个失控的 agent 就能在当前窗口剩余时间里拖住整个团队。
  • 安全是全有或全无。拿到 key 的人可以在任何地方使用它,泄露后也很难追查。
  • 账单与实际做事的人脱节。持卡人没法解释这个月的费用。

共享 Claude 登录账号有同样形状的问题,还多了 session 冲突:两个人用同一个账号,可能让对方认证失效,或在同一个用量窗口里互相争抢。

共享工作空间,而非凭证

好的团队方案有四个属性。每个队友有自己的身份和自己的模型订阅。团队共享项目、worktree 和 session。权限按人授予,也能按人撤销。工作运行在团队自己控制的主机上,而不是厂商的黑盒里。

Nethür 正是围绕这种拆分构建的。它是一个工作空间服务器加多个客户端:服务器拥有项目、worktree、terminal、agent、聊天、笔记和内容;桌面应用、浏览器和手机都是客户端。模型访问仍然由每个人已经付费的订阅提供。

搭建 Claude Code 团队工作空间

  1. 选择主机。VPS、家用服务器、办公室的 Mac mini,或队友一台常开的机器都可以。主机需要 git、agent CLI,以及访问模型提供方的网络。参见运行 Nethür 的方式。
  2. 在该主机上安装 Nethür 并启动服务器。小团队可以让桌面应用在后台运行服务器;需要常开时,用专用主机并从浏览器连接。
  3. 创建工作空间,导入团队共享的仓库。项目是访问权限的单位:成员只能看到被邀请的项目,而不是机器上的每个 checkout。
  4. 通过电子邮件邀请队友,并把他们分配到项目。一个席位就是一名被邀请的成员;计费按席位,而不是按服务器或并发 session。
  5. 让每个人在主机上登录自己的 Claude 账号,或者通过应用连接自己的账号。Nethür 会读取已有的 ~/.claude 配置,并按账号跟踪用量。不会创建任何共享 key。
  6. 按任务创建 worktree,并在其中启动 Claude Code。agent 在主机上运行;队友可以从浏览器或桌面应用打开同一个 worktree。
  7. 约定团队规范:branch 命名、谁审查哪个 worktree、session 何时交接,以及哪些项目允许运行自主 agent。

具体的菜单位置见团队聊天文档和远程服务器文档。关键是第 4 步和第 5 步彼此独立:成员资格是工作空间层面的决定,模型访问是个人层面的决定。

日常协作是什么样子

  • 团队聊天就在工作旁边,作用域是服务器。消息、文件、时间戳和未读计数都留在项目里,而不是另开一个 Slack 频道。
  • @ 提及会在工作所在的位置通知队友。提及指向 worktree 和 session,而不只是信息流里的一条消息。
  • 实时草稿显示队友正在输入什么,包括他们选用的模型和 sub-agent。在你重复劳动之前,就能看到已经有人在处理这个任务。
  • 接管让队友打开同一个 session,并用相同的上下文、provider 和账号继续。对话记录会显示谁提出了什么请求,因此事后能看到交接过程。
  • 笔记和内容属于项目,而不属于 worktree。决策、runbook、报告和文件在工作空间删除后依然存在。
  • 活动与通知把完成情况、被阻塞的 agent 和 worktree 创建集中在一处,覆盖整个团队。

实际效果是,你不再到处转发截图和 prompt。队友打开 worktree、阅读对话记录、向 agent 追问,然后让 session 以比接手时更好的状态继续。

共享 Claude Code 的三种方式

共享 API key共用一个登录账号各自订阅 + 工作空间
谁付费持有 key 的人持有登录账号的人每个人,各自按自己的套餐
用量归属无法按人区分无法按人区分按账号和按 session
离职处理在所有地方轮换修改密码移除成员
rate limit一个共享的桶一个共享的桶每个账号独立
session 冲突可能发生很可能发生按账号和 worktree 隔离
团队可见性只有聊天只有聊天共享项目、session 和聊天

真正重要的运维细节

一旦每个人都有自己的账号,那些枯燥的问题就变得可管理了。Nethür 按 Claude 和 Codex 账号跟踪用量,可以在不重启运行中 session 的情况下热切换账号,还能让你按优先级排列订阅。当某个 provider 触及上限时,聊天可以带着完整对话切换到下一个 provider;如果所有账号都用尽,它可以在最早重置的时间恢复。

还有两个较小的功能,适合有昂贵习惯的团队。用量预热会用最便宜的模型发一个极小的请求,提前启动 Claude 或 Codex 账号的五小时窗口,让重置时间落在团队真正需要它的时候。停止阈值会在账号超过五小时或每周的百分比阈值时暂停聊天,而不是让 agent 把最后的预算烧光。

代码和凭证存放在哪里

执行主机拥有工作。仓库、worktree、agent 进程和账号凭证都在你选择的机器上;客户端只负责渲染 session。如果主机是 VPS,那就是你的 VPS。如果主机是队友的笔记本,那台机器离线时访问就结束了。Nethür 不要求你把仓库上传到托管服务才能协作。

这种模式有取舍。必须有人给主机打补丁并做好备份。主机的 CPU 和磁盘要足以支撑并发 agent 的数量。而且如果主机消失,团队会失去访问,直到它恢复——这和任何共享开发服务器一样。对小团队而言,运维成本通常低于管理一套 key 分发系统,但它不是零。

费用是多少

在自己的电脑上个人使用是免费的。团队工作空间为每席位每月 $3.99,或每席位每年 $35.99,折算下来每月 $2.99。你仍需单独向模型提供方付费。没有按分钟计算的云费用,也没有 token 加价。

把它和共享 key 的隐性成本比较一下:一个人承担账单,没人能归因,每次离职处理都变成一个小型安全项目。席位费买到的是工作空间,不是模型。

这套方案适合谁

这种模式适合那些成员已经有 Claude Pro、Max 或其他订阅,并且希望在不合并账号的情况下在同一个项目中工作的团队。它也适合需要把代码留在自己机器或 VPS 上的团队。

它不能替代组织级的 API 合同。如果你的财务团队需要一张统一的 Anthropic 发票和集中式 API key 管理,请使用 Anthropic 的 API 和控制台。Nethür 面向日常的 agent 工作空间,并不假装自己是你的模型提供方。

从一个项目、两个人开始

不要第一天就迁移整个公司。把一个小型共享项目放在一台小主机上,邀请一位队友,用一个普通任务走完流程:创建 worktree、启动 Claude Code、审查 diff、交接 session。如果这一切让人觉得平淡而安全,再把团队其余成员加进来。

目标不是在公司的每个角落消灭 API key,而是不再把一把 key 当作工作空间的替代品。这是两个不同的问题,其中只有一个需要共享密钥。

把指南用起来。

下载 Nethür,几分钟内跑起第一个并行 agent;或者在你已有的机器上搭建团队工作空间。