Appearance
联通云Coding Plan 全开源AI工具统一配置文档
一、基础核心通用配置
1.1 密钥获取说明
- 登录联通云AISP元景控制台（https://console.cucloud.cn）；
- 订阅 Coding Plan Lite/Pro 套餐，获取Coding Plan专属API Key；
- 密钥独立隔离，与联通云Token Plan、按量计费密钥完全不互通，严禁混用。
硬性规则：仅限 Claude Code、OpenClaw、IDE 插件等交互式编程工具使用，禁止后端批量调用、脚本自动化调用，违规直接封禁密钥且不支持退款。
1.2 多地域双协议网关（官方正品）
联通云Coding Plan同时支持 OpenAI、Anthropic 双兼容协议，分多地域节点，贵阳二区为首选推荐（模型最全、稳定性最高）。
贵阳二区（主力节点，推荐所有工具优先使用）
Anthropic协议（Claude Code/OpenClaw优先）：
https://aigw-gzgy2.cucloud.cn:8443OpenAI协议（IDE/通用CLI工具）：
https://aigw-gzgy2.cucloud.cn:8443/v1
济南五区（仅MiniMax-M2.5模型可用）
Anthropic协议：
https://aigw-jnzs5.cucloud.cn:8443OpenAI协议：
https://aigw-jnzs5.cucloud.cn/v1
1.3 优先推荐模型
aisp-auto-route（智能调度模型，首选）：平台自动识别负载，动态分配最优模型，完美解决高峰期限流、卡顿问题，无需手动切换模型。 备用固定模型：glm-5.1、DeepSeek-V4-Flash、Qwen3.6-27B、kimi-k2.6
1.4 接口快速测试命令
bash
curl https://aigw-gzgy2.cucloud.cn:8443/v1/chat/completions \
-H "Authorization: Bearer 你的CodingPlan密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "aisp-auto-route",
"messages": [{"role":"user","content":"写一个Python快速排序"}]
}'1.5 环境冲突清理（必做）
清空系统旧环境变量，避免覆盖工具本地配置
bash
# macOS / Linux
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN
unset OPENAI_BASE_URL OPENAI_API_KEY
# Windows PowerShell
$env:ANTHROPIC_BASE_URL=""
$env:ANTHROPIC_AUTH_TOKEN=""
$env:OPENAI_BASE_URL=""
$env:OPENAI_API_KEY=""二、终端CLI编程工具完整配置
2.1 Claude Code（优先Anthropic协议，最优适配）
安装命令
bash
npm install -g @anthropic-ai/claude-code跳过登录配置（~/.claude.json）
json
{
"hasCompletedOnboarding": true
}核心配置（~/.claude/settings.json）
json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的CodingPlan密钥",
"ANTHROPIC_BASE_URL": "https://aigw-gzgy2.cucloud.cn:8443",
"ANTHROPIC_MODEL": "aisp-auto-route",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "DeepSeek-V4-Flash",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "aisp-auto-route",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1",
"API_TIMEOUT_MS": 600000,
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
}
}使用：终端输入 claude，/status 校验配置，/compact 压缩会话防限流
2.2 OpenCode（OpenAI协议）
安装命令
bash
npm install -g opencode-ai配置文件（opencode.config.json）
json
{
"$schema": "https://opencode.ai/config.json",
"model": "cucloud-coding/aisp-auto-route",
"provider": {
"cucloud-coding": {
"npm": "@ai-sdk/openai-compatible",
"name": "联通云Coding Plan",
"options": {
"baseURL": "https://aigw-gzgy2.cucloud.cn:8443/v1",
"apiKey": "你的CodingPlan密钥"
},
"models": {
"aisp-auto-route": {"limit":{"context":1024000,"output":32768}},
"glm-5.1": {"limit":{"context":1024000,"output":32768}},
"DeepSeek-V4-Flash": {"limit":{"context":200000,"output":32768}}
}
}
}
}使用：opencode 启动，/models 切换模型
2.3 Codex CLI（OpenAI协议）
安装命令
bash
npm i -g @openai/codex配置文件（~/.codex/config.toml）
toml
model = "aisp-auto-route"
model_provider = "cucloud-coding"
[model_providers.cucloud-coding]
name = "联通云Coding Plan"
base_url = "https://aigw-gzgy2.cucloud.cn:8443/v1"
env_key = "CUCLOUD_CODING_KEY"
wire_api = "responses"环境变量临时生效
bash
# Mac/Linux
export CUCLOUD_CODING_KEY="你的CodingPlan密钥"
# Windows CMD
set CUCLOUD_CODING_KEY=你的CodingPlan密钥2.4 OpenClaw（双协议兼容）
安装命令
bash
# Mac/Linux
curl -fsSL https://openclaw.ai/install.sh | bash
# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex核心配置（~/.openclaw/openclaw.json）
json
{
"models": {
"mode": "merge",
"providers": {
"cucloud-coding": {
"baseUrl": "https://aigw-gzgy2.cucloud.cn:8443/v1",
"apiKey": "你的CodingPlan密钥",
"api": "openai-completions",
"models": [
{"id":"aisp-auto-route","name":"aisp-auto-route","contextWindow":1000000,"maxTokens":32768},
{"id":"glm-5.1","name":"glm-5.1","contextWindow":1000000},
{"id":"DeepSeek-V4-Flash","name":"DeepSeek-V4-Flash","contextWindow":200000}
]
}
}
},
"agents": {"defaults":{"model":{"primary":"cucloud-coding/aisp-auto-route"}}},
"gateway": {"mode":"local"}
}生效命令：openclaw gateway restart && openclaw tui
2.5 Hermes Agent
终端执行 hermes model，选择自定义节点，填写： BaseURL：https://aigw-gzgy2.cucloud.cn:8443/v1 API Key：CodingPlan专属密钥 默认模型：aisp-auto-route
三、VSCode IDE插件统一配置
3.1 Cline / Roo Code
| 配置项 | 填写内容 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://aigw-gzgy2.cucloud.cn:8443/v1 |
| API Key | 联通云CodingPlan密钥 |
| 默认模型 | aisp-auto-route |
3.2 Kilo Code
插件设置-自定义供应商，参数同上，保存后重启插件生效。
四、桌面AI编辑器配置
4.1 Cursor（Pro及以上）
1. Settings → Models，开启 Override OpenAI Base URL； 2. BaseURL：https://aigw-gzgy2.cucloud.cn:8443/v1； 3. 填入CodingPlan密钥，自定义添加模型 aisp-auto-route、glm-5.1； 注意：使用官方模型需关闭Override开关。
4.2 TRAE
设置-模型-添加自定义OpenAI模型，填写上述统一网关、密钥、自动调度模型即可。
五、通用工具模板（Dify/Cherry Studio/CC Switch）
5.1 通用固定参数
| 参数 | 配置值 |
|---|---|
| 接口地址 | https://aigw-gzgy2.cucloud.cn:8443/v1 |
| 密钥 | CodingPlan专属Key |
| 请求路径 | /chat/completions |
| 默认模型 | aisp-auto-route |
5.2 CC Switch一键配置
新增自定义服务商，填入双协议网关、密钥，默认模型设为自动调度，一键同步所有本地工具配置，无需手动改文件。
六、套餐额度与计费规则
| 套餐版本 | 月费 | 5小时限额 | 周限额 | 月总请求 |
|---|---|---|---|---|
| Coding Plan-Lite | 40元 | 1200次 | 9000次 | 18000次 |
| Coding Plan-Pro | 200元 | 6000次 | 45000次 | 90000次 |
额度说明：简单任务消耗5-10次请求，复杂重构任务消耗10-30+次； 套餐规则：单账号仅可订阅1个套餐、只可升级不可降级、购买后不支持退款； 限流策略：高峰期自动调度模型兜底，无需手动切换。
七、支持模型清单与限制
aisp-auto-route：智能调度首选，全场景适配，自动规避限流
glm-5.1 / glm-5：稳定代码模型，1M超长上下文，日常开发首选
DeepSeek-V4-Flash：极速推理，尝鲜模型，高峰期易限流（上下文仅200K）
Qwen3.6-27B / Qwen3.5系列：通用代码生成、架构设计
kimi-k2.6 / k2.5：擅长长文件解析、代码阅读理解
MiniMax-M2.5：仅济南五区网关支持
八、常见问题与排错方案
401鉴权失败：核对密钥为CodingPlan专属，未混用TokenPlan/按量密钥，核对8443端口网关
429限流报错：执行会话压缩、切换glm-5.1模型、等待5小时额度重置
模型响应慢/超时：放弃Flash模型，使用auto-route自动调度，避开高峰时段
无法抵扣套餐：确认网络为国内环境、端口8443已放行、工具为合规交互式编程工具
官方文档来源：https://support.cucloud.cn/document/127/591/2357.html
文档更新时间：2026-05-22