使用ESA加速Coding Plan或百炼API-边缘安全加速(ESA)-阿里云帮助中心

当某些业务采用固定Region部署的百炼API服务时，全球分布的终端用户跨境访问AI模型会显著增加网络延迟及网络不稳定性。通过ESA全球加速网络能够显著降低网络延迟和模型API的调用失败率，以提升AI模型的用户体验。

前提条件

您需要有一个用于ESA加速的域名。

步骤一：准备 Coding Plan API 域名

说明

同样适用于使用百炼按量计费的Base URL场景（https://dashscope.aliyuncs.com/xxxxxx）。

根据您的购买情况，选择对应的方式获取 Coding Plan API 域名。

已购买Coding Plan

如果您已经购买 Coding Plan 服务，可直接参考获取套餐专属 API Key 和 Base URL，查找 Coding Plan API 对应的域名（Base URL）：

OpenAI 兼容协议：https://coding.dashscope.aliyuncs.com/v1
Anthropic 兼容协议：https://coding.dashscope.aliyuncs.com/apps/anthropic

新购Coding Plan

访问Coding Plan 页面，根据实际需求选择并购买套餐。
参考获取套餐专属 API Key 和 Base URL，查找 Coding Plan API 对应的域名（Base URL）：
- OpenAI 兼容协议：https://coding.dashscope.aliyuncs.com/v1
- Anthropic 兼容协议：https://coding.dashscope.aliyuncs.com/apps/anthropic

步骤二：在 ESA 中配置 API 加速

在ESA控制台，选择站点管理，单击新增站点。
按照控制台指引添加您的域名，并购买付费套餐（基础版及以上套餐）完成域名添加，详细可参考将域名快速接入ESA。
选择DNS > 记录，单击添加记录，添加域名记录。
将源站配置为步骤一中获取的 Coding Plan API 域名，例如：coding.dashscope.aliyuncs.com：
- 记录类型：选择CNAME
- 主机记录：填入一个自定义的子域名的前缀，例如ali-coding-bj
- 代理状态：打开状态开关，开启代理加速
- 记录值/源站：选择域名
- 域名：输入coding.dashscope.aliyuncs.com
- 回源HOST：配置为跟随源站域名
配置回源端口固定为HTTPS 443端口：在左侧导航栏，选择规则 > 回源规则。单击新增规则。
参考下述配置完成回源设置：
- 规则名称：填入自定义的规则名称，如CodingPlan
- 如果请求匹配以下规则...：配置主机名等于，并填入新增的ali-coding-bj为前缀的域名
- 回源协议和端口：配置回源协议为HTTPS，HTTPS端口为443
配置智能路由提升全球请求成功率：在左侧导航栏，选择规则 > 网络优化规则。单击新增规则。
参考下述配置完成网络优化设置：
- 规则名称：填入自定义的规则名称，如smart-routing
- 如果请求匹配以下规则...：配置主机名等于，并填入新增的ali-coding-bj为前缀的域名
- 智能路由：单击开启开关。

步骤三：在 AI Agent 中使用加速域名

在 AI Agent 的配置中，使用 ESA 加速域名只需替换原始 API URL域名和协议部分。例如，将 https://coding.dashscope.aliyuncs.com/v1 替换为 http://ali-coding-bj.example.com/v1，其他相关配置不变。详细可参考接入AI工具。

说明

您可以申请免费边缘证书实现HTTPS访问。

示例代码：

OpenClaw配置

{
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        # 您需要将baseUrl字段替换为自定义的域名
        "baseUrl": "http://ali-coding-bj.example.com/v1",
        "apiKey": "{{YOUR_API_KEY}}",
        "api": "openai-completions",
        "models":[
          # 您的自定义模型信息
        ]
      }
    }
  }
  # 其他配置相关
}

Claude Code

macOS/Linux

创建并打开配置文件~/.claude/settings.json。
~ 代表用户主目录。如果 .claude 目录不存在，需要先行创建。可在终端执行 mkdir -p ~/.claude 来创建。
```
nano ~/.claude/settings.json
```

编辑配置文件，替换Base URL。

{    
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "{{YOUR_API_KEY}}",
        # 您需要将ANTHROPIC_BASE_URL字段替换为自定义的域名
        "ANTHROPIC_BASE_URL": "http://ali-coding-bj.example.com/apps/anthropic",
        "ANTHROPIC_MODEL": "{{MODEL}}" 
    }
}

保存配置文件，重新打开一个终端即可生效。

Windows

创建并打开配置文件C:\Users\您的用户名\.claude\settings.json。

CMD

创建目录

if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"

创建并打开文件

notepad "%USERPROFILE%\.claude\settings.json"

PowerShell

创建目录
```
mkdir -Force $HOME\.claude
```
创建并打开文件
```
notepad $HOME\.claude\settings.json
```

编辑配置文件，替换Base URL。

{    
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "{{YOUR_API_KEY}}",
        # 您需要将ANTHROPIC_BASE_URL字段替换为自定义的域名
        "ANTHROPIC_BASE_URL": "http://ali-coding-bj.example.com/apps/anthropic",
        "ANTHROPIC_MODEL": "{{MODEL}}" 
    }
}

保存配置文件，重新打开一个终端即可生效。

完成以上配置后，即可通过ESA加速AI模型服务。