团队统一配置 AI 编程工具:Codex CLI/Cursor/Cline 接入

Q: Codex CLI 怎么自定义 base url?

在 ~/.codex/config.toml 里新增一个 model_providers.hopbase,base_url 填 https://api.hop-base.com/v1,wire_api 填 responses,env_key 填 OPENAI_API_KEY,再把 model_provider 设为 hopbase。Key 要用 Codex Plus 或 Codex Pro 分组的。

团队统一配置 AI 编程工具,核心只有两步:管理员给每位开发者一把带额度、带对应分组的 Key;开发者按工具选对协议填 Base URL。Claude 模型一律走 Anthropic Messages,Base URL 填 https://api.hop-base.com(不带 /v1);GPT、Gemini、GLM 走 OpenAI 兼容,填 https://api.hop-base.com/v1。Claude Code 用 ANTHROPIC_BASE_URL 加 ANTHROPIC_AUTH_TOKEN,Codex CLI 用 config.toml 加 OPENAI_API_KEY,Cursor、Cline、Roo Code、Continue、Trae 在设置里选供应商类型即可。

先看这张表:每个工具走哪个协议

工具	模型	协议 / 供应商类型	Base URL	配置位置
Claude Code	Claude	Anthropic Messages	`https://api.hop-base.com`	`ANTHROPIC_BASE_URL` / `ANTHROPIC_AUTH_TOKEN`,或 `~/.claude/settings.json`
Codex CLI	GPT	OpenAI Responses(`wire_api = "responses"`)	`https://api.hop-base.com/v1`	`~/.codex/config.toml` + `OPENAI_API_KEY`
Cursor	GPT / Gemini / GLM	Override OpenAI Base URL	`https://api.hop-base.com/v1`	Cursor Settings → Models
Cursor	Claude	Anthropic API Key 字段	`https://api.hop-base.com`	Cursor Settings → Models(需较新版本)
Cline / Roo Code	GPT / Claude	OpenAI Compatible / Anthropic	GPT 带 /v1,Claude 不带	插件设置 → API Provider
Continue	GPT / Claude	`provider: openai` / `provider: anthropic`	同上	`~/.continue/config.yaml`
Trae	GPT / Claude	OpenAI 兼容 / Anthropic	同上	设置 → 模型 → 添加模型

Zed、JetBrains AI 等其他编辑器同理:Claude 用 Anthropic 类型,其他模型用 OpenAI 兼容类型。最常见的两个配错:Base URL 多写了 /v1(请求变成 /v1/v1/messages),或者用 Claude 分组的 Key 选了 OpenAI Compatible,两者都返回 404「当前平台不支持该 API 路径」。

第一步:管理员给每位开发者发 Key

建部门。在企业控制台按团队建部门(如「后端组」「前端组」),设部门月度额度。部门负责人会收到本部门的额度预警。
加成员并设成员额度。成员用邮箱和密码登录,自己创建密钥;成员额度由他名下所有密钥共用。
按工具分 Key。建议一个工具一把 Key:Claude Code 用含 Claude 分组的 Key,Codex CLI 用含 Codex Plus 或 Codex Pro 分组的 Key。每把 Key 可含 1–10 个分组,只能调这些分组里的模型。注意 Claude Max(ccmax)分组仅限 Claude Code 客户端,在 Cursor、Cline 等编辑器里要用 Claude Max 企业版分组的 Key。
给 Key 加限制。按需设 Key 额度、过期时间、IP 名单和并发。Claude Code 统计 token 的 count_tokens 请求也占用并发,设并发时留出余量。
设余额预警。按可用余额设多档阈值,跌破时发邮件和站内通知。

额度用尽时,请求在处理前被拒绝(HTTP 402 insufficient_quota),不会产生费用。部门和成员的月度额度在账期日(每月 1–28 号)统一重置。

第二步:开发者配置各个工具

Claude Code

推荐用控制台「一键接入」:在「API 密钥」点密钥右侧的「一键接入」,选 Claude Code 和系统,生成命令贴到终端执行。命令使用 15 分钟内有效、只能用一次的接入令牌,不在命令里暴露密钥。脚本把配置写进 ~/.claude/settings.json 的 env(原文件先备份);之后 shell 里设置的同名环境变量不会生效,换 Key 请改这个文件或重新一键接入。

手动配置(macOS / Linux):

export ANTHROPIC_BASE_URL=https://api.hop-base.com
export ANTHROPIC_AUTH_TOKEN=sk-your-key
claude

