---
title: 用阿里云百炼 Token Plan
nav: 阿里百炼
summary: 在中国大陆用阿里云百炼 Token Plan（千问）驱动 Agent J：key 贴进手机密钥卡、马上核对，用 OpenCode 或阿里自家的 Qwen Code，默认千问 3.8 Max 能看截图；买之前先看清数据条款。
order: 42
---
# 用阿里云百炼 Token Plan

阿里云百炼是阿里云的模型平台。Token Plan 个人版是它给编程工具用的包月套餐，以千问为主，也带智谱 GLM 和 DeepSeek 的模型。

还没决定用哪家？先看[按你用的模型选](/docs/models/)。安装、配对手机这些每家都一样的事，看[安装](/docs/install/)和[手机上怎么用](/docs/phone/)。

## 适合谁 {#who}

- 在中国大陆，已经是百炼用户：直接用。
- 想用阿里自家的 Qwen Code，或者希望贴完 key 马上知道对不对：选它。
- 还什么都没买、只想要一个最省事的：我们首推[火山方舟](/docs/ark/)。
- 在香港或海外：阿里国际站只有 Coding Plan Pro、每天限量，Agent J 也还没有它的一键配置。海外建议用 [Kimi](/docs/kimi/)。

## 开通与套餐 {#plan}

1. 用实名认证过的阿里云账号，打开百炼订阅页 https://bailian.console.aliyun.com/cn-beijing/subscription/overview 。
2. 订阅 **Token Plan 个人版**。分 Lite、Essential、Standard、Pro 四档，按 Credits 计量，每月额度分别是 11,500、25,500、45,000、180,000。只跑一个 Agent，选 Lite 或 Essential 就够；想同时跑 3 到 4 个，从 Standard 起。

价格以订阅页为准，四档的月价见百炼订阅页；`agentj provider bailian` 也会打印我们 2026-10-15 核对到的价格。官方说明见[Token Plan 个人版快速开始](https://help.aliyun.com/zh/model-studio/token-plan-personal-quick-start)。

**买之前先看清这几条条款：**

- 只能由你本人在编程工具里交互使用，不能拿去跑自动化脚本、当应用后端或批量调用，否则套餐或 key 可能被停用。
- **订阅期间，你给模型的输入和模型的输出会被阿里云用来改进模型。** 涉及隐私的资料要慎重。
- 只限订阅人本人用，不能分享。

## 拿 key {#key}

1. 在百炼控制台新建一把套餐专属 API Key。
2. **先别复制给任何人。** 等手机上弹出密钥卡再贴。

## 把 key 交给 Agent J {#hand-over}

跟电脑上的 Agent 说一句：帮我接上阿里百炼 Token Plan。它会这样做：

1. 运行下面这条，把百炼写进 OpenCode 的设置。你原来的设置一项都不动。

```bash
agentj provider bailian
```

2. 运行它打印出来的那条密钥卡命令。手机上会弹出密钥卡，名称是 `BAILIAN_TOKEN_PLAN_API_KEY`，你只把 key 贴进卡里。贴完 Agent J 马上用百炼只读的模型列表核对一次，不花 Credits。
3. 重启后台服务，再切到千问 3.8 Max：

```bash
agentj service restart
```

```bash
agentj agent switch opencode --model bailian-token-plan-personal/qwen3.8-max
```

密钥卡怎么用，见[手机上录入密钥](/docs/phone-admin/)。

## 能用的 AI 编程工具 {#tools}

两个都能用，同一把 key：

- **OpenCode（默认）**：上面那几步就是。没装 OpenCode 的，见[装好 AI 命令行工具](/docs/setup-agents/#opencode)。
- **Qwen Code（阿里自家的 `qwen`，Apache-2.0 开源）**：要 0.25 或更新，安装要 Node.js 20 以上，见[千问 Qwen Code](/docs/setup-agents/#qwen)。它的免费登录 2026-04-15 已经停了，key 就是它的登录：用上面那张 `BAILIAN_TOKEN_PLAN_API_KEY` 密钥卡。然后切过去：

```bash
agentj agent switch qwen
```

Agent J 只在内存里把 key 交给 Qwen Code，不往你的 Qwen 设置里写东西；你自己配过 Qwen Code 的，以你的设置为准。Qwen Code 只支持独立会话，每个权限请求都发到你手机上。更多见[换成 Qwen Code](/docs/switch-harness/#qwen)。

## 模型与看图 {#models}

| 用途 | 模型 | 能看截图 |
|---|---|---|
| 默认 | `qwen3.8-max` | 能（实测） |
| 省额度 | `qwen3.8-flash` | 能（实测） |
| 也能看图 | `qwen3.7-plus`、`qwen3.6-flash` | 能 |
| 不要当默认 | `qwen3.7-max` | 不能（实测） |
| 纯文本 | `glm-5.3`、`deepseek-v4-pro` | 不能 |

OpenCode 里模型写成 `bailian-token-plan-personal/<模型>`。“实测”指 2026-10-16 我们在电脑上发一张软件截图，让模型读出弹窗标题、错误码、按钮上的字和表格里的金额，OpenCode 和 Qwen Code 都全部读对。用 Qwen Code 时，手机上发 `/model` 会列出套餐里的模型，能看图的名字后面带着标记。

用纯文本模型时，手机截图、浏览器自动化看到的页面，模型都读不到。换回 `qwen3.8-max` 就行。

## 常见坑 {#pitfalls}

- **密钥卡核对没通过**：key 没复制完整，或者贴的不是套餐专属 key。回控制台重新完整复制一次，再弹一次密钥卡。
- **选了 `qwen3.7-max` 以后截图看不到**：它是纯文本模型，换回 `qwen3.8-max`。
- **手上是老的 Coding Plan（key 以 `sk-sp-` 开头）**：也能用，让 Agent 运行 `agentj provider bailian --plan coding-plan`。它没有 Max 模型，key 也没法事先核对。
- **定时任务、客服 bot**：条款只允许你本人交互使用。没人看着的活要用按量付费的 key，Agent J 不会把 Token Plan 的 key 交给它们。

## 切回原来的工具 {#switch-back}

随时跟 Agent 说“切回 Claude Code”（或 Codex），它会先检查、能用才切。也可以自己在电脑上运行：

```bash
agentj agent switch claude
```

想原样换回上一次切走前的那个：

```bash
agentj agent switch --undo
```

切换的细节见[换 AI 编程工具](/docs/switch-harness/)。

<details>
<summary>技术细节：地址和名字</summary>

- OpenCode 里的服务商名是 `bailian-token-plan-personal`。
- 只读核对用的模型列表：`https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/models`；Qwen Code 用的 OpenAI 兼容地址：`https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`。
- key 的环境变量名：`BAILIAN_TOKEN_PLAN_API_KEY`；老的 Coding Plan 是 `BAILIAN_CODING_PLAN_API_KEY`。

</details>
