AI-dns 使用文档

本文档帮助你快速获取 API Key，并在常见 AI 编程工具中配置 OpenAI 兼容接口。

获取 API Key

在配置 Cursor、Codex 或 Claude Code 前，请先登录 AI-dns 控制台获取自己的 API_KEY。

打开并登录 AI-dns 平台。
进入控制台中的令牌或密钥管理页面。
点击新增令牌，按提示创建一个新的访问密钥。
复制生成的 Key，并妥善保存。

安全提醒

API Key 等同于你的访问凭证，不要截图公开，也不要提交到 GitHub 等公开仓库。

Codex 配置第三方 API

Codex 可以通过 config.toml 配置 OpenAI 兼容接口。以下示例以 AI-dns 为默认服务。

配置 config.toml

model_provider = "AI-dns"
model = "gpt-5.4-mini"
review_model = "gpt-5.4-mini"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.AI-dns]
name = "AI-dns"
base_url = "https://www.openaidns.net/v1"
wire_api = "responses"
requires_openai_auth = true

配置 auth.json

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxx"
}

保存后重启 Codex，新配置即可生效。

Cursor 配置第三方 API

打开 Cursor 设置。
找到模型或 API 配置区域。
将接口地址配置为 https://www.openaidns.net/v1。
填入你的 API_KEY，并添加你要使用的模型名称。

注意

Cursor 对第三方 API 的兼容性可能随版本变化。如果配置后无法调用，建议优先使用 Codex 验证 API Key 是否可用。

Claude Code 配置第三方 API

Claude Code 可通过配置环境变量接入第三方接口。请根据你的本地环境修改配置文件。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.openaidns.net",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "gpt-5.4-mini"
  },
  "alwaysThinkingEnabled": true,
  "effortLevel": "medium"
}

完成后重启 Claude Code，再开启新会话测试。

常见问题

API Key 可以在多个工具中复用吗？

可以。同一个 Key 可以配置在多个客户端中，但建议按用途创建不同 Key，方便后续管理和停用。

配置后调用失败怎么办？

检查 API Key 是否复制完整。
检查接口地址是否带有正确的 /v1。
确认模型名称是否在当前账号可用范围内。
重启客户端后重新测试。