常见错误信息、原因与解决方法，以及常见问题解答
本页汇总常见错误信息的含义与解决方法，以及一些常见问题。更细分的排查见各专项排查页。
网络请求失败，通常与网络或代理有关。
当前未登录或凭证失效。
工具调用被权限系统或 Hook 拦截。
配置被更高优先级覆盖、需重启，或格式错误。见 配置不生效。
用
用
命令行用
用
用
用
常见错误
fetch failed / 请求发送失败
网络请求失败，通常与网络或代理有关。
- 检查网络连通性与代理配置，见 网络、代理与 VPC 问题。
general.retryFetchErrors（默认开启）会自动重试部分此类错误。
未认证 / 需要登录
当前未登录或凭证失效。
- 运行
/login重新登录，或设置QODER_PERSONAL_ACCESS_TOKEN。 - 详见 登录与认证问题。
命令未找到（command not found: qodercli）
qodercli 不在 PATH 中。见 安装与升级问题。
权限被拒绝 / 操作被阻止
工具调用被权限系统或 Hook 拦截。
- 用
/permissions查看当前权限模式与规则，必要时调整；也可按 Shift+Tab 切换权限模式。 - 若被 Hook 阻止（退出码
2），查看反馈信息，见 Hooks、MCP 和插件问题。
配置未生效
配置被更高优先级覆盖、需重启，或格式错误。见 配置不生效。
常见问题
如何查看版本？
如何在脚本中非交互运行？
用 --print（-p），可配合 --output-format json 便于程序消费。见 在脚本中运行。
如何继续上次的会话？
用 qodercli --continue（-c）继续最近会话，或 --resume（-r）选择历史会话。见 会话管理。
如何切换模型？
命令行用 -m <模型>，交互中用 /model。见 选择模型与推理强度。
如何回退到之前的代码或对话？
用 /rewind 或 Checkpoint 功能恢复。见 撤销与恢复。
如何查看用量与额度？
用 /usage 查看用量统计，见 用量与额度。
上下文快满了怎么办？
用 /compact 主动压缩，或开新会话。见 性能、上下文与长会话问题。
获取更多帮助
- 交互中运行
/help查看帮助，/docs打开文档。 - 用
/feedback提交反馈。 - 启用
--debug（-d）获取调试日志以定位问题。
下一步
- 安装问题：安装与升级问题。
- 登录问题：登录与认证问题。
- 网络问题：网络、代理与 VPC 问题。
- 性能问题：性能、上下文与长会话问题。
- 加载问题：Memory、Skills 和 Agent 未加载。
- 配置问题：配置不生效。
- 扩展问题：Hooks、MCP 和插件问题。