帮助与支持

常见问题与故障排查

根据具体现象检查身份、目录、执行状态和连接,并保留可用于定位的诊断材料。

所有成员与技术支持人员约 6 分钟阅读
操作入口
当前页面的提示;桌面设置 → 客户端诊断 / 错误日志
完成结果
按现象缩小问题范围,恢复可继续的工作状态,并提交有效的脱敏信息。
本篇目录

登录与模型目录

码哥客户端展开的模型选择器,按平台模型和企业私有模型分组展示演示模型
先打开实际客户端的模型选择器,核对平台模型与企业私有模型目录。目录为空时按本节检查登录、连接和使用授权;图中模型名称为演示别名。 真实产品界面 · 演示数据
登录与模型目录参考表
现象检查恢复方式
登录失败或身份不对账号、平台地址、企业归属、网络和系统时间。按界面提示重新登录;仍失败时请管理员核对账号状态,记录脱敏提示。
模型目录为空登录是否有效,目录请求是否失败,模型是否启用并向本人开放。恢复连接后重开选择器;让管理员核对模型来源与使用范围。
能选模型但调用失败当前授权、供应商 / Key、订阅、额度、余额与限额。按具体提示处理对应条件,再用小任务验证;不要反复扩大权限。

任务停止或没有继续输出

码哥工具调用审批窗口,展示运行测试的命令、项目目录、授权范围和审批按钮
任务暂停的一种实际情况:工具调用仍在等待审批。先阅读卡片中的命令、目录和授权范围,再作出决定;等待审批不等于执行失败。 真实产品界面 · 演示数据
任务停止或没有继续输出参考表
现象检查恢复方式
等待很久没有新输出是否等待工具批准、问题回复、外部命令或网络响应。先处理待确认项;查看执行记录,再决定等待或停止。
点击停止后不确定是否结束命令与底层工具是否仍在运行,文件是否已修改。等待真实执行结束并核对现场;不要立即重复提交同一写入任务。
恢复任务时结果不一致实际文件、任务记录、未保存编辑与剩余目标。在当前项目说明已完成和待处理部分,再继续;回退前先预览影响。

MCP 连接失败或没有工具

安装完成与连接成功是不同状态。需要 OAuth 的服务先完成授权;分享配置前去掉令牌、密码和请求头中的凭据。

码哥 MCP 设置界面,展示团队文档服务的连接配置与可用工具
在实际 MCP Servers 设置页检查连接状态、工具数量与配置,再按本节处理网络、授权或本机依赖问题。图中的服务与地址为演示配置。 真实产品界面 · 演示数据
MCP 连接失败或没有工具参考表
现象检查恢复方式
远程 MCP 连接失败服务是否启用,URL、网络、请求头及授权是否有效。在 MCP Servers 修正配置并保存,查看连接状态与工具数量。
本地 MCP 无法启动command、参数、工作目录、环境变量及本机依赖。补齐所需环境,确认启动内容后保存,再查看运行提示。

IDE 插件入口不显示

IDE 插件入口不显示参考表
现象检查恢复方式
VS Code 看不到码哥插件是否启用、宿主版本是否满足发布包要求、项目是否受信任。运行「码哥:打开编码与对话」,查看右侧辅助侧栏;必要时重启 VS Code 并查看「输出 → 码哥」。
IDEA 没有工具窗口插件是否安装启用,宿主版本与安装包是否匹配。完成插件安装或更新要求的 IDE 重启,再打开项目和码哥工具窗。

桌面入口与远程电脑

桌面入口与远程电脑参考表
现象检查恢复方式
桌面功能图标消失当前账号、租户桌面功能权限与品牌客户端配置。请品牌管理员核对目标租户已开放模块,保存后在支持的客户端刷新权限。
在线用户有设备,但远程电脑不可用协同权限、真实身份、执行电脑远程接入及服务连接。在执行电脑确认已连接协同服务;Web IDE 处于模拟视角时先退出租户,平台管理员按需再退出品牌。
清单有草稿,团队统计没有投入清单是否明确显示已核对上传,以及工作日期和筛选范围。成员完成核对上传后重新查询;本机日志和待上传草稿不能代替上传成功记录。

收集诊断材料再反馈

诊断报告不会自动上传。提交前复核截图与日志,移除密码、API Key、访问令牌和不相关业务数据。若无法进入诊断页,仍可先提供版本、操作过程与脱敏错误信息。

  1. 桌面设置打开「客户端诊断」,点击「重新检查」。
  2. 查看异常组件与本机错误日志,先预览脱敏诊断报告,再按需导出。
  3. 附上版本、系统、发生时间、入口、复现步骤及期望结果;截图保留实际提示。