京东云 Coding Plan 多开源AI编程工具配置完整文档

文档来源：京东云JoyBuilder 2.0官方套餐概览&快速接入文档

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

1. 订阅 Coding Plan 套餐

进入京东云JoyBuilder平台，购买 Lite / Pro 个人编程订阅套餐，企业需求请使用JoyBuilder标准API服务，不可使用Coding Plan。

2. 获取专属API Key（关键）

1. 控制台进入「Coding Plan专属API Key管理」页面
2. 创建 sk-sp- 开头专属密钥

重要区分：

• Coding Plan密钥：sk-sp-xxxx → 消耗套餐额度
• 平台通用API密钥：sk-xxxx → 按量扣费，严禁混用

3. 固定接口地址（二选一，按工具协议选择）

协议类型	Base URL（Coding Plan专用）	禁止使用地址
OpenAI兼容（绝大多数IDE插件/终端工具）	https://modelservice.jdcloud.com/coding/openai/v1	https://modelservice.jdcloud.com/v1（通用按量计费地址）
Anthropic兼容（Claude Code专用）	https://modelservice.jdcloud.com/coding/anthropic	同上

4. 支持模型完整列表（配置时直接复制名称）

模型名称	上下文窗口	最大输出长度	特殊说明
DeepSeek-V3.2	128k	64k	默认关闭思考，可手动开启
GLM-5	200k	32k	长周期Agent复杂工程任务
GLM-4.7	200k	128k	超长代码库解析旗舰模型
MiniMax-M2.5	200k	128k	强制开启深度思考
Kimi-K2.5	256k	32k	前端代码表现力强
Kimi-K2-Turbo	256k	32k	高速输出60-100 token/s
Qwen3-Coder	64k	8k	无深度思考功能，轻量代码生成

5. 通用强制规范（配置必看，违规封号/扣费）

1. 必须使用专属Base URL+sk-sp-密钥，混用通用地址会产生额外按量扣费、套餐不生效
2. 额度仅在文档内5款AI编程工具生效，普通API调用场景禁止使用，否则账号封禁
3. 多工具共享同一套餐额度，请求次数按底层模型调用计数（简单提问5-15次/复杂重构15-30次）
4. 套餐不支持退订；Lite可升级Pro，Pro不可降级，需等过期重购

---

二、各工具分步配置教程

工具1：Cursor（VS Code专属编辑器，OpenAI协议）

步骤1：打开Cursor设置

1. 启动Cursor → 点击右上角齿轮 Settings
2. 搜索 Models → 选择 Add custom model

步骤2：填写配置参数

• API Provider：OpenAI Compatible
• Base URL：https://modelservice.jdcloud.com/coding/openai/v1
• API Key：粘贴 sk-sp- 开头专属密钥
• Model Name：填入上表任意模型名（如GLM-4.7、DeepSeek-V3.2）

步骤3：保存验证

保存配置后，底部模型下拉框切换目标模型，输入代码提问测试调用，查看控制台用量是否扣除套餐额度。

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

步骤1：安装插件

VS Code扩展市场搜索 Roo Code，安装后重启编辑器

步骤2：接入自定义API

1. 左侧点击Roo Code图标 → Get Started
2. API Provider选择：OpenAI Compatible
3. 填入参数：
   • Base URL：https://modelservice.jdcloud.com/coding/openai/v1
   • API Key：sk-sp- 密钥
   • Model：自定义填写支持模型名称，勾选Use custom
4. 点击Finish完成配置，即可发起代码任务

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

步骤1：环境与安装

1. Node.js ≥ v18.0

# 全局安装
npm install -g opencode-ai
# 验证安装
opencode -v

步骤2：生成&修改配置文件

1. 执行初始化生成配置文件：

opencode config edit

