Claude CodeLLM GatewayNbilityEnvironment

Claude Code 后台会话丢网关:2.1.326 之后先让它停下,再改配置

从 2.1.326 起,后台会话拿不到你在 shell 里导出的网关地址时,会在发请求前停下。原因在 supervisor 与配置来源,把 ANTHROPIC_BASE_URL 写进 settings.json 的 env 块才不会被环境差异吃掉,并按 /status 与 daemon status 核对。

查看接入文档
Claude Code 后台会话丢网关:2.1.326 之后先让它停下,再改配置

Claude Code 在 2026 年 11 月 16 日发布的 2.1.326 修了一个容易花错钱的问题:后台会话丢了你在 shell 里导出的网关(ANTHROPIC_BASE_URL),以前会继续跑,现在会在发出任何模型请求之前停下并说明原因。

会触发这段逻辑的情况有三种:后台服务崩溃重启后、从另一个文件夹重新打开会话时,以及后台服务本身没有这个变量的环境。它不会替你猜一个地址,也不会悄悄换回其他登录方式。

本文依据 2.1.326 的 CHANGELOG、agent view 文档、连接 LLM 网关与错误说明,核对于 2026 年 11 月 17 日。我没有复现崩溃或跨目录重开,也没有在你机器上运行这些命令;下面的判断来自官方文档,验证步骤留给你按实际情况执行。

终端、supervisor 与会话进程如何传递网关地址

谁在发请求:前台会话与后台会话不是一回事

直接在终端里运行 claude,进程属于这个终端,关掉终端它就结束了。而 agent view 里列出的会话都叫后台会话,由一个叫 supervisor 的后台服务托管,所以关掉窗口后还能继续跑。/status 的 Session kind 一行会区分:后台会话显示 background job · attached 或 background job · unattended,其他会话显示 interactive。

这个区别正是问题来源。supervisor 只在第一次把会话转入后台或打开 agent view 时启动,之后每个会话都是它自己的 Claude Code 进程,由 supervisor 派生。你在某个终端里 export 的变量,只存在于那个终端以及从它启动的子进程里;supervisor 当初不是从那个终端起来的,后来的会话进程就拿不到。

实例、supervisor 与会话进程各自的配置来源

来自用户的报告能看到同样的形态。GitHub 上的 #87255 记录的是 Vertex 网关:daemon 继承了完整环境,但真正跑会话的 worker 少了 ANTHROPIC_VERTEX_BASE_URL 和 CLAUDE_CODE_SKIP_VERTEX_AUTH,于是每次请求都报 Could not load the default credentials。维护者在 2026-11-14 标记它已在 2.1.251 修复。另一条 #66014 讲的是反过来的一件事:在 agent view 里来回切换,会话可能继承到别的会话的 ANTHROPIC_* 变量,把模型别名悄悄换掉。两者结论一致——后台会话的环境来源不只有你的当前终端。

只在 shell 里 export,什么时候能带过去

文档列得很具体:shell 导出的网关地址,只有在 supervisor 本身也是从导出同一网关的 shell 启动时,才会被转发给后台会话,而且只在下面四种情况:

你做的动作是否沿用 shell 导出的网关
用 ← 或 /background 把当前会话转入后台是
把新会话派发到当前所在目录是
在当前目录里附着或回复,唤醒已停止的会话是
在当前目录用 claude respawn 重启会话是
派发到别的目录、从别的目录附着唤醒、后台服务崩溃后由服务重启不保证,会停下并提示

也就是说,单机单目录的小范围使用,export 可能一直好用,问题只在换目录、重开、崩溃后重启时才出现——恰好是你最不容易留意的时候。

两个配置来源分出两条结果:settings.json 的 env 能到会话进程,只在 shell 里 export 的在一个方向上会丢

2.1.326 改了什么

官方条目写的是“后台会话在崩溃后、从另一个文件夹重开后,或后台服务本身缺少网关时丢掉 shell 导出的网关,现在会在发出任何模型请求之前停下”。

这里要克制:条目没有写旧版本会把这些请求发到哪里。能确定的是它不再带着一个缺失的网关继续跑;至于是直接失败还是落到别的认证路径,取决于当时的登录方式和版本,我不替你推断。

对使用网关的人来说,这个变化把“费用跑到你没预期的入口”变成一次可以读懂的停止,代价是要自己去补配置。这个已知错误在更早的版本里就已经有名字:No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder。在 2.1.302 之前,同样的情况下会显示 Not logged in · Please run /login,连是哪个文件夹的问题都不说。

改法:把网关写进 settings.json 的 env 块

官方建议很直接:任何需要后台会话稳定走网关的配置,放进 settings 文件的 env 块,而不是依赖 shell。同一个变量在 shell 和 settings 文件里都设置时,settings 文件里的值生效,因为它会被写进进程环境,覆盖继承来的值。

用户级文件 ~/.claude/settings.json 对所有项目生效:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.nbility.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

只影响一个项目时,写 .claude/settings.local.json,它由 Claude Code 自己创建时会保持不进 Git。不要把 Key 放进项目里被提交的 .claude/settings.json——那份文件会随仓库分发给每个克隆的人。

凭据本身还有更稳的做法。Key 会轮换或来自密码库时,用 apiKeyHelper 指向一个只往 stdout 打印 Key 的脚本,避免明文长期留在配置文件里。ANTHROPIC_AUTH_TOKEN 走 Authorization: Bearer,ANTHROPIC_API_KEY 走 x-api-key;两者的差别在 Nbility 这类兼容服务上只要选错就会得到 401,Claude Code 接入第三方 API里已经逐项讲过。

