联通云（联通元景）Token Plan 开源AI工具配置文档

文档来源：https://support.cucloud.cn/document/127/591/2357.html

说明：联通云Token Plan分为个人Lite版/团队版，仅OpenAI兼容接口，无Anthropic协议端点；国内贵阳节点网关，适配所有自定义OpenAI格式编程Agent、IDE插件。

全局核心基础配置

1 获取专属API Key

1. 登录联通云AISP元景平台：https://www.cucloud.cn
2. 进入【Token Plan】套餐页面完成订阅（个人Lite/团队版）
3. 套餐详情页复制独立专属API Key

区分：Token Plan与Coding Plan密钥、网关地址完全隔离，不可混用。

2 统一接口网关（仅OpenAI兼容）

参数	配置值
Base URL	https://aigw-gzgy2.cucloud.cn:8443/v1
完整对话接口	https://aigw-gzgy2.cucloud.cn:8443/v1/chat/completions
协议	仅支持OpenAI兼容，无Anthropic端点

3 接口测试示例

curl https://aigw-gzgy2.cucloud.cn:8443/v1/chat/completions \
-H "Authorization: Bearer 你的联通云TokenPlan密钥" \
-H "Content-Type: application/json" \
-d '{
  "model": "glm-5",
  "messages": [{"role":"user","content":"写一段Python快速排序代码"}]
}'

4 环境变量清理（必做，避免冲突）

# Mac/Linux
unset OPENAI_API_KEY
unset OPENAI_BASE_URL
# Windows PowerShell
$env:OPENAI_API_KEY=""
$env:OPENAI_BASE_URL=""

终端CLI编程工具

1 Claude Code（仅OpenAI兼容模式）

无官方Anthropic网关，只能切换OpenAI兼容模式接入

1. 安装

npm install -g @anthropic-ai/claude-code
claude --version

2. 跳过初始化登录 ~/.claude.json

{
  "hasCompletedOnboarding": true
}

3. settings.json 配置

{
  "env": {
    "OPENAI_BASE_URL": "https://aigw-gzgy2.cucloud.cn:8443/v1",
    "OPENAI_API_KEY": "你的联通云TokenPlan密钥",
    "API_TIMEOUT_MS": 600000,
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_MODEL": "glm-5"
  }
}

4. 使用

cd 项目文件夹
claude
# /status 校验接口连通性

2 OpenCode

1. 安装

npm install -g opencode-ai
opencode --version

2. 配置文件 opencode.config.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "cucloud-token/glm-5",
  "provider": {
    "cucloud-token": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "联通云Token Plan",
      "options": {
        "baseURL": "https://aigw-gzgy2.cucloud.cn:8443/v1",
        "apiKey": "你的联通云TokenPlan密钥"
      },
      "models": {
        "glm-5": {"limit":{"context":204800,"output":32768}},
        "MiniMax-M2.5": {"limit":{"context":128000,"output":32768}}
      }
    }
  }
}

3. 启动切换模型

opencode
/models

3 Codex CLI

1. 安装

npm i -g @openai/codex
codex --version

2. 配置 ~/.codex/config.toml

model = "glm-5"
model_provider = "cucloud-token"

[model_providers.cucloud-token]
name = "联通云Token Plan"
base_url = "https://aigw-gzgy2.cucloud.cn:8443/v1"
env_key = "CUCLOUD_TOKEN_KEY"
wire_api = "responses"

3. 环境变量

# Mac/Linux
export CUCLOUD_TOKEN_KEY="你的联通云TokenPlan密钥"
# Windows CMD
set CUCLOUD_TOKEN_KEY=你的联通云TokenPlan密钥

4. 启动

codex

4 OpenClaw

1. 安装 Mac/Linux

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell

iwr -useb https://openclaw.ai/install.ps1 | iex

2. 配置 ~/.openclaw/openclaw.json

