服务基准地址Base URL
你可能会说
我把大模型的 API 地址换成我们团队自己部署的中转服务了,现在需要改哪里的 Base URL 才能生效?
Base URL(基准地址)是一组 API 请求共同使用的地址前缀。例如某个客户端把
https://openrouter.ai/api/v1 与 /chat/completions 拼成完整请求地址。是否包含 /v1、客户端会补哪一段路径,都取决于服务接口和客户端的拼接规则;配置时要同时核对两边的官方文档,不能套用一个固定写法。常见服务方配置文档
Base URL 的作用机制
用餐厅地址理解 Base URL:把 AI 工具想成帮你点餐的人。Base URL 就像餐厅地址,告诉工具请求应该送到哪里;它不决定使用哪个模型。
去哪里找 Base URL 配置:Codex:~/.codex/config.toml;Claude Code:全局 ~/.claude/settings.json,项目级 .claude/settings.json。如果使用环境变量,再查 ANTHROPIC_BASE_URL。
本地服务也可能有自己的地址:本地模型可能使用 http://localhost:11434/v1,表示请求送到当前电脑;它和 OpenRouter 的地址并不相同。
你可以这样告诉 AI Agent
请检查这份配置里的 Base URL 是否应填写 `https://openrouter.ai/api/v1`,并确认工具会在后面补上具体请求路径;不要把真实密钥写出来。
接下来学什么
延伸阅读 · 权威出处
快速练习