---
title: Linear 编码代理，用自己的密钥，经由 Kaeso
description: Linear 的云端编码代理，现在接受自有密钥，以及支持 Anthropic Messages 或 OpenAI Responses 的任何网关。把它指向 Kaeso，会话就走您的密钥、限额、路由和请求日志。本文逐步说明。
url: https://kaeso.app/zh-CN/articles/linear-byok-through-kaeso
markdown: https://kaeso.app/zh-CN/articles/linear-byok-through-kaeso.md
language: zh-CN
alternates:
  en: https://kaeso.app/articles/linear-byok-through-kaeso.md
  de: https://kaeso.app/de/articles/linear-byok-through-kaeso.md
published: 2026-11-13
authors:
  - Kaeso Team
tags:
  - linear
  - 代理
  - byok
  - 指南
image: https://kaeso.app/articles/linear-byok-through-kaeso/cover.jpg
index: https://kaeso.app/zh-CN/llms.txt
---

# Linear 编码代理，用自己的密钥，经由 Kaeso

Linear 的云端编码代理，现在接受自有密钥，以及支持 Anthropic Messages 或 OpenAI Responses 的任何网关。把它指向 Kaeso，会话就走您的密钥、限额、路由和请求日志。本文逐步说明。

> Kaeso 的所有页面、文章和文档页面都列在 https://kaeso.app/zh-CN/llms.txt 中。

- 发布日期：2026年11月13日
- 阅读时间：7 分钟
- 作者：Kaeso Team