把网关写入配置、核对来源、再重启后台服务

如果你的网关配置已经在哪些文件里、能不能被后台会话读到还没把握,先别急着搬全部变量。2.1.326 同一次更新里,/status 新增了一行说明“你的 provider 或某个环境变量关闭了哪些功能”,配合 Auth token、API key 与 Base URL 几行,可以判断当前会话到底在用哪个地址和哪种凭据。改完配置后对照这几行,比看 echo $ANTHROPIC_BASE_URL 有用得多。

改完怎么确认

  1. 在一个新终端里启动 claude,运行 /status,确认 Base URL 是你配置的网关,Auth token 或 API key 一行点名的是 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY 或 apiKeyHelper。出现 Login method 且指向 claude.ai 账号,说明凭据没送到。
  2. 发一条不读文件的短消息,确认能正常回复,再接后台。
  3. 用 ← 或 /background 转入后台,打开 agent view,附着回去再发一条。
  4. 到另一个目录执行一次 claude attach 或 claude respawn <会话 ID>,再看 /status 的 Base URL 是否仍是网关。这一步最容易暴露问题,也正是旧版本会出事的路径。
  5. 需要确认后台服务本身的状态时运行 claude daemon status,它会报告 supervisor 是否可达、进程 ID、版本、socket 目录和在线会话数。

遇到这两个报错分别怎么办

No LLM gateway: opened from another folder · respawn from ~/project 的意思是:你在另一个文件夹派发、唤醒或重启了这个会话。两条路:

  • 网关在 settings 文件里:在任意目录运行 claude respawn <id> 即可,重启的会话会读取 ~/.claude/settings.json 或该项目下的 .claude/settings.local.json。
  • 网关只在终端里 export:先在该终端 cd 到提示里写的目录,再运行 claude respawn <id>;如果 supervisor 不是从这个终端起来的,还要先重启 supervisor,再重新执行。

Could not resolve authentication method 出现在派发阶段、而交互会话正常时,说明收到任务的 worker 没拿到凭据——后台会话的凭据来自 supervisor。可以这样重启它:

claude daemon stop --any --keep-workers

大约一分钟内运行 claude agents 或 claude --bg 启动新的 supervisor。如果你用的是 ANTHROPIC_API_KEY 这类环境变量而不是 /login,这条命令要在设置了该变量的终端里执行。

几个容易被忽略的边界

  • 版本对不上:claude daemon status 会提示正在运行的 supervisor 版本和当前 claude 版本不一致,这通常发生在自动更新之后。需要时运行 claude daemon stop --any 让 supervisor 换成新版本;2.1.326 的修复要生效,运行的必须是更新后的版本。
  • supervisor 自己停了:在 macOS 和 Linux 上,如果 supervisor 被外部结束,会话大约一分钟后停止,保存的对话还在磁盘上,重新附着即可恢复。
  • 想彻底不用后台:设置 disableAgentView: true 或 CLAUDE_CODE_DISABLE_AGENT_VIEW。有会话一直被另一个会话的 provider 环境带偏时,这是最省事的隔离办法;#66014 里也有人这么做。
  • 云厂商网关:如果你不用 ANTHROPIC_BASE_URL,而是通过 CLAUDE_CODE_USE_VERTEX 加 ANTHROPIC_VERTEX_BASE_URL、CLAUDE_CODE_SKIP_VERTEX_AUTH 走云厂商前面的网关,它们会被当作一对转发;但 shell 里残留的变量同样可以用 env 块里的空字符串覆盖,例如 "CLAUDE_CODE_USE_VERTEX": "",Claude Code 会当作未设置。
  • 非必需流量:网关只承载模型请求。连接网关的文档说明版本检查、遥测等项目会发往别处;网络只允许出网关时,在同一个 env 块里加上 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC。

对用 Nbility 跑后台任务的人来说

把 ANTHROPIC_BASE_URL 指向 https://api.nbility.ai 时,后台会话能不能拿到这个地址,直接决定你的用量记在哪个账号上。放进 env 块的含义是:从哪个目录派发、会话被重启几次,路由都一样。这比在每个终端里重复 export 稳,也省掉了“这台机器忘了 source 哪个 profile”的排查。

需要连回国内网络时,先把网络层和配置层分开查,把 Claude Code 带回国列的是另一条路径;本文只处理网关地址为什么没送到后台会话。

FAQ

升级到 2.1.326 后一定要改成 settings.json 吗? 不是。只在一个目录里交互使用,shell export 仍然有效。经常派发到其他目录、经常让会话在后台跑,才值得搬进 settings 文件。

shell 和 settings.json 都设了同一个变量,用哪个? 绝大多数会话用 settings 文件里的值。少数变量有例外,以 env 变量文档为准。

后台会话停在 No LLM gateway,对话会丢吗? 对话保存在磁盘上,按提示在正确目录运行 claude respawn <id> 会从保存的对话继续,不需要重跑已经完成的工作。

它会在半夜自动跑任务时悄悄花到别的账号上吗? 这次修复的作用正是让它在发请求前停下,而不是带着缺失的网关继续跑;但你仍应把网关写进配置,并定期用 /status 核对一次。

相关文章

用 Nbility 跑通你的 Agent 工作流

获取 API Key,统一接入 OpenAI 兼容模型和开发工具。

获取 API Key