Orca 的第三方端点与密钥：各自写在 agent 那边
官方文档写它能跑任何在终端里运行的 CLI 智能体，下拉框只是在终端起一个进程；端点与密钥因此要写进每个 agent 自己认的那份配置。这一页把 11 行表逐个摆开：官方写了字段名的原样抄，官方没写的（Cursor CLI 的第三方端点）就如实标未写。走 Anthropic 协议的一族改端点环境变量，走 OpenAI 兼容的一族填 base_url、密钥与型号，两族的坑不在同一处（核于 2026-09-22）。
更新于 2026-09-22
这张表先说清 4 件事
有官方逐字原句的行
本页把 11 个 CLI 智能体逐行排开，每行只抄那个 agent 官方文档写的配置位置与字段名，并附出处。截至 2026-09-22，其中 10 行能在各家官方文档里逐字找到自定义端点或自带 key 的句子，Cursor CLI 那一行官方文档未写。每个 agent 单占一行，官方没说的也不替它补。
Anthropic 协议族与 OpenAI 兼容族
一族走 Anthropic Messages：Claude Code 把端点写在 ANTHROPIC_BASE_URL，官方对这一项的说明就是让请求改走代理或网关，凭据再按对方要求的那类头选 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY。官方也写明它不审计第三方网关产品，不支持把 Claude Code 指向非 Claude 模型。另一族走 OpenAI 兼容：base_url、key、model id 写在该 agent 自己的全局配置或设置面板里。核于 2026-09-22。
agent picker、Settings 的启动参数、worker-start
这 3 个开关没有一个会替你改端点。内置 agent 选择器只是在终端里把那个 CLI 起起来，深度集成逐家另标。Settings 里能给单个 agent 覆写默认启动参数与环境变量，官方写明覆写过的 agent 它不再动。orca orchestration worker-start 的 --model 官方只写了这 3 家，且要先在 Settings → Experimental 打开。官方自陈命令行参数随应用演进，所以这些写法只在核于 2026-09-22 这天成立。
Cursor CLI：官方文档未写第三方端点
Cursor CLI 官方只写 2 种登录：浏览器登录，或在 Cursor 自己的后台生成用户 API key、再交给 CURSOR_API_KEY。核于 2026-09-22 的 CLI 配置文档里，与网络有关的是代理与 HTTP/1.1 那几项，没有通用 base_url；自带凭据它只写了 AWS Bedrock，官方对它的定性是走你自己的 AWS 账号，不是任意 OpenAI 兼容端点。所以这一行照官方写「未写」，不等于「官方说不支持」。
读表前先分清 3 层
端点层：每个 CLI 智能体只读自己那份配置。Anthropic 那一族靠环境变量改地址，OpenAI 兼容那一族在配置文件或设置面板里填 base URL、key 和 model id，字段名以各家官方文档为准。凭据层：key 由模型 provider 或网关发给你，落在各家官方文档指名的位置：环境变量名、配置文件字段或设置面板的输入框。编排层：Orca 官方对内置选择器的说法是 the agent combobox just launches a process in a terminal，它自陈提供的是 worktree、终端分栏、评审流与会话管理。所以「在 Orca 里贴第三方 key」实际是逐个改这 11 行 agent 自己的配置。本页字段名与出处核于 2026-09-22。
这张表为什么要挂日期
到 2026-09-22 这次核对为止，把端点指向第三方已不是社区偏方，而是各家文档里的一等功能：Droid 的 BYOK 页写 Use your own OpenAI or Anthropic keys；Qwen Code 在 OpenAI 兼容那条下点名 OpenRouter 与 Requesty；OpenCode 写任意 provider 都能设 baseURL，并举代理服务与自建端点为例；Codex 的 config schema 把 base_url 定义成该 provider 的 OpenAI 兼容 API 地址；Grok CLI 的自定义模型指南开头就是连接替代 provider 与自建端点。变化也有反向的：Roo Code 官方停服页写所有产品在 2026-05-15 关停，它那行的写法照旧，但只能当历史读。各家更新节奏不同（OpenCode 页脚自报 2026-09-21，Roo Code 那页自报 2026-05-15），所以本页不借它们的日期，只挂这次核对日 2026-09-22。
文档核对时间线
Roo Code 的关停日与关停范围这里不写：官方页这次没取到可逐字引用的原句，站内也没验过（核于 2026-09-22）。它那一行仍照官方文档抄，但只能当历史读。
2026-09-21：OpenCode 官方 Providers 文档页脚标的最后更新日；同页写明任意 provider 的 baseURL 可以指向代理服务或自建端点。本页不逐家跟官方页自署的日期，只统一挂自己的核对日。
2026-09-22：本页逐行重取 11 个 agent 的官方端点文档与 Orca 官方文档，路径与字段名按官方原样写，每行留出处；Cursor CLI 记为官方文档未写，而不是官方不支持。Orca 自陈命令行参数随应用演进，所以那张表只在这天成立。
官方写了 vs 官方没写
官方逐字写了的
这 11 行里有 10 行的写法能在对应 agent 的官方文档里逐字对上：Claude Code 是 ANTHROPIC_BASE_URL 加 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY；Codex 是 model_providers 段的 base_url 与 env_key；OpenCode 与 Kilo Code 各自页面上的 options.baseURL；Cline 与 Roo Code 是设置面板里的 API Provider、Base URL、API Key 与 Model，两页都没给配置文件路径；Qwen Code 是 settings.json 中 modelProviders 的 baseUrl 与 envKey；Kimi Code 是 openai 项下的 base_url；Droid 是 ~/.factory/settings.json 里 customModels 的 model、baseUrl、apiKey。Grok CLI 是 ~/.grok/config.toml 里的 base_url 与 env_key。Orca 侧另有 3 句官方原句支撑本页：内置选择器只是在终端里起一个进程；单个 agent 的启动参数与环境可在 Settings 覆写；--model 官方只写对 Claude、Codex、Cursor 生效。核于 2026-09-22。
⚠️ 表格没说的 3 件事
第 1 件：Cursor CLI 那行写的是「官方文档未写」，不是「官方说不支持」。2026-09-22 扫它 CLI 文档全部 15 页，base_url、baseUrl、OPENAI_BASE_URL、ANTHROPIC_BASE_URL 4 类字段名 0 命中，官方的 CURSOR_ 开头环境变量只有 4 个；认证页只写浏览器登录与在 Cursor 后台生成的用户 API key，自带凭据只写了 AWS Bedrock 一条。第 2 件：「支持自定义端点」不等于「接哪个端点都能跑」。Droid 官方自己写 we cannot guarantee that all custom models will work out of the box；Anthropic 官方写明它不背书、不维护、不审计第三方网关产品，也不支持把 Claude Code 指向非 Claude 模型。第 3 件：别把整张表当成同时有效——Roo Code 停服页写所有产品 2026-05-15 关停，OpenCode 的 provider 页自报 2026-09-21。本页只保证 2026-09-22 这一天的对应关系。
2 族写法的相同与不同
2 族相同的地方
2 族做的其实是同一件事：让那个 agent 的推理请求不发往厂商第一方域名。改的位置都在 agent 自己的配置里，需要的也是同 3 样：端点、key、model id。Orca 这一层对 2 族一样：官方说内置选择器只是在终端里起一个进程，那个 agent 的默认启动参数与环境变量可以在 Settings 里单独覆写，覆写过的 agent 官方写明它不再动。核于 2026-09-22。
2 族不同的地方与坑
坑的位置不同。走 Anthropic Messages 这族的 Claude Code 改环境变量或 settings.json 的 env 块，官方写明 shell 导出与该块设置同一变量时以文件里的值为准；也写明非第一方 host 时 MCP tool search 默认关闭、host 不是 api.anthropic.com 时 Remote Control 被禁用，并声明它不背书、不维护、不审计第三方网关产品，端点须提供 /v1/messages 且原样转发 anthropic-beta 与 anthropic-version 头。OpenAI 兼容那族的坑是拼写不通用：Codex、Kimi Code 写 base_url，OpenCode、Kilo Code 写 options.baseURL，Qwen Code、Droid 写 baseUrl；key 有的填值（Cline、Roo Code 的面板），有的只填环境变量名（Codex 的 env_key、Qwen Code 的 envKey、Grok CLI 的 env_key）。核于 2026-09-22。
3 步：定协议族、写进官方位置、验证一次
第 1 步，定协议族。Anthropic Messages 这一族靠变量：Claude Code 把端点写进 ANTHROPIC_BASE_URL，官方对这一项的说明就是让请求改走代理或网关。其余各家走 OpenAI 兼容族：base_url、key、model id 写在该 agent 自己的配置里。第 2 步，写在官方给的位置。文件类：Claude Code 的 settings.json 里的 env 块、Codex 的 ~/.codex/config.toml 里自定名的 model_providers 段。面板类：Cline 与 Roo Code 都在设置面板里把 API Provider 选成 OpenAI Compatible，再填 Base URL、API Key、Model。第 3 步，跑一次最小请求。回到 Orca 的 Settings 给这个 agent 覆写启动参数或环境变量，官方写明覆写过的 agent 它不再动；该 agent 自己有自检命令的就用它，例如 Grok 官方写改完 ~/.grok/config.toml 之后跑 grok inspect（各句核于 2026-09-22）。
那把 key 从哪儿进来
Orca 不代理模型，也不替你保管凭据：官方 first-session 页写它会用正确的工作目录启动那个 agent 的 CLI，并把你的订阅凭据转发过去。所以端点与 key 都在被启动的那个 CLI 自己的配置里改，那把 key 可以是 QCode 的 —— 这是本页唯一的桥。本站不写 Orca 已支持 QCode，也不写接上就能跑：Anthropic 官方对网关的定性是不背书、不维护、不审计第三方网关产品，也不支持把 Claude Code 指向非 Claude 模型；它文档点名的例子是 LiteLLM、Kong 与内部代理这一类，没有本站。这一族指向非第一方宿主时有 2 处官方写明的行为变化，与那 2 个变量的用法都在 /anthropic-base-url-setup-guide，这里不重复；按 key 看聚合侧的账在 /api-key-usage-query-guide（核于 2026-09-22）。
常见问题
同一台机器上能让几个 agent 各用各的 key 吗
能，因为它们本来就不共用一份配置。Orca 官方 supported 页写 agent 下拉框只是在一个终端里起一个进程，端点与凭据归被拉起的那个 CLI 自己读：Claude Code 读 settings.json 的 env 块与那 2 个环境变量，Codex 读 ~/.codex/config.toml，Droid 读 ~/.factory/settings.json 里的 customModels 条目，Qwen Code 读 ~/.qwen/settings.json，Cline 与 Roo Code 读各自设置面板里的填法。Claude Code 一侧官方还写了一句判据：网关凭据变量优先于已保存的 claude.ai 登录或 Console key，也就是自带 key 会顶掉订阅登录。Cursor CLI 是反面例子：官方只给浏览器登录与 API key，而那把 key 出自 Cursor 自己的后台。核于 2026-09-22。
为什么 Orca 的用量条看不到我接的那家网关
因为它不去问厂商。官方 usage-tracking 页的原句是 Orca reads the local usage state each agent maintains on disk，后面紧跟 No API calls, no extra auth.；同一页还说数字只在 agent 自己写盘时更新、不是实时。该页点名的覆盖范围是 Claude Code、Codex、Gemini、OpenCode、Kimi Code、MiniMax 这 6 家。把端点指向第三方网关之后这条读数还准不准，官方文档未写，本页不替它推断。聚合侧的账要到 key 提供方那边去看（核于 2026-09-22）。
orca 的 --model 为什么对有些 agent 没反应
因为官方只把它写给 3 家。orchestration 文档原句是 --model accepts opaque provider model IDs for Claude, Codex, and Cursor.，同一句还要求 --effort 必须与 --model 一起用，并且只有那个 agent 与那个型号支持这一档时才生效。这套命令本身要先在 Settings → Experimental 里打开。换端点、换型号在其余 agent 上要回到它自己的配置里做，也就是本页那张 11 行的表。Orca 自陈 Command flags evolve with the app，所以这些形态只在核于 2026-09-22 这天成立。
改过端点后，Orca 更新会不会把我的配置覆盖掉
分两层。Orca 侧官方写的是启动参数与环境变量：新启动时它会给每个受支持的 CLI 预填权限跳过 flag，而你在设置里对某个 agent 覆写过之后，官方原句是 Orca leaves that agent alone，并补一句非空自定义值算显式覆写、该 agent 从此退出后续的权限模式迁移。官方没说你的 agent 配置文件会不会被哪次更新改写，也没有「更新永远不动配置」这种总保证，能引的就上面那两句。真正会漂的是各家文档里的字段名与路径：端点写在你的用户级文件里，升级 Orca 与升级那个 CLI 是两件事（核于 2026-09-22）。
端点写错了怎么定位
先看 base_url 的形态：Qwen 官方写指向自建网关时 baseUrl 填 API 的 /v1 根，例 https://gateway.example.com/v1，不是整条 /v1/chat/completions，请求路径由 SDK 自己拼。再看协议族对不对：Claude Code 的 Anthropic Messages 格式要求端点把 anthropic-beta 与 anthropic-version 两个头原样转发。然后确认配置有没有被读到：Grok 官方写改完 ~/.grok/config.toml 之后用 grok inspect 看这个目录发现了什么。最后核凭据填的是哪一类：Claude Code 的官方判据是对方说要 bearer token 或 Authorization header 就填 ANTHROPIC_AUTH_TOKEN、说要 API key 或 x-api-key 就填 ANTHROPIC_API_KEY；shell 里的 export 与 settings.json 的 env 块同名时，官方以文件里那份为准（核于 2026-09-22）。
这些 key 到底存在哪个文件里
各家不同，而且分文件与设置面板两类。Claude Code 官方让你写进 settings.json 的 env 块，同时警告不要把凭据放进项目里的 .claude/settings.json，那个文件会随仓库提交给所有克隆它的人。Codex 官方 schema 里 env_key 存的是环境变量名而不是 key 本身，另一种直接放 key 的写法官方注明出于安全不推荐。Kilo 官方写环境变量引用只在受信位置解析，仓库里那份项目配置解不出来，结论是 Keep provider credentials in your global config.。OpenCode 用 /connect 把凭据落到 ~/.local/share/opencode/auth.json。Cline 与 Roo Code 是设置面板里的 API Key 输入框。Grok 官方也写 Prefer env_key over hardcoding api_key.。Orca 自己不存这些凭据，它只负责把那个 CLI 起起来（核于 2026-09-22）。
信息来源
Orca 官方：https://raw.githubusercontent.com/stablyai/orca/main/docs/site/content/docs/ 下的 agents/supported、agents/usage-tracking、cli/orchestration、first-session，渲染版在 https://www.onorca.dev/docs。各 agent 官方：code.claude.com/docs/en/env-vars 与同站的 llm-gateway、llm-gateway-connect、llm-gateway-protocol；raw.githubusercontent.com/openai/codex/main/codex-rs/core/config.schema.json；opencode.ai/docs/providers/；docs.cline.bot/provider-config/openai-compatible；docs.roocode.com/providers/openai-compatible 与同站的 sunset；kilo.ai/docs/code-with-ai/agents/custom-models；github.com/QwenLM/qwen-code/blob/main/docs/users/configuration/auth.md；docs.factory.ai/model-independence/byok.md；cursor.com/docs/cli/reference/authentication；docs.x.ai/build/overview 与 build/settings/reference。全部核于 2026-09-22；某家官方页自署更早日期时，引的是那页当天的内容。
相关阅读
Orca 智能体开发环境指南
它是什么与不是什么、支持哪些 CLI 智能体、装法与同名提醒都在那页。
Claude Code 自定义端点配置
那 2 个变量的写法与 settings.json 的 env 块，连非第一方宿主下的 2 处行为变化都在那页。
API Key 用量查询接口
编排器看不见聚合侧的账时，用只读 Token 按 key 查自己的用量与到期。
本页转述 Orca 与那张表里各 CLI 智能体厂商公开写的文档，与 Stably、Orca 以及各厂商无隶属关系，也没拿到任何背书。文件路径、字段名、命令形态只以 2026-09-22 抓到的官方页面为限，各家文档自己会改，Orca 也自陈命令参数随应用演进；Roo Code 官方写 2026-05-15 全线关停，它那一行只当历史读。QCode 只是那把 key 的一个可能提供方，不对第三方网关做兼容性判断，也不对 Orca 或任何 CLI 智能体的行为负责。