EasyAPI问答
前往 EasyAPI

Claude Code、Cursor、Codex 等编程工具怎么接入第三方 API Key?

EasyAPI 团队整理

直接回答

先分清接口格式。Cursor、Codex CLI 和 Cline 走 OpenAI 兼容格式,地址填 https://token.easyapi.com/v1;Claude Code 走 Anthropic 格式,地址填 https://token.easyapi.com,不带 /v1。Key 用 EasyAPI 控制台创建的令牌。

编程工具接入第三方 API Key,配置项只有三个:API 地址、API Key、模型 ID。容易出错的地方在于不同工具使用的接口格式不同,地址的写法也跟着不同。下面以 EasyAPI 为例,分别说明 Cursor、Claude Code、Codex CLI 的配置,并补充 Cline 这类插件的通用填法。

这些工具更新很快,菜单名称和配置字段可能与本文有出入,以你安装的版本和工具官方文档为准。

关键要点

  • Cursor、Codex CLI、Cline 使用 OpenAI 兼容格式,Base URL 为 https://token.easyapi.com/v1。
  • Claude Code 使用 Anthropic Messages 格式,ANTHROPIC_BASE_URL 填站点根地址 https://token.easyapi.com,不带 /v1。
  • API Key 是 EasyAPI 控制台「令牌管理」里创建的 sk- 开头令牌,建议为编程工具单独建一个。
  • 模型 ID 必须与模型广场显示的完全一致,工具预置的模型名不一定可用。
  • 编程工具单次任务消耗的 Token 远多于普通对话,接入前先给令牌设好额度。

先确认工具用哪种接口格式

工具接口格式地址怎么填配置位置
CursorOpenAI 兼容https://token.easyapi.com/v1Settings → Models
Codex CLIOpenAI 兼容https://token.easyapi.com/v1~/.codex/config.toml
Cline 等编辑器插件OpenAI 兼容https://token.easyapi.com/v1插件设置里的 OpenAI 兼容服务
Claude CodeAnthropic Messageshttps://token.easyapi.com环境变量

EasyAPI 文档的「工具接入」部分有 Cursor、Claude Code、Codex 的专门页面;Cline 没有单独页面,按 OpenAI 兼容的通用方式填写即可。

各工具的配置步骤

Cursor

  1. 打开 Settings,在左侧选择 Models,找到 OpenAI API 相关配置区域。部分版本的路径是 Settings → Cursor Settings → Models。
  2. 把 OpenAI API Key 换成 EasyAPI 令牌,开启 Override OpenAI Base URL,填入带 /v1 的地址。
  3. 在模型列表里添加模型广场中的模型 ID,然后在聊天面板里选择它。

Codex CLI

编辑用户级配置文件 ~/.codex/config.toml,新增一个供应商并指向它:

model_provider = "easyapi"
model = "qwen3.8-max"

[model_providers.easyapi]
name = "EasyAPI"
base_url = "https://token.easyapi.com/v1"
env_key = "OPENAI_API_KEY"

然后在终端把令牌写入 env_key 指定的环境变量,再运行 codex:

export OPENAI_API_KEY="sk-你的令牌"
codex

Claude Code

Claude Code 通过环境变量读取地址和密钥:

export ANTHROPIC_BASE_URL="https://token.easyapi.com"
export ANTHROPIC_API_KEY="sk-你的令牌"
claude

如果本机已有 Anthropic 官方的登录或环境变量配置,先清除或覆盖,避免两套配置冲突。

Cline 等插件

在插件设置里选择 OpenAI 兼容类型的服务,填入带 /v1 的 Base URL、EasyAPI 令牌和模型 ID,例如 glm-5.3 或 kimi-k2.7-code。

模型怎么选,有哪些限制

  • 看模型支持的端点类型。 模型广场的模型详情会列出该模型可调用的 API 端点。部分工具版本使用 OpenAI Responses 格式发请求,这时要选详情里标有 Responses 端点的模型;截至 2026-11-13,公开目录中 qwen3.8-max、glm-5.3 等模型同时支持对话补全与 Responses 两种端点,kimi-k2.7-code 只标注了对话补全端点。
  • Claude Code 需要支持 Anthropic 格式的模型。 匿名可见的公开目录以国产模型为主,标注的是 OpenAI 兼容端点。哪些模型可以通过 /v1/messages 调用,需要登录后在模型广场查看当前可用情况,本文不承诺具体型号。
  • 工具的自有功能不一定走你的 Key。 例如编辑器自带的补全、索引等功能是否支持自定义 Key,由工具本身决定,以其官方说明为准。
  • 编程任务依赖工具调用能力。 不同模型对工具调用和长上下文的支持程度不同,换模型后建议先用一个小任务试跑。

验证与排查

配置完成后发起一次简单任务,再到 EasyAPI 控制台的调用记录里查看是否出现对应时间、模型和令牌的记录。出现了说明请求确实走的是这把 Key。

不通时按下面的顺序检查:

  1. 地址格式。 OpenAI 兼容工具漏了 /v1,或 Claude Code 多写了 /v1,都会导致路径错误。
  2. Key 是否完整可用。 令牌列表里显示的是脱敏密钥,不能直接复制使用;禁用或过期的令牌无法调用。
  3. 模型 ID。 拼写、大小写、版本号要与模型广场一致。
  4. 令牌的模型限制与 IP 白名单。 设置了限制的令牌,超出范围的请求会被拒绝。
  5. 余额与额度。 按状态码排查的方法见 调用大模型 API 返回 401 / 429 / 5xx 分别该怎么排查。

常见问题

为什么 Claude Code 的地址不带 /v1,其他工具要带?

因为接口格式不同。OpenAI 兼容工具把 Base URL 当作 /v1 这一层,自己再拼 /chat/completions;Claude Code 按 Anthropic 的约定自己拼 /v1/messages,所以只需要站点根地址。

可以用 Claude Code 调用国产模型吗?

取决于该模型是否开放了 Anthropic 格式的端点。公开目录里的模型标注的是 OpenAI 兼容端点,是否能通过 Claude Code 使用,请登录后在模型广场的模型详情里确认;不确定时,用 Cursor、Codex 或 Cline 走 OpenAI 兼容格式更稳妥。

编程工具会不会很费钱?怎么控制?

会比普通对话费得多,因为每一步都会带上代码上下文,还会多轮调用。建议为编程工具单独创建令牌并设置独立额度,或者按天、按月设预算,方法见 怎么给 API Key 设置每日/每月预算上限。

配好之后工具里选不到我要的模型怎么办?

手动添加。工具自带的模型下拉列表是它预置的名称,把模型广场里的模型 ID 作为自定义模型加进去即可。

小结

编程工具接入第三方 API Key 的关键是先分清接口格式:OpenAI 兼容的工具填带 /v1 的地址,Claude Code 填站点根地址。Key 用单独的令牌并设好额度,模型 ID 从 模型广场 复制,各工具的图文步骤见 EasyAPI 文档。

一个 API Key,按 OpenAI 兼容格式调用多家模型

按量计费,用量逐条可查。价格与当前可用模型以模型广场实时显示为准。