11 月 12 日，Linear [向自有密钥开放了云端编码代理](https://linear.app/changelog/2026-11-12-bring-your-own-key)。此前，每个会话都运行在 Linear 代为购买的模型上。现在，管理员可以连接工作区自己的 Anthropic 或 OpenAI 账号、Amazon Bedrock，或一个自定义端点：任何支持 Anthropic Messages API 或 OpenAI Responses API 的网关。

Kaeso 两种都支持。把 Linear 指向您的实例，代理发出的每个请求都会经过您掌控的项目：按您的价格计入您的服务商密钥，受您的限额约束，由您的别名路由，并记入您的请求日志。

## 哪些变了，哪些没变

Linear 的代理 Linear Code 在沙箱中运行 Claude Code 或 Codex。自有密钥改变的是模型调用；沙箱仍由 Linear 运行。

| | 使用 Linear 额度 | 经由 Kaeso |
| --- | --- | --- |
| 模型用量 | 用 Linear AI 额度支付 | 由 Kaeso 中您的服务商密钥按您的价格支付 |
| 沙箱运行时间 | Linear AI 额度 | Linear AI 额度，不变 |
| 谁调用模型 | Linear | 您的 Kaeso 实例，使用您的服务商密钥 |
| 限额和日志 | Linear 的 | 您项目的限额、预算和请求日志 |

因此，工作区仍需 AI 额度来运行沙箱。Linear 还需要一个 API 密钥，而不是 ChatGPT 或 Claude 订阅；在 Kaeso 之后，这个密钥就是 Kaeso 密钥。Linear 当前所有套餐都提供自有密钥，只有工作区的所有者或管理员可以设置。成员无需任何改动：照常把 issue 分配给代理即可。

## 开始之前

- **一个 Linear 能访问的 Kaeso 实例。** 沙箱运行在 Linear 的云中，所以实例需要一个公开的 HTTPS 地址，例如 `https://kaeso.example.com`。笔记本电脑上或 VPN 后面的实例不行。[在哪里运行 Kaeso](https://kaeso.app/zh-CN/articles/where-to-run-kaeso) 可帮助您选择。
- **一个供代理使用的项目，** 其目录中有代理要用的模型，并配有相应的服务商密钥。单独的项目能让代理的花费、限额和日志与您的应用分开。
- **Linear 的管理员权限，** 并已在 **Settings › AI & agents** 下开启云端编码代理 Linear Code。

## 1. 为 Linear 创建密钥

在 Kaeso 控制台中打开项目，选择 **API 密钥 › 创建密钥**。起一个便于找到 Linear 请求的名称，例如 `linear-agent`。由项目的服务账号而不是个人持有更好，这样即使有人离开团队，密钥仍然有效。

在**模型和限额**中，选择代理可调用的模型，并设置按天或按月的 Token 预算（[限额和预算](https://docs.kaeso.app/zh-CN/console/limits-and-budgets)）。复制密钥：Kaeso 只显示一次。

这里请用 Token 预算，而不是支出预算。Kaeso 按 token 为请求计价，无法为服务商按次计费的服务端工具（例如网页搜索）计价。只要有支出预算覆盖某个请求，Kaeso 就会拒绝使用此类工具的请求，而编码代理会搜索网页。Token 预算会放行这些请求。

## 2. 在 Linear 中连接 Kaeso

在 Linear 中打开 **Settings › Linear Code**。在 **Agent configuration** 下，**Agent** 选择驱动 Linear Code 的代理，例如 Claude Code，**Model** 选择它运行的模型。下方的 **Inference** 有两行，每行说明由谁运行并支付一类模型：

| 行 | 适用于 | 所需的 Kaeso 端点 |
| --- | --- | --- |
| **Anthropic** | Claude 模型 | Anthropic Messages，`POST /v1/messages` |
| **OpenAI** | OpenAI 模型 | OpenAI Responses，`POST /v1/responses` |

两行默认都是 **Linear credits**，每个连接由整个工作区共享。连接代理所用模型对应的那一行，或两行都连接。

**Claude 模型**，在 **Anthropic** 行中：

1. 打开显示 **Linear credits** 的菜单，选择 **API key**。随后打开 **Add API key**。
2. 在 **Provider** 下选择 **Custom endpoint**。
3. **Endpoint URL**：实例的地址，不带路径，与占位符 `https://api.anthropic.com` 的写法一致。代理会自行加上 `/v1/messages`。
4. **API key**：第 1 步中的 Kaeso 密钥。
5. 选择 **Test connection**，然后选择 **Save**。

```text
Endpoint URL   https://kaeso.example.com
API key        sk-kso-…
```

**OpenAI 模型**，在 **OpenAI** 行中照此操作，地址加上 `/v1`，与 OpenAI 自己的 SDK 的写法一致。代理会加上 `/responses`。可以用同一个 Kaeso 密钥；如果想分开查看每类模型的用量，也可以用第二个。

```text
Endpoint URL   https://kaeso.example.com/v1
API key        sk-kso-…
```

如果 **Test connection** 返回 404，说明 Linear 拼接路径的方式与您填写的不同：加上或去掉 `/v1`。401 表示密钥错误或已过期，403 表示它没有模型调用权限。如果取消对话框，该行的模型仍使用 Linear 额度。

新会话使用其模型对应的连接，包括 Loop 启动的会话。正在运行的会话保留开始时的服务商；只要某行上的会话可能继续，就请在该行保留有效的密钥。

## 3. 检查第一个会话

把一个 issue 分配给代理，然后在 Kaeso 中打开项目的**请求日志**。按密钥 `linear-agent` 筛选：会话的每一轮都是一条请求，带有模型、token、费用和耗时。Kaeso 也会记录它拒绝的请求及其请求内容，因此会话一开始就失败时，您能看到原因。

日志还会显示 Linear 发送的确切模型 ID。Linear 在 **Model** 下选择模型，除非您另选（例如 Claude Opus 5.5 或 GPT-6 Sol），否则为 **Auto**。在 **Auto** 下，会话可能请求另一类模型，因此请连接两行，或选择一个其所在行已连接的模型。代理请求的每个 ID 都必须在项目目录中，并且密钥被允许调用；否则 Kaeso 返回 404，会话随之结束。会话这样失败时，日志中被拒绝的请求会写明需要添加的 ID。

## 4. 为代理的模型设置路由

Linear 发送固定的模型 ID，由 Kaeso 决定由谁响应。[别名](https://docs.kaeso.app/zh-CN/console/models-and-aliases)优先于同名模型，所以您可以创建一个与 Linear 所请求模型同名的别名，列表会将其标记为**遮蔽同名模型**。然后为它设置路由：

- **回退链。** 当 Anthropic 的 API 过载或某个密钥余额用完时，由下一步响应，例如提供同一模型的另一家服务商。Kaeso 会记住因持久原因失败的步骤，并在后续请求中跳过它，这样长会话不会每一轮都等待已失效的服务商（[别名路由](https://docs.kaeso.app/zh-CN/concepts/alias-routes)）。
- **另一家服务商的模型。** Kaeso 在格式之间转换，包括流式输出和工具调用，因此代理请求的别名可以由目录中的另一个模型响应（[格式转换](https://docs.kaeso.app/zh-CN/concepts/format-translation)）。依赖这样的路由之前，请先用真实的 issue 测试：编码代理比大多数应用更依赖模型的工具调用能力。
- **分流。** 把一部分会话发给第二个模型，在您自己的 issue 上比较两者，以请求日志为记录。

修改路由，从下一个请求起生效。无需再改动 Linear 的设置。

## 切换回去

要离开 Kaeso，把 **Inference** 中的该行改回 **Linear credits**，或替换其密钥。新会话随后使用 Linear 的模型；在 Kaeso 上开始的会话仍需 Kaeso 密钥才能继续。要立即切断代理，请在 Kaeso 的 **API 密钥**下停用该密钥。

## 了解更多

- [编码工具](https://docs.kaeso.app/zh-CN/get-started/coding-tools)：在您自己的电脑上让 Claude Code 和 Codex 使用 Kaeso，基础 URL 相同。
- [Linear cloud coding agent](https://linear.app/docs/linear-cloud-coding-agent)：Linear 自己的文档，包括套餐、计费和环境。
- [别名路由](https://kaeso.app/zh-CN/articles/alias-routes)：Kaeso 路由编辑器中的回退、条件和分流。

作者：Kaeso Team

## 更多文章

- [Kaeso 0.6：聊天与媒体走同一网关，另有别名路由、MCP 门户](https://kaeso.app/zh-CN/articles/kaeso-0-6.md)：Kaeso 0.6.0 已发布。图片、语音和视频，现在与聊天走同一网关；Gemini 应用，也能从 /v1beta 接入；别名变为路由，可回退、可分流；每个项目都有 MCP 门户。本文介绍改了什么，以及如何更新。
- [推出 MCP 门户](https://kaeso.app/zh-CN/articles/mcp-portal.md)：每个 Kaeso 项目，现在都有 MCP 门户。组织的 MCP 服务器，只需连接一次，再为每个项目选好工具。claude.ai、ChatGPT、Cursor 和您的智能体，都能调用这些工具，并使用 Kaeso 的登录、权限、限额和日志。

[查看所有文章](https://kaeso.app/zh-CN/articles.md)

## 网关归您。记录也归您

```bash
curl -fsSL https://kaeso.app/install.sh | sh
```

[安装 Kaeso](https://docs.kaeso.app/zh-CN/self-hosting/installation) · [打开在线演示](https://demo.kaeso.app)
