2.3 查看接入配置与 Base URL

本节目标：掌握客户端接入的核心网络参数 —— Base URL（接口地址） 与 API Key，理解不同协议与网络线路的规范。

几乎所有的 AI 编程工具（Codex、Claude Code、Cursor、Cline、Chatbox、Python SDK 等），在底层发起网络通信时，都只需要以下两项关键凭证：

1. 接口地址 (Base URL)：告诉客户端将模型请求发往哪个网关；
2. 凭证密钥 (API Key)：用于证明您的有效账户身份与扣减额度。

---

一、艾智云核心接入参数速查

⚡ 国内极速专线（首选推荐）

https://hk.azy6.cc/v1

部署于香港直连高防节点，国内访问端到端延迟低至 20~40ms，IDE 与终端编程首选。

🌐 官方全球主线（备用）

https://azy6.cc/v1

全球边缘加速主节点，跨国网络或香港专线维护时自动平替。

🔑 API Key (用户凭证)

sk-xxxxxxxxxxxxxxxx

上一节中创建生成的个人专属令牌（请以实际复制的内容为准）。

---

二、OpenAI 协议与 Anthropic 协议规范

艾智云网关同时原生兼容 OpenAI 官方协议 与 Anthropic (Claude) 原生协议，根据客户端类型的不同，填写的 Base URL 略有差异：

客户端与调用场景	采用协议	推荐 Base URL 填写规范	典型代表工具
标准 OpenAI 兼容	OpenAI API 格式	https://hk.azy6.cc/v1	Cursor, Codex, OpenCode, Cline, Chatbox, Python openai
Claude 原生工具	Anthropic API 格式	https://hk.azy6.cc (注：无需追加 /v1)	Claude Code 终端, OpenClaw

避坑法则：末尾到底要不要加 `/v1`？

• 如果客户端设置项名称明确叫 OpenAI Base URL 或 API Host，绝大多数要求写到 /v1（如 https://hk.azy6.cc/v1）；
• 如果是 Claude Code 终端工具，其底层默认会请求 /v1/messages，因此 Base URL 只需填域名本身 https://hk.azy6.cc；
• 详细判定与检测方法可随时参考 4.1 自检命令与探活。

---

三、常用终端环境变量配置模版

如果您在终端或脚本中调用，可以通过导出环境变量实现免修改代码直连：

macOS / Linux (Bash / Zsh)

在 ~/.zshrc 或 ~/.bashrc 中追加：

# OpenAI 兼容协议（Codex、Cursor、OpenCode、通用 SDK）
export OPENAI_API_KEY="sk-您的实际Key"
export OPENAI_BASE_URL="https://hk.azy6.cc/v1"

# Anthropic Claude 官方协议（Claude Code 等）
export ANTHROPIC_API_KEY="sk-您的实际Key"
export ANTHROPIC_BASE_URL="https://hk.azy6.cc"

保存后执行 source ~/.zshrc 即可永久生效。

Windows PowerShell

在终端中临时设置：

# OpenAI 协议
$env:OPENAI_API_KEY = "sk-您的实际Key"
$env:OPENAI_BASE_URL = "https://hk.azy6.cc/v1"

# Anthropic 协议
$env:ANTHROPIC_API_KEY = "sk-您的实际Key"
$env:ANTHROPIC_BASE_URL = "https://hk.azy6.cc"

---

🔍

【界面截图】控制台查看一键接入参数与密钥

docs/public/images/apikey/06-view-config.png

参数已经全部就绪！接下来让我们进入第三章，针对不同的编程工具与客户端进行手把手配置：
👉 3.1 Codex 系列接入