Codex、Claude Code、Cursor、Cline 如何配置 Base URL？

开发工具的配置界面不一样，但底层问题很少超过四个：Key 写在哪里、Base URL 是否正确、模型 ID 是否可用、工具当前使用的是 OpenAI 兼容协议还是 Anthropic 兼容协议。把这四点拆开，就能快速定位大多数接入问题。

通用配置表

• OpenAI 兼容 Base URL：https://bigmodel.io/v1。
• API Key：填写 BigModel.io 控制台创建的 sk- 开头密钥。
• 模型 ID：以模型目录或价格页显示为准。
• 验证方式：先发一个最小请求，再开启流式、工具调用或长上下文。

Codex config.toml 示例

将以下配置合并到 ~/.codex/config.toml，并在启动 Codex 的环境中设置 BIGMODEL_API_KEY。仅对已验证支持 Responses 接口的模型使用此示例；Chat Completions 可用不代表 Responses 可用。

model_provider = "bigmodel"
model = "YOUR_VERIFIED_MODEL_ID"

[model_providers.bigmodel]
name = "BigModel.io"
base_url = "https://bigmodel.io/v1"
wire_api = "responses"
env_key = "BIGMODEL_API_KEY"

Claude Code 环境变量示例

此示例需要已验证的 Anthropic Messages 网关和 Claude 模型。先设置 BIGMODEL_API_KEY 与 BIGMODEL_MODEL_ID。网关地址使用 https://bigmodel.io；客户端会追加 /v1/messages，不要重复添加 /v1。具体模型和工具能力仍需端到端验证。

export ANTHROPIC_AUTH_TOKEN="${BIGMODEL_API_KEY:?Set BIGMODEL_API_KEY first}"
export ANTHROPIC_BASE_URL="https://bigmodel.io"

claude --model "${BIGMODEL_MODEL_ID:?Set a verified Claude model ID}"

在 Claude Code 中运行 /status 核对地址与认证来源，再检查实际请求和控制台用量。模型回复不能证明配置已生效。

Cursor / Cline 配置要点

• 找到 OpenAI Compatible、Custom Endpoint 或 API Provider 设置项。
• Base URL 填 https://bigmodel.io/v1，避免填成 /v1/chat/completions。
• API Key 填控制台创建的 Key，不要使用文档里的示例 Key。
• 模型 ID 手动填写价格页或模型目录中的可用模型。

LangChain 最小示例

import { ChatOpenAI } from "@langchain/openai";

const model = new ChatOpenAI({
  model: process.env.BIGMODEL_MODEL_ID,
  apiKey: process.env.BIGMODEL_API_KEY,
  configuration: {
    baseURL: "https://bigmodel.io/v1",
  },
});

const result = await model.invoke("列出接入前需要验证的 5 件事。");
console.log(result.content);

排查顺序

• 第一步：打印工具实际读取到的 Base URL，确认没有重复 /v1。
• 第二步：换成最小请求，排除业务 prompt、工具调用和上下文过长的影响。
• 第三步：换一个已知可用模型 ID，排除模型名拼写问题。
• 第四步：重启工具或清理本地缓存，很多 IDE 会缓存旧配置。
• 第五步：带上错误码、时间、模型 ID 和工具名称联系 控制台的“支持与反馈”入口。

FAQ

• Base URL 要不要带 /chat/completions？不要。SDK 或工具会自己拼请求路径。
• 为什么同一个 Key 在一个工具能用，另一个不能用？通常是协议类型、模型 ID 或工具缓存配置不同。
• 能不能用同一个 Key 配多个工具？可以，但建议至少为生产工具单独创建 Key。