需确保手机与电脑同局域网并完成OAuth绑定,安装v0.1.6+ Qoder Mobile、扫码接入或启用remote-control守护进程,开启触控增强层后方可实时交互。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想在手机上实时跟进Qoder CLI任务进度、远程审批高风险操作,或在通勤途中直接委派新开发任务,但发现App打开后界面错位、弹窗不响应、扫码无反应——这通常是因为移动端未与本地CLI建立有效连接,或触控适配层未启用。
确认Qoder移动端已安装并登录
前往手机应用商店搜索“Qoder Mobile”,安装包名为 com.qoder.mobile.cn,版本号需为 0.1.6 或更高;安装后使用与桌面端相同的阿里云账号(GitHub/Google)登录,否则无法同步会话状态。
登录成功后,首页应显示「最近会话」与「新建任务」两个核心入口,若仅见空白页或加载图标,说明账号未完成OAuth绑定,请返回桌面端终端执行 qodercli login 再重试。
启用远程控制模式并扫码同步会话
第一步:在已启动Qoder CLI的项目目录中,输入 /remote-control 命令;
第二步:终端将生成一个动态刷新的二维码,注意该码每30秒自动更新,过期即失效;
第三步:打开Qoder Mobile → 点击右上角「+」→ 选择「扫码接入现有会话」→ 对准扫描;
代码编辑 CLI 工具集合:Cursor CLI(agent)和 Qoder CLI(qodercli),用于代码修改、重构、Code Review 及自动化代码任务。
第四步:扫描成功后,手机端立即渲染完整终端视图,包括滚动缓冲区、光标位置与当前等待输入状态。此时在手机上点击 Approve 按钮,电脑端CLI进程将实时收到确认信号并继续执行。
【关键前提】必须确保手机与运行CLI的电脑处于同一局域网,否则二维码无法建立WebSocket长连接。
配置守护进程以支持手机主动发起任务
方法一:终端常驻监听(推荐)
在任意目录下执行 qodercli remote-control daemon,终端输出出现 Remote control daemon started on port 8080 即表示成功;此后无需预先开启CLI会话,手机可随时新建任务。
方法二:开机自启(Linux/macOS)
将守护进程写入systemd服务或launchd plist,确保重启后持续运行;Windows用户可使用Task Scheduler设置开机启动脚本。
注意:守护进程默认只监听本地回环地址(127.0.0.1),如需跨设备访问,需手动修改配置文件中的 host 字段为 0.0.0.0 并开放防火墙8080端口。
开启触控增强层与终端优化
进入Qoder Mobile设置页 → 找到「Terminal Experience」→ 开启 Touch-Optimized Terminal 开关;
返回会话页面后,双指张开缩放终端字体至16px以上,避免小字号导致误触;
点击输入框时,系统将自动调起Qoder定制软键盘,其中 Tab、Ctrl+C、Enter 键独立可见且响应可靠——这是唯一能正确触发CLI中断信号的输入方式,普通系统键盘无法发送 Ctrl+C。

















