京东云 TokenPlan 全开源AI编程工具配置文档

文档来源：京东云JoyBuilder 2.0 TokenPlan官方文档

前置说明区分

1. TokenPlan：通用订阅制额度套餐，支持全场景API调用、全模型，分个人版/企业版，不限定仅编程工具；
2. Coding Plan：仅面向5款编程工具的请求次数订阅套餐，二者API Key、Base URL不互通，不可混用。

一、全局前置准备（所有工具通用）

1. 产品基础信息

TokenPlan为预购Credits额度订阅服务，1个API Key可调用平台全部支持模型，额度用完自动停止，无超额账单；兼容OpenAI、Anthropic双协议，可接入Cursor、Roo Code、OpenCode、OpenClaw、Claude Code五大开源编程工具。

个人版 vs 企业版

维度	个人版TokenPlan	企业版TokenPlan
使用对象	单人开发者	企业团队/部门
API Key	1个订阅绑定1个Key	1席位1个独立Key，最多50席位
订阅限制	同一时间仅1个生效订阅	多席位、多订阅并行
开通方式	控制台直接购买	白名单受邀开通

2. 获取专属鉴权凭证

1. 登录JoyBuilder 2.0控制台 → 订阅服务 → TokenPlan购买对应套餐
2. 进入订阅管理页面，生成TokenPlan专属API Key
   • 注意：TokenPlan密钥、按量付费密钥、Coding Plan密钥三者完全不互通，混用会扣费失败/报错
3. 额度查看：控制台订阅页实时查看剩余Credits消耗

3. 统一调用Base URL（协议区分）

兼容协议	TokenPlan专用Base URL	适用工具
OpenAI兼容协议	https://modelservice.jdcloud.com/v1	Cursor、Roo Code、OpenCode、OpenClaw
Anthropic兼容协议	https://modelservice.jdcloud.com/anthropic	Claude Code

4. TokenPlan支持完整模型清单（配置直接复制Model ID）

Model ID	厂商	上下文窗口	最大输出	Credits消耗系数	适用场景
GLM-5.1	智谱AI	200K	128K	2	Agent、代码生成、通用对话
GLM-5.2	智谱AI	1M	128K	2	复杂推理、代码调试、数学演算
Kimi-K2.6	月之暗面	256K	32K	1.5	长文档解析、合同分析、长代码阅读
MiniMax-M3	MiniMax	1M	512K	1	图文多模态、图表提取、图片转代码
DeepSeek-V4-Flash	DeepSeek	1024K	384K	0.25	高速批量代码、低成本日常调用
DeepSeek-V4-Pro	DeepSeek	1024K	384K	2	复杂系统代码、学术论文分析
maas-token-latest	智能路由别名	-	-	动态匹配	无固定模型需求，自动分配最优模型

5. 核心使用规范

1. 无工具限制：TokenPlan支持任意API/工具调用，不限制仅编程工具；
2. 鉴权三要素必须匹配：TokenPlan专属API Key + 对应协议Base URL + 上表标准Model ID；
3. Credits消耗规则：不同模型系数不同，实际消耗=输入Token+输出Token × 模型系数；
4. 额度生命周期：订阅周期内Credits永久有效，用完可续费叠加额度。

二、五大开源编程工具分步配置教程

工具1：Cursor（独立AI编辑器，OpenAI协议）

1. 打开Cursor → 右上角齿轮「Settings」→ 搜索Models → 点击Add custom model
2. 参数填写：
   • Provider：OpenAI Compatible
   • Base URL：https://modelservice.jdcloud.com/v1
   • API Key：TokenPlan订阅生成的专属密钥
   • Model Name：填写模型ID（如DeepSeek-V4-Pro、maas-token-latest）
3. 保存配置，底部模型下拉框切换目标模型，发起代码提问，控制台核对Credits消耗。

工具2：Roo Code（VS Code开源插件，OpenAI协议）

1. VS Code扩展市场搜索Roo Code安装，重启编辑器
2. 左侧打开Roo Code面板 → Get Started
3. API服务商选择：OpenAI Compatible
4. 填入配置：
   • Base URL：https://modelservice.jdcloud.com/v1
   • API Key：TokenPlan密钥
   • Model：自定义输入标准Model ID，勾选Use custom model
