需完成五步配置:一、开通移动端权限并绑定平板设备;二、用chrome或safari以pwa方式添加到主屏幕;三、启用远程沙箱调试通道并测试连接;四、调整触控优化与键盘快捷键映射;五、通过ssh直连云端cli环境。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在平板设备上访问 Qoder 并进行代码调试,但无法正常加载界面或功能受限,则可能是由于移动端未完成必要配置或未启用远程会话支持。以下是实现该目标的具体操作路径:
一、确认账号已开通移动端权限
Qoder 移动端访问依赖于 QoderWork 账号的授权状态,未激活移动端服务将导致登录后仅显示空白页或提示“设备不支持”。需确保账号已完成实名认证并绑定有效邮箱。
1、打开浏览器访问 https://qoder.com/zh,使用已有账号登录。
2、点击右上角用户头像,进入「账户设置」→「安全与设备」。
3、在「已授权设备」列表中检查是否存在“Mobile Web”条目;若无,点击「添加新设备」并选择「平板浏览器」类型。
4、系统将发送一次性验证码至注册邮箱,输入后完成设备绑定。
二、使用支持 PWA 的现代浏览器访问
Qoder 移动端不提供独立 App,而是通过渐进式网页应用(PWA)技术实现原生级体验。必须使用兼容 PWA 的浏览器,否则无法保存会话、调用终端模拟器或持久化编辑状态。
1、在 iPad 或 Android 平板上安装最新版 Chrome(Android)或 Safari(iOS 16.4+)。
2、访问 https://qoder.com/mobile(非官网首页),页面加载完成后长按地址栏右侧「分享」按钮。
3、在弹出菜单中选择「添加到主屏幕」,确认图标名称为“Qoder Mobile”。
4、返回桌面点击新图标启动,此时应用将以全屏模式运行,绕过浏览器地址栏限制,启用本地存储与后台同步。
三、启用远程沙箱调试通道
平板端无法直接运行 Node.js 或构建工具链,所有代码执行均需通过云端远程沙箱完成。该通道默认关闭,须手动开启并验证连接状态。
1、在 Qoder Mobile 启动后,点击左上角「≡」菜单,选择「设置」→「开发环境」。
代码编辑 CLI 工具集合:Cursor CLI(agent)和 Qoder CLI(qodercli),用于代码修改、重构、Code Review 及自动化代码任务。
2、找到「远程执行模式」开关,将其设为「启用」,系统将自动生成一个临时沙箱实例 ID。
3、点击「测试连接」,等待倒计时结束后查看结果:若显示 “Connected to sandbox-xxxxx”,表示通道就绪;若失败,点击「重试」并确保平板处于稳定 Wi-Fi 环境。
4、返回主界面,新建会话时选择「Agent Mode」,所有代码生成、运行与调试操作将自动路由至该沙箱实例。
四、配置触控优化与外接键盘映射
平板触控操作易误触,且缺乏物理快捷键支持,需调整 UI 布局与按键行为以适配开发场景。
1、进入「设置」→「界面偏好」,将「编辑器缩放比例」设为 125%,增大行高与按钮间距。
2、开启「触控手势增强」,启用双指长按触发右键菜单、三指滑动切换标签页。
3、连接蓝牙键盘后,在「快捷键映射」中将「Ctrl+Enter」重新绑定为「运行当前文件」,将「Cmd+/」(macOS 键盘)或「Ctrl+/」(Windows 键盘)绑定为「行间注释」。
4、保存设置后重启 Qoder Mobile 应用,新映射将在下次会话中生效。
五、通过 SSH 终端直连云端 CLI 环境
当需要执行高级调试命令(如 strace、gdb、kubectl)时,可跳过图形界面,直接通过内置终端接入已部署的 Qoder CLI 实例,获得完整 Linux shell 权限。
1、确保已在 ECS 或其他云服务器上成功安装 Qoder CLI,并运行 qodercli --version 验证版本不低于 0.2.7。
2、在 Qoder Mobile 中点击底部「Terminal」图标,输入 ssh -p 2222 user@your-server-ip,其中端口与用户名需替换为实际配置值。
3、首次连接将提示输入密码或粘贴私钥内容,成功后即进入远程 CLI 会话。
4、执行 qodercli login --browser=false,系统将返回一个短时效令牌,复制至平板浏览器打开 https://qoder.com/cli-auth 完成绑定。










