Claude Code 的 /rc/remote-control扫码连不上多数时候不是手机的问题也不是官方 App 的锅。TaoTokenhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude-code-rc-fix在这类排障里承担的是一件很具体的事把 Claude Code 本地进程访问模型 API 的接口地址收敛到唯一正确的一处排除 Base URL 被误写成官网首页、或者多带了 /v1 的情况。因为 Remote Control 的链路是两段式的扫码只是把手机和本地终端接上了真正跑推理的那条腿一旦配错表现就是扫上了但没接上终端提示通道不可用。下面按排障顺序把它拆开讲。一、/rc 扫码连不上的真实现场与排查顺序先还原现象。终端里输入/rc或/remote-controlClaude Code 会打印一个会话链接和一张 QR 码提示可以用官方 iOS/Android App 扫码或者直接在浏览器打开 claude.ai/code 输入链接接管。问题出现在扫码之后常见的三种表现第一种手机端扫完停在连接中几秒后回到初始页终端没有任何反应 第二种手机端显示已接管但一发指令就报错终端提示通道不可用channel unavailable 第三种手机端能看到会话但指令发出去后本地没有任何文件操作或命令执行。很多人一上来就去查手机网络、重装 App、切换 Wi-Fi 和蜂窝数据绕了一大圈才发现问题在本地配置。Remote Control 的架构是本地执行加手机接管代码执行、文件读写、AI 计算全部留在本地终端手机只是一块显示和输入的远程屏幕。所以链路可以明确切成两段第一段是控制通道手机与本地 Claude Code 进程之间通过加密连接同步会话状态 第二段是模型通道本地进程把上下文发给模型 API再把结果拿回来执行。扫码失败如果发生在第一段终端通常会直接报连接类错误码而通道不可用这类提示往往出现在第二段——控制通道已经建立手机指令也送达了本地进程但本地进程调用模型 API 时失败超时或返回错误手机端就只看到一个不可用的通道。所以排查顺序应该是从后往前先确认本地 Claude Code 能否正常完成一次模型对话再回头去看 /rc。如果连普通提问都失败那 /rc 的问题就是同一个配置问题不必分两处查。最小验证方法很简单在尚未执行 /rc 的终端里直接向 Claude Code 提一个短问题比如让它复述一句话。有正常回复说明模型通道是通的问题在 Remote Control 的会话建立环节没有回复或报错直接从接口地址查起。二、TaoToken 前置先把 Key 和接口地址定下来原文的第四步是扫码连接这里把它往前挪一步在生成 QR 码之前先把 Key 和 Base URL 准备好。顺序反了会很难受——扫码那一刻链路是通的等手机发出第一条指令才暴露出接口地址问题排查信息被拆散在两个界面上。具体做两件事。第一打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude-code-rc-fix 进入控制台创建 API Key。Key 只显示一次复制后先放到一个安全的地方后面配置里统一用YOUR_API_KEY这个占位符表示。第二记住接口地址只有一种正确写法https://taotoken.net/api。它不带/v1不带任何 UTM 参数也不是官网首页地址。这三条后面会反复用到。这里要强调一个容易被忽略的点Remote Control 依赖本地终端进程持续在线。手机发出的每一条指令都要由本地进程转成模型请求再执行。如果 Base URL 写错本地进程在收到手机指令的瞬间就会失败而失败信息往往只在终端上一闪而过手机端看到的只是通道不可用。换句话说接口地址配错的代价在 /rc 场景下会被放大。Key 创建页面和接入说明放在这里方便对照创建 Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude-code-rc-fix接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude-code-rc-fix三、Claude Code 侧可复制配置settings.json 与 ANTHROPIC_*Claude Code 读取配置有两个来源用户级~/.claude/settings.json和项目级.claude/settings.json。两个文件同时存在时项目级会覆盖用户级。排障时先确认当前会话到底吃的是哪一份很多人改了用户级却被项目里一份遗留配置盖掉。用户级 settings.json 的推荐写法{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: claude-sonnet-4-5, ANTHROPIC_SMALL_FAST_MODEL: claude-haiku-4-5 } }如果不想写进配置文件用环境变量也可以效果等价export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELclaude-sonnet-4-5三不要逐条对照检查不要写成https://taotoken.net/。这是官网首页返回的是 HTML 页面客户端把它当成 API 入口会直接解析失败。 不要写成https://taotoken.net/api/v1。多出来的/v1会和客户端自身拼接的路径重复最终请求落到/api/v1/v1/messages这类不存在的路由上典型表现就是 404。 不要在 API 地址后面追加任何查询参数尤其是 UTM。API 域名只负责接口活动参数是给落地页用的混在一起在部分网关上会被当成路径的一部分处理。另外如果你更习惯用命令行工具统一管理配置可以用 TaoToken 的 CLInpm i -g taotoken/taotoken taotoken cc -k YOUR_API_KEY -u API -m MODEL_ID其中-u API对应的就是上面那个不带/v1的接口地址-m传模型 ID。CLI 写完后同样建议回读一次 settings.json确认最终生效的值没有被旧配置覆盖。配置改动完成后必须退出当前 Claude Code 会话并重新启动。/rc是在进程启动时读取配置的热改文件不会重新加载。四、验证请求与成功结果先通模型再出 QR 码配置写完按顺序验证两件事。第一步验证模型通道。最简单的办法是在 Claude Code 里发一句短指令确认有返回。如果想更干净地隔离问题用 curl 直接打一次 Messages 接口curl https://taotoken.net/api/v1/messages \ -H x-api-key: YOUR_API_KEY \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:claude-sonnet-4-5,max_tokens:64,messages:[{role:user,content:ping}]}注意这里 curl 用的是https://taotoken.net/api/v1/messages是接口的完整路径而配置里填的 Base URL 只到https://taotoken.net/api/v1/messages由客户端自己拼。这两个层级不要混淆这也是前面反复强调Base URL 不要带 /v1的原因。成功返回是一个 JSON 对象content数组里有模型的文本输出。如果返回 401是 Key 的问题返回 404基本可以锁定是 Base URL 写错或路径重复返回 200 但内容异常检查模型 ID 是否正确。第二步回到终端执行/rc。此时终端会输出会话链接和 QR 码。手机用官方 App 扫码或在浏览器打开 claude.ai/code 输入链接。判断接管成功看三个信号终端上出现手机端指令的原文回显说明控制通道双向通 手机端能读到当前项目的上下文和文件状态说明会话状态同步完成 在手机上发一条指令终端的模型请求和工具调用同步触发并返回结果。只要第 三条成立整条链路就是通的。此后断线重连上下文与对话历史都会保留不需要重新扫码配置。五、本篇常见错排查清单围绕 /rc 扫码连不上把高概率原因集中列一遍逐条对照。Base URL 写成官网首页。请求打到 HTML 页面解析失败。改为https://taotoken.net/api。Base URL 多了/v1。路径重复返回 404。去掉/v1让客户端自己拼。Base URL 带了 UTM 或其他查询参数。部分网关会把它当路径处理。API 地址不带任何参数。Key 复制时带了空格或换行或者用的是已被删除的旧 Key。表现是 401。重新创建并整行复制。改了 settings.json 但没有重启会话。/rc进程启动时读配置不重启不生效。用户级和项目级配置冲突。项目级.claude/settings.json覆盖了用户级检查两份文件的 env 字段。环境变量与配置文件冲突。shell 里残留的ANTHROPIC_BASE_URL会覆盖配置文件里的值用env | grep ANTHROPIC确认。本地终端进程被挂起或断开。笔记本合盖、SSH 会话超时、终端被 CtrlZ 挂起都会让手机端显示通道不可用。长期跑建议放进 tmux 或 screen保持前台进程存活。手机端与终端不是同一账号或链接已过期。会话链接有时效重新执行/rc生成新的即可。代理变量干扰。HTTPS_PROXY、HTTP_PROXY存在时请求可能被引导到不可达的出口临时取消后重试。多个配置管理工具互相覆盖比如同时装了 CC Switch 一类的切换器。检查当前生效的是哪一份必要时只保留一处配置源。排查时建议按模型通道 → 控制通道 → 手机端的顺序走不要两头同时改否则很难判断是哪一步生效了。六、下一步把配置固定下来再谈移动编码/rc 扫码连不上这件事本质上是一次配置排障先让本地 Claude Code 的模型通道稳定再让手机接管会话。想长期在手机上跑编码任务把 Key 管理和接口地址固定成一份配置比每次出问题再翻一遍设置要省事得多。如果你正卡在这一步按下面的入口走排障与接入先创建 Key、对照接入文档把 Base URL 与 ANTHROPIC_* 配好https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude-code-rc-fix 和 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude-code-rc-fix想先在浏览器里验证模型通道是否正常再去配 /rchttps://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude-code-rc-fix长期把 Claude Code 当编码代理用、需要稳定的移动端接管https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude-code-rc-fix配好之后/rc生成 QR 码这一步就只是一次扫码的动作手机接管会话、继续推进本地任务这件事才算真正可用。