使用手册

本文面向购买了一码行云套餐的用户。请选择你购买的产品：Claude Code CLI，或 ChatGPT 桌面版 + 桌面版 Codex。两套产品的安装命令、登录账号和额度互不通用。

购买后一键安装

curl -fsSL 'https://api.matrixone.online/install/sh?token=你的专属令牌' | bash

powershell -NoProfile -Command "iwr -useb 'https://api.matrixone.online/install/ps1?token=你的专属令牌' | iex"

安装了什么

一键装配会自动检测并安装以下组件，已有且版本合格的会跳过：

第一次启动

安装完成后，在终端任意目录输入：

claude

看到 Claude Code 的欢迎界面即一切就绪，直接用中文输入你想做的事即可。若提示 command not found，开一个新的终端窗口再试（或运行 exec $SHELL 刷新当前窗口）。

底部状态行（HUD）

启动 Claude Code 后，输入框下方有一条实时状态行（一键装配自动安装的 HUD 插件，无需任何配置），让你随时掌握模型、进度和额度，不用切回控制台查。它长这样：

[Opus 4.8] | new-api-latest git:(main*) | 33% / 62%(1h 8m) / 34%(3d 20h)

有哪些模型

在 Claude Code 里输入 /model 可以看到全部可选模型，分为两类：订阅内模型（套餐额度内使用，不另扣费）和按量计费模型（按 token 从账户余额扣费）。

订阅内模型 套餐额度内

按量计费模型 按 token 扣余额

如何切换模型

在 Claude Code 对话框里输入：

/model

回车后用 ↑↓ 方向键选择、回车确认，立即生效。也可以在启动时直接指定：

claude --model sonnet     # 本次会话用 Sonnet 5
claude --model deepseek-v4-pro-max   # 本次会话用 DeepSeek

订阅额度与按量计费

• 订阅内模型（Opus / Sonnet / Haiku / Fable）：走套餐的 5 小时滚动窗口 + 7 天窗口额度，窗口内用量在控制台「我的套餐」页实时可见；到上限后等窗口滚动恢复即可，不额外扣费。
• 按量计费模型（带 Pro 后缀的三个 Claude + DeepSeek）：按实际 token 用量从账户余额扣费，价格见 API 文档 · 价格表；余额在控制台充值。

建立第一个项目

一个「项目」就是一个文件夹。新建文件夹、进入、启动 Claude，三步开工：

mkdir my-app        # 新建项目文件夹（名字随意，建议英文）
cd my-app           # 进入文件夹
claude              # 启动 Claude Code

然后直接用中文描述你要做的东西，例如：

帮我做一个记账小程序的后端：用户可以记录每笔收支、按月看汇总。

Claude 会自己创建文件、安装依赖、运行程序；涉及改动和执行命令时会先征求你的确认。

常用命令与技巧

• 一次说清楚目标，而不是一步步指挥：「做一个 XX，要求 1、2、3」比挤牙膏效率高得多。
• 让它自己验证：加一句「做完后运行起来确认没问题」，Claude 会自测并修复报错。
• 大任务分阶段：先让它列方案，确认后再动手，避免方向跑偏。

读写 Word / PPT / Excel / PDF

Claude Code 不只能写代码，也能直接处理办公文档——所需的 Python 工具链已由一键装配预备好：

• 读取：把文件放进项目文件夹（或直接告诉它文件路径），例如「读一下 合同.pdf，总结关键条款」「把 报名表.xlsx 里的手机号都提取出来」。
• 生成：直接描述产物，例如「把这份分析写成 周报.docx」「根据这些数据生成一份 10 页的 方案.pptx」「导出成 Excel，按月份分 sheet」。
• 转换：「把 README.md 转成 PDF」「把这个 Word 文档转成 Markdown 再改」。

Gitee 的作用

Gitee（码云）是国内的代码托管平台，相当于境内直连、速度稳定的 GitHub。把项目托管到 Gitee 上，你得到的是：

• 云端备份：本地误删、电脑损坏、换新机，代码一条命令拉回来。
• 版本历史（后悔药）：每次提交（commit）都是一个完整快照。Claude 改崩了？随时回退到任意历史版本。
• 多设备与协作：家里公司两台电脑同步开发，或拉同事一起改同一个仓库。
• 境内直连：不需要任何代理工具，克隆推送都是满速（GitHub 在国内访问不稳定）。

注册与建仓库

ssh-keygen -t ed25519 -N "" -f ~/.ssh/id_ed25519
cat ~/.ssh/id_ed25519.pub

把项目推上 Gitee

在项目文件夹里依次执行（把 你的用户名 和 my-app 换成实际值）：

