# 手机配对与连接排查

> 在手机中扫描自己电脑上 MyCodex 桌面伴侣显示的配对二维码。连接失败时，先检查电脑在线状态、桌面服务和网络，再考虑重新配对。

来源：https://mycodex.huatongai.cn/docs/pairing/
更新日期：2026-09-28

## 如何配对

1. 在电脑上打开 MyCodex 桌面伴侣，等待显示配对二维码。
2. 打开手机客户端，进入扫码入口，允许所需的相机权限。
3. 扫描当前电脑上的二维码，等待连接完成。
4. 选择项目和会话，确认可以读取内容。

手机客户端会验证配对信息与固定的生产中继地址。来源不明、内容无效或指向其他端点的二维码不应继续使用。

## 需要同一个 Wi-Fi 吗

不需要。手机和电脑通过固定的加密中继通道建立连接。两端必须能够访问中继服务，电脑端伴侣必须处于运行状态。

## 无法连接时，按这个顺序检查

1. **检查电脑。** 确认没有关机或休眠，桌面伴侣仍在运行。
2. **检查网络。** 确认两端都能联网，当前网络没有拦截所需的加密连接。
3. **检查二维码。** 使用当前桌面伴侣显示的二维码，不使用他人提供或过期截图中的内容。
4. **重试连接。** 网络恢复后重新尝试连接。若连接身份已变化，再从当前电脑重新配对。

避免反复删除电脑端数据来解决网络问题。配对身份和会话历史属于不同的数据，需要分别处理。

## 扫码权限被拒绝

到手机系统设置中检查 MyCodex 的相机权限，再返回扫码。如果你选择使用应用提供的配对信息输入方式，也应仅使用自己电脑显示的信息。

## 连接成功，但看不到预期内容

确认你连接的是正确的电脑，并在项目与会话列表中选择了目标项目。电脑端 Codex 的可用性、目录访问权限与连接本身是不同的问题。

不要公开发送会话内容或配对二维码来排查问题。记录不包含密钥或消息正文的错误提示，结合[安全说明](/docs/security/)检查处理方式。

## 移除连接有什么影响

移除连接只清除手机保存的连接信息，不会自动删除电脑上的会话，也不等于撤销所有已配对客户端。处理配对信息泄露时，需要在电脑端检查密钥与连接状态。