2. 完整opencode.json标准配置模板（直接替换）

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "jdcloud-coding": {
      "npm": "@ai-sdk/openai",
      "options": {
        "baseURL": "https://modelservice.jdcloud.com/coding/openai/v1",
        "apiKey": "sk-sp-你的专属密钥"
      },
      "models": {
        "DeepSeek-V3.2": {
          "name": "DeepSeek-V3.2",
          "limit": {"context": 128000, "output": 64000}
        },
        "GLM-4.7": {
          "name": "GLM-4.7",
          "limit": {"context": 200000, "output": 128000}
        },
        "Kimi-K2-Turbo": {
          "name": "Kimi-K2-Turbo",
          "limit": {"context": 256000, "output": 32000}
        }
      }
    }
  },
  "defaults": {
    "model": "jdcloud-coding/GLM-4.7"
  }
}

步骤3：启动使用

# 进入项目目录启动
opencode

终端内输入编码需求，自动消耗Coding Plan套餐额度

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

步骤1：配置文件路径

主配置文件：~/.openclaw/openclaw.json 模型配置文件：~/.openclaw/agents/main/agent/models.json

步骤2：修改主配置openclaw.json核心片段

{
  "models": {
    "providers": {
      "jd-coding": {
        "baseUrl": "https://modelservice.jdcloud.com/coding/openai/v1",
        "apiKey": "sk-sp-你的密钥"
      }
    },
    "defaults": {
      "primary": "jd-coding/GLM-4.7"
    }
  }
}

步骤3：重启网关生效

openclaw gateway restart
# 验证配置合法性
openclaw config validate

排坑提醒：两处配置文件Base URL必须统一为Coding Plan专用地址，错填通用地址会扣费不扣套餐

工具5：Claude Code（终端Agent，Anthropic专属协议）

步骤1：安装工具

# npm全局安装
npm install -g @anthropic-ai/claude-code
# Windows PowerShell
winget install Anthropic.ClaudeCode

步骤2：环境变量配置（推荐，避免明文存密钥）

Linux/macOS

export ANTHROPIC_BASE_URL="https://modelservice.jdcloud.com/coding/anthropic"
export ANTHROPIC_API_KEY="sk-sp-你的专属密钥"

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://modelservice.jdcloud.com/coding/anthropic"
$env:ANTHROPIC_API_KEY="sk-sp-你的专属密钥"

步骤3：启动使用

进入项目目录执行：

claude

对话内通过/model命令切换支持模型（DeepSeek-V3.2、GLM系列等）

---

三、套餐额度规则说明（配置后参考）

1. 用量限额

套餐	5小时限额	每周限额	月度限额
Lite	1200次请求	9000次请求	18000次请求
Pro	6000次请求	45000次请求	90000次请求

单次提问底层多次调用，额度实时在控制台查看

2. 额度刷新周期

1. 5小时限额：滑动窗口动态刷新
2. 周限额：每周一00:00自动重置
3. 月限额：订阅月首日00:00重置，额度耗尽仅等待周期恢复，不扣余额

3. 有效期规则

购买当日起算自然月，例：1.31购买1个月，2.28到期；2.1购买3.1到期。

---

四、常见报错&排错指南

1. 不消耗套餐、产生按量扣费
   • 原因：Base URL填通用地址、API Key使用普通sk-密钥
   • 解决：替换为Coding Plan专属URL+sk-sp-密钥
2. 调用403/账号封禁
   • 原因：用于非AI编程工具、API批量爬虫调用
   • 解决：仅在文档5款工具使用，停止违规调用联系客服解封
3. 模型不存在报错
   • 原因：模型名称输入错误、使用未支持模型
   • 解决：严格复制文档内模型名称，不可自定义别名
4. 额度充足但请求被限制
   • 原因：触发5小时滑动窗口限流
   • 解决：等待窗口刷新或升级Pro套餐提升限额

五、官方参考链接

1. 套餐概览：https://docs.jdcloud.com/cn/jdaip/PackageOverview
2. 快速接入文档：https://docs.jdcloud.com/cn/jdaip/Quickstart
3. OpenCode配置文档：https://docs.jdcloud.com/cn/jdaip/OpenCode
4. 错误码查询：文档内「错误码」索引页面