上手教程 · 约 5 分钟

跟着做，5 分钟用上官方 Claude Code

不用懂配置。先选你的电脑和想用的方式，下面只会出现你需要的那一条命令，复制、粘贴、浏览器点一下授权就好。

第一次用？先看 3 分钟视频

视频用 Mac 演示终端版，安装那一步同时给出了 Windows 命令。用桌面 App（推荐）或 VS Code 的，按下面选好后出现的步骤做。

开始前确认一件事：你已经注册并开通了套餐（控制台里订阅显示生效）。还没开通 → 去选套餐；还没有邀请码 → 加微信领码。授权时要登录付款的那个邮箱。

1你用的电脑

2你想在哪里用 Claude

拿不准就选「桌面 App」（Linux 没有桌面 App，用终端）。三种方式共用同一份订阅额度，以后想加别的方式，回来再选一次就行。

照着做

装好以后

切换模型

桌面 App 在输入框旁的模型菜单里选；终端 / VS Code 的 Claude Code 里输入 /model。可选 Opus / Fable / Sonnet / Haiku。Fable 和其他模型共用周额度、扣得更快，最多用到周额度的一半；想省额度用 Opus 或 Sonnet。

看用了多少

登录控制台看本周额度进度和重置时间。用完会按周自动刷新，不够也可以补差升档。

一份订阅，三处通用

桌面 App、终端、VS Code 共用一份周额度；同一台电脑装几种方式，通常只占 1 个设备名额。

以前的 skill / 插件不见了

不是被删了，是终端版用了独立配置目录。运行 opclaude --import-skills 一键导入。

卡住了？先看这几条

连不上、报 connection dropped，或者时好时坏

可能和电脑上的代理 / 加速器软件有关（比如开着 TUN 模式，或同时开了两个代理软件）。跑一下一键网络自检，最后一行会给出中文结论：
macOS 终端：curl -fsSL https://claude.opusapi.xyz/netcheck.sh | bash
Windows PowerShell：irm https://claude.opusapi.xyz/netcheck.ps1 | iex
只读检查，不改任何设置；输出里会显示代理配置等诊断信息，账号密码会尽量打码，但不保证遮全。跑完只截自检输出那一部分，有密码、token 或其他个人信息先打码，再发给在线客服。Linux 暂不支持。带复制按钮的完整说明

「授权此设备」按钮是灰的，点不了

先勾选页面上「设备码与终端里一致」那一项。勾了还是灰的，说明当前登录的账号没有生效中的套餐：点页面上的「切换登录」换成付款邮箱，或者先去开通套餐。

浏览器没有自动弹出授权网页

终端里会打印「请在浏览器授权」和一个链接，把链接复制到浏览器打开即可。授权完成前不要关闭终端窗口。

输入 opclaude 提示「找不到命令 / 无法识别」

把当前终端窗口关掉，重新开一个再输入（新装的命令要在新窗口里才认）。还不行，就把第 2 步的命令再跑一遍，它会自动修复。

提示 401 / 403、额度不足，或者用着用着报错

登录控制台看订阅是否生效、本周额度是否已用完。确认都正常还报错：命令行版在终端运行 opclaude --check 把结果截图发给客服；桌面 App / VS Code 直接把报错界面截图发给客服。

桌面 App / VS Code 打开后还是要我登录 Anthropic

需要完全退出再打开：Mac 按 ⌘ + Q；Windows 在右下角托盘里右键图标 →「退出」；VS Code 用菜单「退出 / Quit」，只关窗口不够。桌面 App 请用 2.19675.0 或更新版本。

还没解决？把报错截图发给在线客服，不用登录，真人一对一处理。
请不要把密钥、密码发给任何人，包括客服。

想和其他用户交流用法：官方 QQ 交流群（二群）1108896854，一群已满。