5. 完成配置，创建代码任务验证调用。

工具3：OpenCode（终端CLI编程工具，OpenAI协议）

环境前置：Node.js ≥ v18

1. 全局安装工具

npm install -g opencode-ai
opencode -v # 校验安装成功

2. 打开配置文件

opencode config edit

3. 完整TokenPlan配置模板（替换密钥即可使用）

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "jdcloud-token-plan": {
      "npm": "@ai-sdk/openai",
      "options": {
        "baseURL": "https://modelservice.jdcloud.com/v1",
        "apiKey": "你的TokenPlan专属API Key"
      },
      "models": {
        "GLM-5.1": {"context":200000,"output":128000},
        "DeepSeek-V4-Flash": {"context":1024000,"output":384000},
        "maas-token-latest": {"context":"auto","output":"auto"}
      }
    }
  },
  "defaults": {
    "model": "jdcloud-token-plan/maas-token-latest"
  }
}

4. 项目目录启动工具

opencode

工具4：OpenClaw（开源Agent终端工具，OpenAI协议）

1. 核心配置文件路径
   • 主配置：~/.openclaw/openclaw.json
2. 写入TokenPlan服务商配置片段

{
  "models": {
    "providers": {
      "jd-token-plan": {
        "baseUrl": "https://modelservice.jdcloud.com/v1",
        "apiKey": "你的TokenPlan API Key",
        "api": "openai-completions"
      }
    },
    "defaults": {
      "primary": "jd-token-plan/DeepSeek-V4-Pro"
    }
  }
}

3. 重启网关并校验配置合法性

openclaw gateway restart
openclaw config validate

工具5：Claude Code（Anthropic协议终端工具）

两种配置方式（推荐环境变量，避免明文存储密钥）

方式A：环境变量（临时生效，终端重启失效）

Mac / Linux

export ANTHROPIC_BASE_URL="https://modelservice.jdcloud.com/anthropic"
export ANTHROPIC_API_KEY="你的TokenPlan专属API Key"

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://modelservice.jdcloud.com/anthropic"
$env:ANTHROPIC_API_KEY="你的TokenPlan专属API Key"

方式B：持久化配置文件

路径：~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://modelservice.jdcloud.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的TokenPlan API Key",
    "ANTHROPIC_MODEL": "GLM-5.2"
  }
}

3. 项目目录启动，切换模型命令

claude
/model Kimi-K2.6

三、套餐额度与续费规则

1. Credits额度：预购固定额度，消耗完毕停止调用，可续费叠加额度，无时间过期清零限制；
2. 计费逻辑：实际消耗Token × 对应模型系数 = 扣除Credits数量；
3. 个人版限制：仅同时持有1个生效订阅，如需更换套餐需到期后重新购买；
4. 企业版：多席位独立Key、独立额度，支持团队分账号管控用量。

四、常见问题排错指南

1. 鉴权401失败
   • 原因：混淆TokenPlan/Coding Plan/按量付费密钥、Base URL协议填错（Claude误用/v1地址）
   • 解决：控制台重新复制TokenPlan密钥，核对工具对应协议Base URL。
2. model not found 模型不存在
   • 原因：自定义模型别名、输入错误Model ID、使用Coding Plan专属旧模型
   • 解决：严格使用文档内标准Model ID，可使用maas-token-latest通用路由。
3. 不消耗TokenPlan额度，产生按量扣费
   • 原因：使用按量付费通用API Key，而非TokenPlan订阅密钥
   • 解决：切换订阅页面生成的专属tp密钥。
4. MiniMax-M3图文调用报错
   • 原因：工具未开启多模态上传，或上下文窗口超限
   • 解决：切换支持图片输入的工具，缩短输入上下文长度。
5. 调用限流/响应缓慢
   • 解决：切换DeepSeek-V4-Flash高速模型，降低Credits消耗同时提升速度。

五、官方参考链接

1. TokenPlan产品概述：https://docs.jdcloud.com/cn/jdaip/tokenplan-overview
2. JoyBuilder平台总文档：https://docs.jdcloud.com/cn/jdaip/
3. API Key创建指南：https://docs.jdcloud.com/cn/jdaip/Get API-Key
4. 错误码查询：JoyBuilder帮助中心-错误码索引页面