常见问题
先运行 monash doctor
Section titled “先运行 monash doctor”monash doctor它会一项项检查，并告诉你没通过的怎么修。需要别人帮忙时把整段输出发过去，里面没有令牌和 cookie。也可以直接跟 Claude 说“monash 用不了了”，它会跑同样的检查。
monash doctor --deep 还会去 Moodle 和 Ed 再拉一遍，用第二个来源核对结果（截止日期对日历订阅、本地课件对 Moodle 等），只输出数量、课号、日期和活动编号。
Claude 里看不到 monash
Section titled “Claude 里看不到 monash”运行 monash setup claude 重新接一次。Windows 上一定先从托盘完全退出 Claude。还不行的话，看 Claude Desktop 的 Settings 里 Developer 有没有报错。
提示 “monash: command not found”
Section titled “提示 “monash: command not found””新开一个终端窗口。安装脚本已经把工具目录加进 PATH，但之前开着的窗口看不到这个变化。还不行的话，运行 uv tool update-shell 再开一个新窗口。
登录窗口打不开，或提示没找到浏览器
Section titled “登录窗口打不开，或提示没找到浏览器”装一个 Chrome 或 Edge。浏览器装在不常见的位置的话，指定一下：
monash config browser "C:\Program Files\...\chrome.exe"如果之前的登录窗口还开着，先把它关掉。
Windows 同步时提示路径太长
Section titled “Windows 同步时提示路径太长”Windows 默认限制完整路径 260 个字符，课名、周名、文件名加起来可能超。把课件放到短一点的地方：
monash config files_dir C:\Monashmonash sync澳洲校区时间不对
Section titled “澳洲校区时间不对”Moodle 按你账号的时区显示时间，Study Kit 默认按 UTC+8。改成你的：
monash config tz_offset 10夏令时用 11。
Ed 上的作业截止日期在哪？
Section titled “Ed 上的作业截止日期在哪？”大部分 Ed lesson 没有截止日期，截止以 Moodle 为准。待办里 Ed 的部分按你自己的进度：列出到你做到的那一周的下一周为止没做完的 lesson。
Windows 更新时提示文件被占用
Section titled “Windows 更新时提示文件被占用”Windows 上正在运行的程序不能被覆盖，Claude Desktop 会一直开着 monash。先从托盘完全退出 Claude，再在新的 PowerShell 窗口里重新运行更新。