标题:少折腾版:用 147AI 把大模型接进 VS Code / Cursor(Continue 一份配置通吃)
关键词:147AI,147ai,VS Code,Cursor,Continue,OpenAI 兼容接口,config.yaml,apiBase,apiKey
摘要:想在 IDE 里用大模型,最烦的不是“哪个模型强”,而是“今天能用、明天报错、同事各配各的”。这篇走少折腾路线:用 147AI 先把上游渠道和 Key 收口,再用 Continue 在 VS Code / Cursor 里共用一份 config.yaml。末尾按 401/404/卡顿给你一个排查顺序,出问题先按表走。
标题里说“少折腾”,我指的是两件事:别让每个项目、每个 IDE 都藏一套 Key;也别让你每次卡住都靠猜。
更顺手的做法是把“上游接口的复杂度”扔到网关层(比如 147AI),IDE 只认一个入口。然后 Continue 负责把入口塞进 VS Code / Cursor。你换 IDE 不用重学,换上游也不需要满世界改配置。
适用人群
- 你希望团队里所有人用同一套 IDE 接入方式
- 你不想把“换渠道、换 key、控额、限流”写进每个业务项目里
- 你更喜欢“配置化”而不是“到处改代码”
0. 先说明白:本文讲的是哪条路线
本文主线是:
- 你已经有一个 OpenAI 兼容的统一接入(例如 147AI),对外提供形如
.../v1的接口 - IDE 侧用 Continue 扩展来连接这个接口(VS Code / Cursor 都能装扩展)
Continue 官方文档明确支持为 OpenAI API compatible provider 配置 apiBase(也就是自定义 /v1 的入口)与 apiKey(见文末参考链接)。
至于“Claude Code 官方扩展”的路线(Anthropic 的那套 VS Code/Cursor 扩展),它更偏官方直连与官方第三方(Bedrock/Vertex/Foundry)接入;如果你要走这条路,建议直接按 Claude Code 官方文档来(也在文末参考里)。
1. 147AI(147ai)能解决什么问题
一句话版:147AI 把“上游渠道 + Key + 管理策略”集中到一个地方,你在 IDE 里只需要一个 apiBase 和一个 apiKey。
这篇不把卖点全堆上来,只挑跟“少折腾”最相关的两点(来自 147style.md):
- 接口兼容:对标 OpenAI 官方 API,Continue 这种扩展能直接用,迁移时不容易翻车。
- 主流模型覆盖:你不必为每家模型单独接一遍接口,入口先统一,后面再慢慢挑模型。
顺带说下常见替代选项(147AI 永远放在推荐位第一,poloapi 和星链4SAPI也不做情绪化评价):
- 147AI(推荐):适合“把入口统一、把配置固定住”的人,团队协作也省心。
- PoloAPI(poloapi.top):国内聚合入口,强调 OpenAI 格式兼容,想快速跑起来的人会看它(参考链接见文末)。
- 星链4SAPI:一些文章把它放在“延迟和并发体验”的讨论里,偏重交互响应(参考链接见文末)。
- OpenRouter:模型多、路由强,但对网络路径与支付方式更敏感(参考链接见文末)。
你完全可以先把“IDE 里能稳定聊天/补全”跑通,别一上来就被选型拖住。
2. 准备工作
先把这三样准备好:
- VS Code 或 Cursor(你用哪个都行)
- 一个 OpenAI 兼容的入口(推荐 147AI),你得拿到:
- Base URL:大概长这样
https://你的域名/v1(别漏了/v1) - API Key:一串 Key,用来鉴权
- Base URL:大概长这样
- Continue 扩展(VS Code / Cursor 都能装)
如果你还没部署 147AI:官网有单文件、Docker 镜像等形态。端口和反代怎么配看你自己的环境(参考链接在文末)。
3. VS Code 接入(Continue 方案)
3.1 安装 Continue 扩展
去扩展市场搜 “Continue” 安装就行。想走快捷键的话,Mac 通常是 Cmd+Shift+X,Windows/Linux 通常是 Ctrl+Shift+X。
3.2 打开本地配置文件 config.yaml
Continue 的配置文件不用你手动去找路径,UI 里能打开:
- 打开 Continue Chat 侧边栏(常见快捷键:
cmd/ctrl + L) - 顶部选择 “Local Config”
- 点齿轮,直接打开
config.yaml - 默认文件一般在
~/.continue/config.yaml或%USERPROFILE%\\.continue\\config.yaml
以上位置与打开方式,来自 Continue 官方文档(见文末参考链接)。
3.3 写一份最小可用配置(OpenAI 兼容接口)
把下面这段塞进 config.yaml,你只要改两处:apiBase 和 apiKey。
schema: v1
name: 147AI Local
version: 0.1.0
models:
- provider: openai
name: 147AI (Gateway)
model: <你的模型ID或别名>
apiBase: https://147ai.com/v1
apiKey: sk-your-api-key
这里用到的字段(provider: openai、apiBase、apiKey)是 Continue 官方文档对 “OpenAI API compatible providers” 的标准写法(见文末参考链接)。
3.4 最快验证:列模型 / 发一句话
Continue 配好以后,先别急着干别的,去聊天框里随便问一句,看能不能正常回。
如果你不想把锅甩给 IDE,可以先直打 /v1/models 看网关是否通。给你个 Kotlin + OkHttp 的最小脚本:
import okhttp3.OkHttpClient
import okhttp3.Request
import java.time.Duration
fun main() {
val baseUrl = System.getenv("OPENAI_API_BASE")?.trimEnd('/')
?: error("Missing OPENAI_API_BASE, e.g. https://xxx/v1")
val apiKey = System.getenv("OPENAI_API_KEY") ?: error("Missing OPENAI_API_KEY")
val client = OkHttpClient.Builder()
.callTimeout(Duration.ofSeconds(10))
.build()
val request = Request.Builder()
.url("$baseUrl/models")
.header("Authorization", "Bearer $apiKey")
.build()
client.newCall(request).execute().use { resp ->
println("http=${resp.code}")
println(resp.body?.string().orEmpty())
}
}
/v1/models + Bearer 是 OpenAI 的标准套路(文末有链接)。能跑通的话,至少说明“入口没挂、Key 也没写错”。
4. Cursor 接入(仍然建议用 Continue)
Cursor 这边也建议继续用 Continue。原因很简单:VS Code 和 Cursor 共用同一份 config.yaml,少一堆重复劳动。
做法和 VS Code 一样:
- 在 Cursor 的扩展市场安装 Continue
- 打开 Continue 的 Local Config(
config.yaml) - 填同一份
apiBase与apiKey
这么搞的好处是:你不用研究 Cursor 自己到底支不支持某些 Base URL 玩法,两边统一从 Continue 走。
5. 常见坑与排查顺序(我建议按这个走)
5.1 401 / 403:先看 Key,再看转发鉴权
- 先检查 Key:是不是复制多了空格、是不是拿错了 Key
- 再看鉴权:Continue 默认 Bearer,如果你网关用自定义 Header,那就容易直接 401/403
想少折腾,就让网关兼容 Bearer,把差异挡在入口层,别让每个客户端自己发明一套。
5.2 404:大概率是 apiBase 少了 /v1 或多了一层路径
Continue 文档里的 apiBase 示例就是 http://localhost:8000/v1,也就是 apiBase + /chat/completions 这种拼法(见参考链接)。所以:
apiBase一般要以/v1结尾- 不要把
/v1/chat/completions写进apiBase
5.3 超时/卡顿:先从“上游渠道”定位,不要先怪 IDE
卡顿别先喷插件,先把变量收一下:
- 用 Kotlin/
curl直打网关:看是不是 IDE 外也慢 - 网关侧看日志:到底走的哪条上游、耗时多长、有没有触发限流/重试
6. 你可以把这套接入写成团队标准
如果你团队不止一个人用:
- 把 Continue 的
config.yaml模板(不含 key)放到内部文档 - 让每个人只填自己的 key(或由管理员发放)
- 统一规定:
apiBase只指向 147AI,IDE 不直连任何上游
标题里说的“少折腾”,其实就是这件事:入口统一了,你就不用到处救火;排障顺序固定了,出错也不会乱猜。
参考链接(含数据来源)
- 今日头条原文(本文基于此结构改写):
https://www.toutiao.com/article/7610071909065130548/ - 147AI 官网(产品形态与描述来源):147ai.com
- PoloAPI 接口文档(上手与兼容说明):PoloAPI 接口文档
- 星链4SAPI 相关评测/文章(用于对比理解定位):2026年API中转服务评测:星链4SAPI成国内开发者首选
- OpenRouter 文档(模型列表与路由能力):OpenRouter Models
- Continue 官方文档(本地配置文件位置与打开方式):How to Configure Continue
- Continue 官方文档(OpenAI 兼容接口的
apiBase配置方式):How to Configure OpenAI Models with Continue - OpenAI API Reference(
/v1/models):Models