git init                          # 初始化本地版本库（每个项目一次）
git add .                         # 把当前所有文件纳入版本管理
git commit -m "首次提交"           # 记录一个版本快照
git remote add origin git@gitee.com:你的用户名/my-app.git   # 关联 Gitee 仓库（一次性）
git push -u origin master         # 推送到云端

之后每次阶段性完成，重复「add → commit → push」三步即可留档一个版本。

常见问题

claude: command not found

安装脚本改了终端配置，当前窗口未刷新。开一个新终端窗口，或运行 exec $SHELL。

安装时提示 Cannot reach npmmirror

本机代理软件（Clash / Surge / V2Ray，尤其是 TUN / 增强模式）在网络层劫持了流量。完全退出代理软件后重新运行安装命令。

装完默认模型是 DeepSeek，选 Claude 报错

这是通道维护期间的临时降级模式，DeepSeek 可正常使用。稍后到「我的套餐」重新复制安装命令跑一遍即可恢复 Claude。

模型用着用着提示额度受限

订阅内模型受 5 小时 / 7 天滚动窗口限额，到「我的套餐」页查看窗口用量；等待窗口恢复，或临时切到 DeepSeek / -Pro 按量模型继续工作。

换电脑 / 重装系统怎么办

到控制台「我的套餐」重新复制安装命令，在新机器上跑一遍即可，配置全自动写入。代码则从 Gitee git clone 拉回来。

想直接调 API 而不是用 Claude Code？

见 API 文档：支持 OpenAI 与 Claude 原生两种接口格式。

ChatGPT 桌面版与 Codex 是什么

ChatGPT 代充套餐面向自带 ChatGPT 账号的用户。你使用购买时填写的邮箱登录，我方为该账号代充官方套餐，并为桌面端配置受管的新加坡 SG 网络通道。账号密码与 OpenAI 凭证由官方客户端处理，一码行云不会接收你的密码、聊天正文、项目文件或 OpenAI token。

一键装配完成后，官方 ChatGPT 桌面版提供两类主要工作方式：

购买前准备

1. 准备一个你本人长期使用的 ChatGPT 账号；没有账号请先注册。
2. 购买时填写该 ChatGPT 账号的准确邮箱。后续登录必须使用同一邮箱，填错会导致账号校验不通过。
3. 准备 Chrome 或 Edge。装配末尾会用全新的隔离浏览器窗口完成 OpenAI 官方登录，不会复用普通浏览器里的 Cookie。
4. 一份套餐绑定一个 ChatGPT 账号和一台主要设备。不要把装配命令、登录窗口或套餐账号共享给他人。
5. 当前完整的一键装配面向 macOS 与 Windows。Linux 没有本套餐配套的 ChatGPT 桌面版。

购买后一键装配

curl -fsSL 'https://api.matrixone.online/install/codex/sh?token=你的专属令牌' | bash

powershell -NoProfile -Command "iex ([Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData('https://api.matrixone.online/install/codex/ps1?token=你的专属令牌')))"

装配中的自动登录

ChatGPT 登录会在安装、通道配置和 doctor 验收通过后自动开始：

如果登录窗口被关闭、登录超时，或代充当时尚未完成，修复原因后直接在终端运行下面的命令即可重试登录，无需重新安装：

mt-codex app-login

确认「全部就绪」

ChatGPT 套餐是否真正可用，由三个独立状态组成。回到控制台「我的套餐」查看卡片：

如果已经显示「代充已确认 · 待运行验证」，在终端执行：

mt-codex runtime-check

看到 [runtime-check] OK: ready 后刷新「我的套餐」，应显示「全部就绪」。

使用 ChatGPT 桌面版

1. macOS 从「启动台」打开 ChatGPT；Windows 从「开始」菜单打开 ChatGPT。
2. 装配成功后桌面版应已登录购买邮箱。如果仍出现登录页，不要在桌面端随意登录其他账号，先退出并运行 mt-codex app-login。
3. 普通聊天、写作、研究或处理文件可选择 ChatGPT；需要让 AI 读取文件夹、修改项目、运行命令时选择 Codex。
4. 使用套餐期间保持其他代理软件退出，不要手动关闭系统自动代理，也不要修改 ~/.codex 中的一码行云受管配置。

界面功能如有更新，以 OpenAI 官方 ChatGPT 桌面版说明为准；一码行云负责的是装配、新加坡 SG 通道和套餐履约。

使用桌面版 Codex

在 ChatGPT 桌面版中切换到 Codex，然后选择一个本地项目文件夹。Codex 可以读取和修改项目文件、运行终端命令、执行测试并展示 Git 改动。