{
  "models": {
    "mode": "merge",
    "providers": {
      "cucloud-token": {
        "baseUrl": "https://aigw-gzgy2.cucloud.cn:8443/v1",
        "apiKey": "你的联通云TokenPlan密钥",
        "api": "openai-completions",
        "models": [
          {
            "id": "glm-5",
            "name": "glm-5",
            "contextWindow": 204800,
            "maxTokens": 32768,
            "input": ["text"]
          },
          {
            "id": "MiniMax-M2.5",
            "name": "MiniMax-M2.5",
            "contextWindow": 128000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "cucloud-token/glm-5"
      }
    }
  },
  "gateway": {"mode":"local"}
}

3. 重启网关生效

openclaw gateway restart
# 终端面板
openclaw tui

5 DeepSeek-TUI（联通云原生适配工具）

1. 安装后编辑本地 ~/.deepseek/config.toml

api_key = "你的联通云TokenPlan密钥"
base_url = "https://aigw-gzgy2.cucloud.cn:8443/v1"
model = "deepseek-v4-flash"

VSCode IDE扩展

1 Cline

1. VSCode扩展市场搜索Cline安装
2. API Provider选择OpenAI Compatible

   配置项	值
   Base URL	https://aigw-gzgy2.cucloud.cn:8443/v1
   API Key	联通云TokenPlan密钥
   Model ID	glm-5 / deepseek-v4-flash

2 Kilo Code

1. 安装kilo code扩展
2. 设置 → 自定义供应商

   配置项	值
   API类型	OpenAI Compatible
   Base URL	https://aigw-gzgy2.cucloud.cn:8443
   API Key	Token Plan密钥
   模型	glm-5

3 Roo Code

1. 安装Roo Code插件
2. API Provider：OpenAI Compatible
3. BaseURL填入联通云网关地址，粘贴密钥，模型填写glm-5

桌面AI编辑器

Cursor（需Pro及以上）

1. 打开Cursor → Settings → Models
2. 开启Override OpenAI Base URL
3. OpenAI API Key填入联通TokenPlan密钥
4. Override地址：https://aigw-gzgy2.cucloud.cn:8443/v1
5. 自定义模型添加：glm-5、deepseek-v4-flash

切换官方GPT/Claude模型时，关闭Override开关

TRAE

1. 设置 → 模型 → 添加自定义OpenAI模型
2. Base URL：https://aigw-gzgy2.cucloud.cn:8443/v1
3. 填入Token Plan密钥，模型选择glm-5

通用工具模板（Dify/Cherry Studio）

适用于所有自定义OpenAI兼容第三方工具

参数	配置值
Base URL	https://aigw-gzgy2.cucloud.cn:8443/v1
API Key	联通云Token Plan专属密钥
请求路径	/chat/completions
默认模型	glm-5

Dify专项配置

1. 模型供应商新增「自定义OpenAI兼容」
2. API Base填写联通云网关地址
3. 填入密钥，绑定全部支持模型

CC Switch一键可视化配置

安装

macOS

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows：Releases下载.msi安装包

配置步骤

1. 打开CC Switch，右上角+新增供应商
2. 自定义OpenAI服务商，填入联通云Base URL
3. 粘贴Token Plan API Key
4. 默认模型设置glm-5，保存后一键同步所有本地CLI工具

支持完整模型列表

Model ID	模型名称	上下文窗口
glm-5	智谱GLM-5	204800
MiniMax-M2.5	MiniMax M2.5	128000
Qwen3.5-397B-A17B	通义千问3.5超大版	256000
Qwen3-235B-A22B	通义千问3	128000
DeepSeek-V4-Flash	DeepSeek极速版	1M
DeepSeek-V4-Pro	DeepSeek旗舰版	1M

套餐与计费说明

1. 个人Lite版：免费试用31天，有限Token额度，适合个人轻度编程
2. 团队版：按月订阅，团队额度共享，支持多人分配独立密钥
3. 计费规则：统一消耗套餐内Token积分，无错峰折扣
4. 权益：订阅赠送UniClaw智能体配套工具权限

关键注意事项

1. 网关唯一性：联通云Token Plan仅提供贵阳单节点aigw-gzgy2.cucloud.cn:8443，无其他地域地址
2. 无Anthropic接口：所有Claude系工具只能使用OpenAI兼容模式配置，不能填Anthropic域名
3. 密钥隔离：Token Plan、Coding Plan两套网关、两套密钥完全独立，混用鉴权失败
4. 网络要求：接口仅国内联通云节点可稳定访问，海外网络会超时/403拦截
5. 使用限制：套餐仅限交互式AI编程工具，禁止后端批量API调用，违规冻结密钥 6 端口443/8443需放行，防火墙拦截会导致请求超时