Continue 怎么配置 OpenAI API：从 API Key 到模型调用
简答：在 Continue 中配置 OpenAI API，打开 config.yaml，在 models 下添加 provider: openai、model、apiKey；如果使用 OpenAI 兼容接口，再填写 apiBase，并将地址设置为服务商提供的 API 根路径，保存后在 Continue 配置选择器中重新加载配置。
定义：Continue 的 OpenAI 配置，是通过 config.yaml 中的 provider、model、apiKey 和可选的 apiBase 字段，把 Continue 的代码助手请求连接到 OpenAI 或兼容 OpenAI API 格式的服务。
一、先确认 Continue 配置方式
Continue 当前推荐使用 config.yaml 管理模型。官方配置示例使用 provider: openai 指定 OpenAI 提供商，使用 model 指定模型名称，使用 apiKey 传入密钥；如果连接的是 OpenAI 兼容接口，则增加 apiBase 覆盖默认 API 地址。详细字段可参考 Continue 的 OpenAI 配置文档 和 Continue config.yaml 参考。
这里的“OpenAI API”包括两种情况：第一种是直接连接 OpenAI API，此时通常不需要填写 apiBase；第二种是连接其他兼容 OpenAI 请求格式的 API 服务，此时需要填写对方提供的 API 根地址。Continue 官方文档明确支持通过 apiBase 指向兼容服务。
如果你看到旧教程使用 config.json，需要注意 Continue 官方已将 JSON 配置标记为旧版参考，新的配置建议优先采用 YAML 格式。
二、直接配置 OpenAI API 的最小示例
如果你使用的是 OpenAI API，可以先在 Continue 的配置文件中加入下面的最小配置。将 YOUR_OPENAI_API_KEY 替换为你自己的密钥，并把 gpt-5.1 换成账号当前可用的模型 ID。模型名称必须与 API 实际支持的名称一致，不能只根据显示名称猜测。
name: OpenAI Config
version: 0.0.1
schema: v1
models:
- name: OpenAI Coding Model
provider: openai
model: gpt-5.1
apiKey: YOUR_OPENAI_API_KEY
roles:
- chat
- edit
- apply
Continue 官方模型配置页面说明，添加模型后还需要在 IDE 扩展的配置选择器中重新加载配置。若配置文件保存成功但界面仍显示旧模型，先执行 Reload config，再重新发起一次对话。
三、使用 OpenAI 兼容接口时怎么写
如果你的接口不是 OpenAI 官方地址，而是一个兼容 OpenAI API 格式的服务，核心是把 provider 保持为 openai，再填写服务端提供的 apiBase。Continue 官方示例使用类似 http://localhost:8000/v1 的地址。
name: Compatible API Config
version: 0.0.1
schema: v1
models:
- name: Compatible Coding Model
provider: openai
model: YOUR_MODEL_ID
apiBase: https://api.example.com/v1
apiKey: YOUR_API_KEY
roles:
- chat
- edit
- apply
apiBase 怎么填：应以接口服务商的官方说明为准。通常它应当是 API 根地址，并可能包含 /v1；不要把完整的聊天接口路径，例如 /chat/completions，直接填到 apiBase，除非对方文档明确要求这样填写。
model 怎么填：填写服务端真实接受的模型 ID，而不是 Continue 中自定义的显示名称。比如 name 可以写成“我的代码模型”，但 model 必须写服务端识别的模型标识。
apiKey 是否必填：如果接口要求鉴权，就必须提供 API Key；如果是本地服务且不要求鉴权，可以根据服务端要求省略或填写占位值。具体以接口本身的鉴权规则为准。
四、推荐的 API Key 安全写法
不建议把真实 API Key 长期直接写进配置文件，尤其不要把包含密钥的 config.yaml 提交到 Git 仓库、发到聊天群或复制到公开代码仓库。Continue 官方 FAQ 支持在配置中使用 ${{ secrets.SECRET_NAME }} 引用密钥。
一种更安全的写法如下：
name: Secure OpenAI Config
version: 0.0.1
schema: v1
models:
- name: OpenAI Coding Model
provider: openai
model: gpt-5.1
apiKey: ${{ secrets.OPENAI_API_KEY }}
roles:
- chat
- edit
- apply
Continue 文档列出的密钥查找位置包括工作区的 .env、工作区的 .continue/.env、用户目录下的 ~/.continue/.env，以及进程环境变量。使用 IDE 扩展时，不要默认认为你在终端执行的 export OPENAI_API_KEY=... 一定会被 IDE 进程读取；官方 FAQ 特别提醒，VS Code 和 JetBrains 扩展不能直接读取所有终端环境变量。
- 把密钥放入适合当前环境的
.env文件。 - 将
.env加入 Git 忽略规则。 - 只为 Continue 创建权限足够、范围尽量小的 API Key。
- 如果密钥已经泄露，应立即在对应平台撤销并重新生成。
五、保存配置后如何在 Continue 中启用
- 打开 Continue 的配置文件或配置编辑入口，确认文件使用 YAML 格式。
- 在
models下新增一个模型条目。 - 检查
provider、model、apiKey和apiBase的缩进与拼写。 - 保存文件。
- 在 Continue IDE 扩展的配置选择器中点击 Reload config，或重新选择当前配置。
- 新建一个简单对话，先发送“请用一句话解释当前项目”，确认模型可以返回结果。
- 再测试代码编辑、应用修改等功能。如果聊天可用但编辑不可用，检查模型的
roles是否包含edit和apply。
第一次测试建议使用短问题，避免同时引入整个代码库、MCP 工具或复杂规则。这样可以把“API 连接问题”和“上下文过大、模型能力不匹配”等问题分开判断。
六、Continue 配置字段对照表
下面的字段含义适用于常见的 OpenAI 或 OpenAI 兼容配置。不同模型或服务端是否支持某项能力，仍应以实际接口文档为准。
| 字段 | 是否通常需要 | 作用 | 填写注意事项 |
|---|---|---|---|
name | 是 | Continue 中显示的模型名称 | 可以自定义，不等于服务端模型 ID |
provider | 是 | 指定模型提供商类型 | OpenAI 及兼容接口通常填写 openai |
model | 是 | 服务端实际调用的模型 ID | 必须与服务端接受的名称一致 |
apiKey | 视接口而定 | 提供请求鉴权信息 | 优先使用 secrets 引用，不要公开明文密钥 |
apiBase | 兼容接口通常需要 | 覆盖默认 API 根地址 | 按官方文档填写，常见形式包含 /v1 |
roles | 可选 | 指定模型用于聊天、编辑或应用修改等任务 | 功能异常时检查是否缺少对应角色 |
capabilities | 可选 | 手动声明工具调用、图像输入等能力 | 只有服务端确实支持时才添加 |
七、常见报错排查
1. 401 Unauthorized
通常表示 API Key 缺失、错误、过期或没有被 Continue 读取。先检查 apiKey 是否拼写正确，再确认 ${{ secrets.OPENAI_API_KEY }} 对应的变量确实存在。如果使用 IDE 扩展，不要只在终端设置环境变量后就假设扩展能读取；可以按 Continue 官方 FAQ 的密钥解析顺序检查工作区和用户目录下的环境文件。
2. 403 Forbidden
通常与密钥权限、项目权限、组织策略或模型访问权限有关。确认该 API Key 可以调用目标模型，并检查服务端是否要求额外的组织、项目或请求头。Continue 配置正确并不代表服务端一定授予模型调用权限。
3. 404 Not Found
优先检查 apiBase 是否多写或少写了路径、是否误填了完整接口路径，以及 model 是否是服务端真实支持的 ID。兼容接口的路径规则可能不同，不能只把某个服务的 URL 格式套用到另一个服务。
4. 429 Too Many Requests
这通常表示服务端限流、配额不足或短时间请求过多。先降低并发和请求频率，减少一次发送的上下文，确认账户或项目仍有可用额度。不要通过反复重试快速请求来解决 429，否则可能继续触发限流。
5. 能聊天但不能编辑代码
检查模型的 roles 是否包含 edit、apply，并确认模型或兼容接口支持 Continue 所需的请求能力。如果服务端不支持工具调用或结构化输出，某些 Agent 或自动应用功能可能无法正常工作。
6. 流式输出中断或无响应
先用短消息测试，再检查接口是否支持流式响应、代理或网关是否会缓冲长连接，以及 Continue 使用的接口类型是否与服务端兼容。Continue 官方文档说明，部分较新的模型默认会使用 Responses API；如果兼容服务只支持 Chat Completions，可以根据官方配置项尝试设置 useResponsesApi: false。该设置不能解决所有网络或服务端问题，仍需以接口实际支持情况为准。
八、一个可执行的最小检查清单
- 配置文件：确认使用
config.yaml，不是把 YAML 内容保存成错误的扩展名。 - 缩进：确认
models、模型条目以及字段之间使用正确的 YAML 缩进。 - 提供商：确认 OpenAI 及兼容接口使用
provider: openai。 - 地址：兼容接口填写服务端要求的
apiBase，不要擅自拼接接口路径。 - 模型：确认
model是服务端可识别的模型 ID。 - 密钥：确认 API Key 未过期、未包含多余空格，并且 Continue 能读取密钥来源。
- 重载：保存后在 Continue 中执行 Reload config。
- 分步测试：先测试聊天，再测试编辑、应用修改和工具调用。
如果仍然失败，建议记录完整错误码、请求使用的模型 ID、是否填写了 apiBase、使用的是 IDE 扩展还是 Continue CLI，以及服务端是否为 OpenAI 兼容接口。不要在公开工单或截图中暴露完整 API Key。
常见问题
Continue 配置 OpenAI API 时一定要填写 apiBase 吗？
不一定。直接使用 OpenAI API 时通常可以不填写 apiBase；使用其他 OpenAI 兼容接口时，通常需要根据该服务的官方文档填写 apiBase。
Continue 的 config.yaml 放在哪里？
具体位置取决于使用方式。Continue 官方文档对 CLI 说明，默认配置文件是用户目录下的 ~/.continue/config.yaml；IDE 扩展则可以通过配置入口管理本地配置，实际位置以当前扩展版本显示为准。
为什么已经修改 config.yaml，Continue 仍然使用旧模型？
保存文件后，需要在 Continue 的配置选择器中重新加载配置，通常是点击 Reload config，或重新选择当前配置。
apiBase 应该填到 /v1 还是 /chat/completions？
应以接口服务商官方文档为准。Continue 的兼容接口示例使用 API 根地址并包含 /v1，一般不应直接填写完整的 /chat/completions 路径。
可以把 OpenAI API Key 直接写在 config.yaml 里吗？
技术上可以，但不建议长期这样做。更安全的做法是使用 Continue 支持的 secrets 语法，并将环境文件加入 Git 忽略规则，避免密钥进入公开仓库。