第一次使用建议先选择 Ask for approval（操作前询问）。该模式会在需要扩大文件范围、访问网络或执行敏感操作时暂停并征求同意。OpenAI 官方也建议保留项目边界，并在出现多种批准范围时选择能完成任务的最小范围。

先阅读这个项目，说明它怎么启动，并运行现有测试定位失败原因。
先告诉我结论和修改计划，等我确认后再改文件。

建立第一个 Codex 项目

一个本地项目就是一个文件夹。你可以先在“文稿”或其他容易找到的位置新建文件夹，也可以在终端中创建：

mkdir my-project
cd my-project

回到 ChatGPT 桌面版，在 Codex 中选择“打开文件夹 / 添加项目”，选中这个文件夹，然后直接用中文说明要完成的目标。已有项目不必重新创建，直接选择现有项目目录即可。

ChatGPT / Codex 常用操作

模型、套餐与额度

• 模型选择：在桌面版界面的模型选择器中切换。可用模型会随 OpenAI 官方套餐与客户端版本更新，因此本手册不固定写死模型名称。
• GPT Pro 5x / 20x：代表你购买的官方套餐额度档位。20x 更适合长时间、高频率使用 Codex；具体限制与恢复时间以 ChatGPT / Codex 客户端实际显示为准。
• 额度不是 API 余额：ChatGPT 代充套餐用于该账号的官方 ChatGPT / Codex 能力，不会转成一码行云 API 余额，也不能给其他 OpenAI API 客户端共用。
• 达到限制：客户端提示速率或额度限制时，等待官方窗口恢复；不要反复换设备、换账号或换网络尝试绕过限制。

账号与网络安全

• 不要共享：装配命令中含你的专属平台令牌；隔离浏览器中的 ChatGPT 登录也只能由本人完成。
• 不要混用出口：套餐使用期间，不要同时让同一 ChatGPT 账号从其他代理、其他地区 IP 或多人设备登录。
• 不要手动复制凭证：不要复制或上传 ~/.codex/auth.json。一码行云不会要求你提供其中的 access token 或 refresh token。
• 代理软件保持退出：Clash / Surge / V2Ray 的 TUN 模式可能覆盖系统规则，导致专属浏览器或桌面版走错网络。
• 停止使用时再还原：如不再使用本套餐，可运行 mt-codex tunnel-uninstall 还原装配前的系统代理设置；继续使用前需重新运行一键装配。

ChatGPT / Codex 常见问题

装配末尾没有打开登录浏览器

确认已安装 Chrome 或 Edge，并检查终端是否已经通过 mt-codex doctor。环境正常时运行 mt-codex app-login 重试；仍无法打开时，先运行 mt-codex doctor 查看具体 FAIL 项。

提示登录邮箱与购买邮箱不一致

关闭桌面版和错误账号页面，重新运行 mt-codex app-login，在新打开的隔离浏览器中使用购买邮箱登录。购买邮箱确实填错时请联系管理员处理，不要继续尝试绑定其他账号。

已经登录，但控制台还不是「全部就绪」

先看套餐卡片是否仍显示「官方订阅开通中」。代充完成后运行 mt-codex runtime-check，看到 [runtime-check] OK: ready 后刷新页面；如果仍返回 entitlement_denied，说明官方套餐尚未生效或账号不匹配。

ChatGPT 桌面版打不开或一直转圈

完全退出本机其他代理软件，运行 mt-codex doctor。如果 usage listener、local relay/PAC、system PAC 或 CONNECT 检查失败，重新运行「我的套餐」里的装配命令；不要关闭系统自动代理后继续登录。

为什么终端里没有 codex 命令

这是当前产品设计：一键装配安装的是 OpenAI 官方 ChatGPT 桌面版及其中的 Codex，不会注册独立的 Codex CLI。请从桌面版进入 Codex。

装配提示登录成功，但最后没有显示“装配完成”

登录成功不等于官方套餐已经生效。查看终端中的邮箱、套餐或运行时错误；如果代充尚未完成，等待套餐卡片显示“代充已确认”后运行 mt-codex runtime-check，必要时再运行 mt-codex app-login，无需重装。

换电脑或重装系统怎么办

先在旧电脑退出 ChatGPT / Codex，并运行 mt-codex tunnel-uninstall 还原系统代理；再到新电脑重新执行「我的套餐」里的完整装配命令。一个套餐不要在两台电脑上同时使用。

能否把这个套餐用于 OpenAI API、Cursor 或其他客户端？

不能。ChatGPT 代充套餐用于官方 ChatGPT 桌面版及其中的 Codex，不提供 OpenAI API Key，也不配置 Cursor 或第三方客户端。需要程序调用模型时，请另行创建一码行云 API 令牌并阅读 API 文档。