Linear 编码代理,用自己的密钥,经由 Kaeso
Linear 的云端编码代理,现在接受自有密钥,以及支持 Anthropic Messages 或 OpenAI Responses 的任何网关。把它指向 Kaeso,会话就走您的密钥、限额、路由和请求日志。本文逐步说明。
- 发布日期
- 阅读时间
- 7 分钟
- 作者
- Kaeso Team

11 月 12 日,Linear 向自有密钥开放了云端编码代理(在新标签页中打开)。此前,每个会话都运行在 Linear 代为购买的模型上。现在,管理员可以连接工作区自己的 Anthropic 或 OpenAI 账号、Amazon Bedrock,或一个自定义端点:任何支持 Anthropic Messages API 或 OpenAI Responses API 的网关。
Kaeso 两种都支持。把 Linear 指向您的实例,代理发出的每个请求都会经过您掌控的项目:按您的价格计入您的服务商密钥,受您的限额约束,由您的别名路由,并记入您的请求日志。
哪些变了,哪些没变01
Linear 的代理 Linear Code 在沙箱中运行 Claude Code 或 Codex。自有密钥改变的是模型调用;沙箱仍由 Linear 运行。
- 模型用量
- 使用 Linear 额度
- 用 Linear AI 额度支付
- 经由 Kaeso
- 由 Kaeso 中您的服务商密钥按您的价格支付
- 沙箱运行时间
- 使用 Linear 额度
- Linear AI 额度
- 经由 Kaeso
- Linear AI 额度,不变
- 谁调用模型
- 使用 Linear 额度
- Linear
- 经由 Kaeso
- 您的 Kaeso 实例,使用您的服务商密钥
- 限额和日志
- 使用 Linear 额度
- Linear 的
- 经由 Kaeso
- 您项目的限额、预算和请求日志
| 使用 Linear 额度 | 经由 Kaeso | |
|---|---|---|
| 模型用量 | 用 Linear AI 额度支付 | 由 Kaeso 中您的服务商密钥按您的价格支付 |
| 沙箱运行时间 | Linear AI 额度 | Linear AI 额度,不变 |
| 谁调用模型 | Linear | 您的 Kaeso 实例,使用您的服务商密钥 |
| 限额和日志 | Linear 的 | 您项目的限额、预算和请求日志 |
因此,工作区仍需 AI 额度来运行沙箱。Linear 还需要一个 API 密钥,而不是 ChatGPT 或 Claude 订阅;在 Kaeso 之后,这个密钥就是 Kaeso 密钥。Linear 当前所有套餐都提供自有密钥,只有工作区的所有者或管理员可以设置。成员无需任何改动:照常把 issue 分配给代理即可。
开始之前02
- 一个 Linear 能访问的 Kaeso 实例。 沙箱运行在 Linear 的云中,所以实例需要一个公开的 HTTPS 地址,例如
https://kaeso.example.com。笔记本电脑上或 VPN 后面的实例不行。在哪里运行 Kaeso 可帮助您选择。 - 一个供代理使用的项目, 其目录中有代理要用的模型,并配有相应的服务商密钥。单独的项目能让代理的花费、限额和日志与您的应用分开。
- Linear 的管理员权限, 并已在 Settings › AI & agents 下开启云端编码代理 Linear Code。
1. 为 Linear 创建密钥03
在 Kaeso 控制台中打开项目,选择 API 密钥 › 创建密钥。起一个便于找到 Linear 请求的名称,例如 linear-agent。由项目的服务账号而不是个人持有更好,这样即使有人离开团队,密钥仍然有效。
在模型和限额中,选择代理可调用的模型,并设置按天或按月的 Token 预算(限额和预算(在新标签页中打开))。复制密钥:Kaeso 只显示一次。
这里请用 Token 预算,而不是支出预算。Kaeso 按 token 为请求计价,无法为服务商按次计费的服务端工具(例如网页搜索)计价。只要有支出预算覆盖某个请求,Kaeso 就会拒绝使用此类工具的请求,而编码代理会搜索网页。Token 预算会放行这些请求。
2. 在 Linear 中连接 Kaeso04
在 Linear 中打开 Settings › Linear Code。在 Agent configuration 下,Agent 选择驱动 Linear Code 的代理,例如 Claude Code,Model 选择它运行的模型。下方的 Inference 有两行,每行说明由谁运行并支付一类模型:
- Anthropic
- 适用于
- Claude 模型
- 所需的 Kaeso 端点
- Anthropic Messages,
POST /v1/messages
- OpenAI
- 适用于
- OpenAI 模型
- 所需的 Kaeso 端点
- OpenAI Responses,
POST /v1/responses
| 行 | 适用于 | 所需的 Kaeso 端点 |
|---|---|---|
| Anthropic | Claude 模型 | Anthropic Messages,POST /v1/messages |
| OpenAI | OpenAI 模型 | OpenAI Responses,POST /v1/responses |
两行默认都是 Linear credits,每个连接由整个工作区共享。连接代理所用模型对应的那一行,或两行都连接。
Claude 模型,在 Anthropic 行中:
- 01打开显示 Linear credits 的菜单,选择 API key。随后打开 Add API key。
- 02在 Provider 下选择 Custom endpoint。
- 03Endpoint URL:实例的地址,不带路径,与占位符
https://api.anthropic.com的写法一致。代理会自行加上/v1/messages。 - 04API key:第 1 步中的 Kaeso 密钥。
- 05选择 Test connection,然后选择 Save。
Endpoint URL https://kaeso.example.comAPI key sk-kso-…OpenAI 模型,在 OpenAI 行中照此操作,地址加上 /v1,与 OpenAI 自己的 SDK 的写法一致。代理会加上 /responses。可以用同一个 Kaeso 密钥;如果想分开查看每类模型的用量,也可以用第二个。
Endpoint URL https://kaeso.example.com/v1API key sk-kso-…如果 Test connection 返回 404,说明 Linear 拼接路径的方式与您填写的不同:加上或去掉 /v1。401 表示密钥错误或已过期,403 表示它没有模型调用权限。如果取消对话框,该行的模型仍使用 Linear 额度。
新会话使用其模型对应的连接,包括 Loop 启动的会话。正在运行的会话保留开始时的服务商;只要某行上的会话可能继续,就请在该行保留有效的密钥。
3. 检查第一个会话05
把一个 issue 分配给代理,然后在 Kaeso 中打开项目的请求日志。按密钥 linear-agent 筛选:会话的每一轮都是一条请求,带有模型、token、费用和耗时。Kaeso 也会记录它拒绝的请求及其请求内容,因此会话一开始就失败时,您能看到原因。
日志还会显示 Linear 发送的确切模型 ID。Linear 在 Model 下选择模型,除非您另选(例如 Claude Opus 5.5 或 GPT-6 Sol),否则为 Auto。在 Auto 下,会话可能请求另一类模型,因此请连接两行,或选择一个其所在行已连接的模型。代理请求的每个 ID 都必须在项目目录中,并且密钥被允许调用;否则 Kaeso 返回 404,会话随之结束。会话这样失败时,日志中被拒绝的请求会写明需要添加的 ID。
4. 为代理的模型设置路由06
Linear 发送固定的模型 ID,由 Kaeso 决定由谁响应。别名(在新标签页中打开)优先于同名模型,所以您可以创建一个与 Linear 所请求模型同名的别名,列表会将其标记为遮蔽同名模型。然后为它设置路由:
- 回退链。 当 Anthropic 的 API 过载或某个密钥余额用完时,由下一步响应,例如提供同一模型的另一家服务商。Kaeso 会记住因持久原因失败的步骤,并在后续请求中跳过它,这样长会话不会每一轮都等待已失效的服务商(别名路由(在新标签页中打开))。
- 另一家服务商的模型。 Kaeso 在格式之间转换,包括流式输出和工具调用,因此代理请求的别名可以由目录中的另一个模型响应(格式转换(在新标签页中打开))。依赖这样的路由之前,请先用真实的 issue 测试:编码代理比大多数应用更依赖模型的工具调用能力。
- 分流。 把一部分会话发给第二个模型,在您自己的 issue 上比较两者,以请求日志为记录。
修改路由,从下一个请求起生效。无需再改动 Linear 的设置。
切换回去07
要离开 Kaeso,把 Inference 中的该行改回 Linear credits,或替换其密钥。新会话随后使用 Linear 的模型;在 Kaeso 上开始的会话仍需 Kaeso 密钥才能继续。要立即切断代理,请在 Kaeso 的 API 密钥下停用该密钥。
了解更多08
- 编码工具(在新标签页中打开):在您自己的电脑上让 Claude Code 和 Codex 使用 Kaeso,基础 URL 相同。
- Linear cloud coding agent(在新标签页中打开):Linear 自己的文档,包括套餐、计费和环境。
- 别名路由:Kaeso 路由编辑器中的回退、条件和分流。
作者:Kaeso Team