会话里用 /model 切换模型,或启动时加 --model claude-sonnet-5-5。完整步骤见 Claude Code 接入文档,个人从注册到第一次补全的实操见 Claude Code 接入完整实践。

Codex CLI

Codex CLI 同样支持一键接入,也可以手动在 ~/.codex/config.toml(Windows 为 C:\Users\你的用户名\.codex\config.toml)写入:

model_provider = "hopbase"
model = "gpt-5.6-sol"

[model_providers.hopbase]
name = "HopBase"
base_url = "https://api.hop-base.com/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

再设置 export OPENAI_API_KEY=sk-your-key 后运行 codex。三点注意:

手动配置用 env_key,一键接入用 requires_openai_auth = true 加 ~/.codex/auth.json,两种写法不要混用,否则会返回 401 missing_api_key。
一键接入默认 model_reasoning_effort = "xhigh",token 消耗最多;团队日常可改为 high 或 medium。
联网搜索(/v1/alpha/search)和远程上下文压缩(/v1/responses/compact)目前不支持,会返回 404;不影响普通对话。

详见 Codex CLI 接入文档。

Cursor

GPT / Gemini / GLM:Cursor Settings → Models 的 API Keys 中填对应分组的 Key,开启「Override OpenAI Base URL」,填 https://api.hop-base.com/v1,再加入模型 ID。
Claude:用 Anthropic API Key 字段,Anthropic Base URL 填 https://api.hop-base.com(不带 /v1,需较新版本 Cursor)。

Cursor 的 Tab 补全等内置功能仍使用 Cursor 自己的服务,这里的配置只影响 Chat 中选中的自定义模型。

Cline / Roo Code

插件设置 → API Provider:GPT 模型选「OpenAI Compatible」,Base URL 填 https://api.hop-base.com/v1;Claude 模型选「Anthropic」,Base URL 填 https://api.hop-base.com。再填 API Key 和 Model ID,保存即可。

Continue

# ~/.continue/config.yaml
models:
  - name: HopBase GPT
    provider: openai
    model: gpt-5.6-sol
    apiBase: https://api.hop-base.com/v1
    apiKey: sk-your-key
  - name: HopBase Claude
    provider: anthropic
    model: claude-sonnet-5-5
    apiBase: https://api.hop-base.com
    apiKey: sk-your-key

两条 apiKey 分别填对应分组的 Key。Trae 的设置路径是:设置 → 模型 → 添加模型,GPT 选「OpenAI 兼容」,Claude 选「Anthropic」。各编辑器的完整说明见编辑器 / IDE 接入文档。

第三步:验证与排错

确认模型 ID:用这把 Key 调 GET /v1/models,只使用返回列表里的 ID。
```
curl https://api.hop-base.com/v1/models -H "Authorization: Bearer sk-your-key"
```
最小测试:在工具里选中新模型,发「只回复 ok」。通过后再开工具调用、图片和长上下文。
按报错排查:404 先查 /v1 是否多写或漏写、Claude 是否误选 OpenAI 类型;401 查 Key 是否写对、Codex 是否混用两种密钥写法;402 是额度用尽,找管理员调额度。

上线之后怎么管

看消耗:用量页可按日期、Key、成员、部门、Key 创建人筛选并导出 CSV。按工具分 Key 后,就能直接看出 Claude Code 和 Codex CLI 各花了多少。
查操作:额度调整、密钥创建与禁用等操作全程留痕,可按时间和对象查询。
离职回收:停用成员后,其名下所有密钥立即不可用;单把 Key 也可以随时禁用或吊销,不影响其他人。

准备给团队接入:注册 HopBase,创建企业账号后添加成员和部门。

常见问题

Codex CLI 怎么自定义 base url?

在 ~/.codex/config.toml 里新增一个 model_providers.hopbase,base_url 填 https://api.hop-base.com/v1,wire_api 填 responses,env_key 填 OPENAI_API_KEY,再把 model_provider 设为 hopbase。Key 要用 Codex Plus 或 Codex Pro 分组的。

Cursor 自定义 API 能用 Claude 吗?

能。不要用 Override OpenAI Base URL,而是在 Anthropic API Key 字段填 Claude 分组的 Key,Anthropic Base URL 填 https://api.hop-base.com(不带 /v1)。这需要较新版本的 Cursor;Tab 补全仍走 Cursor 自己的服务。

一个团队几十人用 Claude Code,怎么防止有人用超?

三级额度叠加使用:部门额度封顶整组,成员额度封顶个人,Key 额度封顶单个工具。任一层用尽,请求在处理前就被拒绝(HTTP 402),不会产生费用。成员额度之和超过部门额度时先花先得。