在魔搭 Notebook 容器里跑 Qwen Code：从零配置到省魔粒的完整实践

- [一、为什么要在魔搭容器里跑 Qwen Code](#一、为什么要在魔搭容器里跑 Qwen Code)
- [二、先把账算清楚：2026 年的免费规则已经变了](#二、先把账算清楚：2026 年的免费规则已经变了)
- - [2.1 Qwen Code 客户端的免费 OAuth 已经没了](#2.1 Qwen Code 客户端的免费 OAuth 已经没了)
  - [2.2 魔搭 API-Inference 改成了"魔粒"计量](#2.2 魔搭 API-Inference 改成了"魔粒"计量)
- 三、前置准备：三步，卡人的是第二步
- - [3.1 注册魔搭账号](#3.1 注册魔搭账号)
  - [3.2 绑定阿里云账号 + 实名认证（这步不做，接口直接报错）](#3.2 绑定阿里云账号 + 实名认证（这步不做，接口直接报错）)
  - [3.3 创建 Access Token](#3.3 创建 Access Token)
- [四、启动容器和 Qwen Code](#四、启动容器和 Qwen Code)
- - [4.1 进入工作目录](#4.1 进入工作目录)
  - [4.2 启动 qwen](#4.2 启动 qwen)
- 五、配置模型服务（核心步骤）
- - [5.1 模型怎么选（直接关系到你能用多久）](#5.1 模型怎么选（直接关系到你能用多久）)
  - [5.2 填完之后](#5.2 填完之后)
- 六、让它真的会干活
- - [6.1 生成项目上下文](#6.1 生成项目上下文)
  - [6.2 权限模式](#6.2 权限模式)
  - [6.3 常用命令](#6.3 常用命令)
- 七、省魔粒的六个实操技巧
- - [7.1 卡档位，不卡参数](#7.1 卡档位，不卡参数)
  - [7.2 撞 429 就换模型，别重试](#7.2 撞 429 就换模型，别重试)
  - [7.3 勤用 /compress](#7.3 勤用 /compress)
  - [7.4 别在网页端同时折腾](#7.4 别在网页端同时折腾)
  - [7.5 用 /v1/models 免费查模型 ID](#7.5 用 /v1/models 免费查模型 ID)
  - [7.6 一次说清楚，别试探](#7.6 一次说清楚，别试探)
- [八、固化配置：不想每次都走 /auth](#八、固化配置：不想每次都走 /auth)
- [九、扩展能力：装 Skill](#九、扩展能力：装 Skill)
- 十、常见报错排查
- 十一、如果魔粒实在不够用
- 小结

一、为什么要在魔搭容器里跑 Qwen Code

本地装一套 AI 编程环境，最烦的从来不是装 CLI，而是：Python 版本打架、Node 版本不对、跑个脚本还要配 GPU。魔搭 Notebook 把这些问题一次性抹掉了：

开箱即用 ：JupyterLab + WebIDE + Terminal 三件套，工作目录固定挂在 /mnt/workspace
算力免费：CPU 资源免费，新用户注册还能领 GPU 时长
沙箱隔离：改坏了、装崩了，重开一个实例就干净了，不污染本地
国内直连：不用折腾网络

Qwen Code 是阿里开源的终端 AI 编程 Agent（Apache-2.0），原本 fork 自 Google 的 Gemini CLI，现在已经独立演进。它和魔搭是同一家生态，配套起来最顺。

二、先把账算清楚：2026 年的免费规则已经变了

这一段很重要，因为网上大部分教程还在写旧规则。

2.1 Qwen Code 客户端的免费 OAuth 已经没了

Qwen Code 曾经有一个非常香的免费额度：用 qwen.ai 账号 OAuth 登录，每天 2000 次请求（2026 年 2 月降到 1000 次）。这个通道已于 2026 年 4 月 15 日正式停用 ，现在在 /auth 里已经选不到它了。

所以第一次启动时看到的第一个选项 Alibaba ModelStudio，下面写的是「Coding Plan, Token Plan, or Standard API Key」------ 全是付费或自带 Key 的路径，没有免费额度。

Qwen Code 软件本身仍然免费开源，花钱的只是模型推理。

2.2 魔搭 API-Inference 改成了"魔粒"计量

魔搭的免费推理接口以前是「每天 2000 次调用」，2026 年改成了魔粒扣费制：账户里有魔粒就能调，扣多少看模型档位。

魔粒怎么来（以站内「我的魔粒」页面实时规则为准）：

来源	数量	有效期
注册后每日登录	+200	当天
绑定阿里云账号后每日登录	+50	当天
点赞 / 收藏（每次 +2，日上限 20 次）	+40	当天
验证邮箱 / 编辑个人介绍 / 配置个人主页	各 +50，共 150	90 天

也就是说，正常账号每天固定拿到 250 魔粒，加上社区互动能到 290 左右。

魔粒怎么花（API-Inference 每次调用扣减）：

档位	单次扣减	典型模型
轻量	0.5 魔粒	小参数 Flash 类
主流	1 魔粒	Qwen3-Coder-30B-A3B-Instruct
旗舰	2 魔粒	480B 级别大模型

换算一下：250 魔粒 ≈ 主流模型 250 次调用，或旗舰模型 125 次。

两个必须知道的坑：

短期魔粒当天有效，不结转。今天没用完，明天清零。
魔粒是全平台共用的。你在网页上生了几张图、跑了一次训练，今天留给代码的就少一截。

三、前置准备：三步，卡人的是第二步

3.1 注册魔搭账号

打开 modelscope.cn，手机号 / GitHub / 阿里云账号都能注册。

3.2 绑定阿里云账号 + 实名认证（这步不做，接口直接报错）

免费推理的算力是阿里云出的，所以官方强制要求：魔搭账号必须绑定阿里云账号 ，且该云账号已通过实名认证。

路径：右上角头像 → 绑定阿里云账号 → 授权（权限要选「全部权限」，只选只读会授权失败）→ 按提示完成实名。

这一步是绝大多数人第一次调不通的真正原因，别跳过。

3.3 创建 Access Token

打开 modelscope.cn/my/myaccesstoken（个人中心 → 访问令牌），新建一个令牌：

权限选写权限
有效期选长期有效
复制出来的字符串以 ms- 开头

这个 Token 等同于你账号的钥匙。不要截图外发、不要提交到 Git 仓库、不要贴进公开的文章里。

四、启动容器和 Qwen Code

4.1 进入工作目录

Notebook 实例启动后，点终端面板右上角的加号新建 Terminal，切换到 /mnt/workspace：

bash 复制代码

cd /mnt/workspace

这是魔搭给你持久化的目录，重启实例内容还在，项目放这儿。

4.2 启动 qwen

bash 复制代码

qwen

魔搭的 Notebook 镜像里已经预装好了 Qwen Code，直接输命令就能起。

第一次启动它会自动更新 ，等大约 10 秒看到 Update successful 之后再继续。如果更新完卡住或者异常，按下面这样做：

关掉当前终端
点终端面板加号新建一个 Terminal
重新 cd /mnt/workspace 再 qwen

原因是更新过程替换了正在运行的可执行文件，旧进程不会自己重载。

如果提示 command not found，说明当前镜像没预装，手动装一次（Node 22+）：

bash 复制代码

npm install -g @qwen-code/qwen-code
qwen

五、配置模型服务（核心步骤）

启动后你会看到这样的连接服务商选择界面：


*首次启动时的 `/auth` 界面。注意顶部状态栏显示 `未知	coder-model`------表示当前还没接上任何模型服务。下面三个选项里，前两个都需要付费套餐或已有 API Key，免费用户走第三个。*

选第三项 Custom Provider，因为魔搭的接口不在内置列表里。三个选项的差别：

选项	界面上的说明	免费用户能用吗
Alibaba ModelStudio	Coding Plan / Token Plan / Standard API Key	❌ 前两个是付费套餐，第三个要自备 Key
Third-party Providers	接一个内置的服务商，用 API Key 连接	❌ 得先有那家的 Key
Custom Provider	手动接本地服务、代理或不支持的服务商	✅ 走这里接魔搭

选完 Custom Provider 后，下一步再选 OpenAI-compatible Provider------意思是目标服务采用兼容 OpenAI 的接口协议，魔搭的 API-Inference 正是这种。

然后按顺序填三个东西：

配置项	填入内容
Base URL	`https://api-inference.modelscope.cn/v1/`
API Key	第 3.3 步复制的 `ms-` 开头 Token
Model	魔搭上的完整 Model-Id，见下表

Model 必须带组织前缀 ，比如 Qwen/Qwen3-Coder-30B-A3B-Instruct，不能只写 Qwen3-Coder-30B-A3B-Instruct，否则报 404。

5.1 模型怎么选（直接关系到你能用多久）

用途	推荐 Model-Id	档位
日常编码（首选）	`Qwen/Qwen3-Coder-30B-A3B-Instruct`	主流
通用对话、够快	`deepseek-ai/DeepSeek-V4-Flash-0731`	主流
轻量问答、改文案	`ZhipuAI/GLM-4.7-Flash`	轻量
复杂重构（慎用）	480B / 旗舰级模型	旗舰，2 粒/次

新手最容易犯的错一上来就选最大的模型，结果跑两个任务就烧光今天的额度。日常改动老老实实 30B，只有真需要处理超长上下文或复杂推理时才切旗舰。

5.2 填完之后

后面的配置项（超时、上下文长度等）连按两次回车用默认值即可。配置完会写入持久化目录，实例重启通常不用重配。

回到对话界面后，随时用 /model 切换模型：

复制代码

/model

六、让它真的会干活

6.1 生成项目上下文

进项目根目录后执行一次：

复制代码

/init

它会扫描代码库、生成一份 QWEN.md 描述项目结构和技术栈。后续对话它会自动读这份文件，比每次手动解释省事得多。

6.2 权限模式

Qwen Code 默认对每个文件写操作都要你确认，安全但烦。在容器这种一次性环境里，可以开 yolo 模式：

复制代码

/approval-mode yolo

⚠️ 它会跳过所有确认直接执行命令和改文件。只建议在魔搭容器这种可随时重置的沙箱里用，本地跑生产代码千万别开。

6.3 常用命令

命令	作用
`/help`	看帮助
`/init`	扫描项目生成 QWEN.md
`/model`	切换模型
`/auth`	重新配置模型服务
`/compress`	压缩会话历史，省 token / 省额度
`/status`	看当前会话的 token 用量
`/clear`	清空历史
`/exit` 或 `/quit`	退出

快捷键：Ctrl+C 取消当前操作，Ctrl+D（空行时）退出。

七、省魔粒的六个实操技巧

这部分才是日常能不能用得下去的关键。

7.1 卡档位，不卡参数

同样是 Qwen3-Coder，30B 和 480B 的扣费差了整整一档（1 粒 vs 2 粒）。日常 90% 的活 30B 都能干，别为了一点边际提升把额度砍半。

7.2 撞 429 就换模型，别重试

魔粒耗尽或单模型当日上限打满，接口返回 429。这时候反复重试只会浪费时间，直接 /model 换一个不同家的模型（比如从 Qwen 切到 DeepSeek-V4-Flash），额度池是分开算的。

7.3 勤用 /compress

Agent 的上下文会越滚越长，每一轮都把历史重新发一遍。任务做到一半觉得变慢了、变贵了，/compress 一下能省掉一大截。

7.4 别在网页端同时折腾

魔粒全平台共用。你一边在模型页点「一键生成」生图，一边跑 Qwen Code，两边抢同一份额度。写代码的时候就把网页生成关掉。

7.5 用 /v1/models 免费查模型 ID

模型名写错会报 404，反复试错纯属浪费额度。先跑这条命令确认模型在不在清单里------它不校验身份、不消耗魔粒：

bash 复制代码

curl https://api-inference.modelscope.cn/v1/models

返回的 data[].id 就是可用的完整 Model-Id，直接复制过来用。

7.6 一次说清楚，别试探

免费额度下最贵的不是 token，是你来回试探的轮次。想清楚要什么，一次把需求、约束、期望结果说明白，让 Agent 一把做完，比反复"再改改"省得多。

八、固化配置：不想每次都走 /auth

如果嫌每次新开实例都要重配，可以直接用环境变量（Qwen Code 支持 OpenAI 兼容变量的方式）：

bash 复制代码

export OPENAI_API_KEY="ms-你的token"
export OPENAI_BASE_URL="https://api-inference.modelscope.cn/v1"
export OPENAI_MODEL="Qwen/Qwen3-Coder-30B-A3B-Instruct"

写进 ~/.bashrc 就能每次自动生效。不过要注意：在 Notebook 里这么写等于把 Token 明文留在容器里，个人独占的实例问题不大，共享实例别这么干。

九、扩展能力：装 Skill

魔搭的模型生态 + Qwen Code 的 Skill 机制能组合出不少玩法。比如专门针对 Notebook 场景的 Skill，能让它读懂并修改 .ipynb 文件：

bash 复制代码

modelscope skills add VoyagerX/modelscope-notebook-develop

装完之后，像「给 Notebook 新增一个 cell」「调试这段代码」这类任务它会做得更准，不用你反复解释 notebook 的 JSON 结构。

十、常见报错排查

现象	原因	处理
401 `Authentication failed... valid ModelScope token`	Token 复制不全 / 失效，或用了 Anthropic 协议却带了 `ms-` 前缀	重新复制完整 Token；部分工具走 Anthropic 协议时需去掉 `ms-`
提示需要绑定阿里云账号	没绑或没实名	头像 → 绑定阿里云 → 完成实名
429	当日魔粒用完，或该模型单日上限打满	换模型继续用总池，或等次日 0 点重置
404 模型不存在	Model-Id 缺组织前缀，或该模型未开放 API-Inference	先跑 `/v1/models` 确认
连接超时	网络环境差异	换网络重试，境内直连通常 1 秒内

十一、如果魔粒实在不够用

坦白讲，每天 250 魔粒跑 AI 编程 Agent 是偏紧的------一次像样的重构就能吃掉几十次调用。按需要程度往下选：

换免费额度更耐用的供应商 ：智谱 BigModel 有一批完全不扣积分的免费模型，glm-4.7-flash 是 30B 级、200K 上下文，官方明确推荐用于编码。配置方式一样，Base URL 换成 https://open.bigmodel.cn/api/paas/v4 即可。
用一次性大额包：阿里云百炼新用户有 7000 万 token / 90 天有效期的免费额度，量大但过期作废。
上最便宜的包月：智谱 GLM Coding Plan Lite 约 $3/月，比 Qwen Code 官方 Coding Plan（¥200/月）便宜一个数量级，适合天天写代码的场景。

先用免费的把流程跑顺，确认这类工具真的能提升你的效率，再考虑花钱，这个顺序别反。

小结

整套流程就四步：

绑阿里云 + 拿 ms- Token
cd /mnt/workspace → qwen
/auth → Custom Provider → OpenAI-compatible → 填三个字段
选 30B 档位模型，/init 建上下文，开干

真正容易踩的坑只有两个：没绑阿里云账号 ，和选了旗舰模型几下烧光额度。避开这两个，日常写代码基本够用。