Claude Duet 怎么连 Claude Code?手机上看进度、批准改动、远程续跑(含第三方 API Key 用户的替代方案实测)

据 Claude Duet 负责人 @davidsuttonca,Duet 现在能接入 Claude Code 会话:手机上看在跑什么、批准改动、发消息续跑,本机和云端会话都行。本文按 Anthropic 官方文档讲清使用条件(订阅登录、Remote Control、云端会话),说明为什么第三方 Base URL / API Key 用不了,并实测用 tmux + SSH 在服务器上远程遥控 Claude Code 和 Codex 的替代方案。

6 分钟阅读
Claude Duet 怎么连 Claude Code?手机上看进度、批准改动、远程续跑(含第三方 API Key 用户的替代方案实测)

北京时间 11 月 7 日凌晨,Claude Duet 负责人 David Sutton 在 X 上发布:Claude Duet 现在支持 Claude Code 会话——在手机上查看正在跑的任务、批准改动、发消息让它继续,电脑上的会话和云端会话都能接。Anthropic Claude Code 社区团队的 @adocomplete 转发了这条消息,Duet 工程师 @navbryce 也在回复区收集反馈。

先说结论:

  • 能做什么(据 @davidsuttonca):在 Duet 里看 Claude Code 会话进度、批准改动、发送新指令;支持本机会话和云端会话。
  • 谁能用(据 Duet 官方帮助中心):目前是研究预览,仅限美国的 Pro / Max / Ultra 用户,需等候名单邀请;Team / Enterprise 暂不支持。
  • 本机会话靠什么连:Claude Code 官方文档里,手机连本机会话的通道是 Remote Control(claude remote-control 或 /remote-control),要求用 claude.ai 订阅账号登录,不支持 API Key。
  • 用第三方 Base URL / API Key 的人:官方文档写明,ANTHROPIC_BASE_URL 指向非 api.anthropic.com 时 Remote Control 不可用。我们在本机用本站 Key 复现:claude remote-control 直接报错退出。
  • 替代方案:把 Claude Code / Codex 跑在服务器的 tmux 里,手机用任意 SSH 客户端连上去看进度、批准、续跑。本文实测:Claude Code 修一个 bug 一轮约 14 秒,Codex exec 同类任务约 24 秒。

Create API Key →

Duet 新增了什么(据公开信息)

来源要点
@davidsuttonca(Claude Duet 联合创建者、负责人)「Claude Duet: now with Claude Code sessions」:看在跑什么、批准改动、发送更新,都在手机上完成;电脑和云端会话都支持
@adocomplete(Anthropic Claude Code 社区)转发:Claude Code in your Claude Duet
@daniel_mac8(用户)据用户反馈:Duet 能访问云端和「已连接设备」上的本地 Claude Code 会话
@navbryce(Duet 工程师)Claude Code Sessions 上线后在收集反馈,同时提到 Duet 新增了应用内查看云端浏览器
X 热点汇总据报道:Duet 与 Claude Code 会话打通,可跨设备看进度、引导任务

注意:截至本文发布,Duet 帮助中心的限制说明里仍写着「看不到你电脑上的全部项目和文件,能读你在 Claude 里的工作但不能修改」,还没有单独写 Claude Code 会话的接入步骤。下面的使用条件以 Claude Code 官方文档为准;Duet 内的具体入口请以 App 实际界面为准。

使用条件(按官方文档)

Duet 本身

据 Get started with Claude Duet:

  • Pro、Max 或 Ultra 计划;
  • 美国地区的 Claude 账号;
  • 等候名单邀请(分批开放,填写的邮箱要和 Claude 账号、手机上的 Apple / Google 账号一致);
  • 用量计入你的计划额度,后台早报和巡检也算在内。

云端会话

据 Use Claude Code in the cloud:云端会话跑在 Anthropic 托管的环境里,需要 Pro / Max / Ultra / Team(或 Enterprise 对应席位),并连接 GitHub。合上电脑后任务继续跑,手机上随时看。终端里可以用 claude --cloud "任务描述" 发起。

本机会话:Remote Control

据 Remote Control 文档 和 Claude Code on mobile:

bash
# 服务器模式:在项目目录运行,终端会显示链接,按空格出二维码
claude remote-control

# 普通交互会话,同时允许远程接管
claude --remote-control "My Project"

# 已经在会话里了
/remote-control

然后在 Claude App 的 Code 标签里找到这个会话(在线时是带绿点的电脑图标)。官方列出的硬性条件:

  • 订阅:Pro / Max / Ultra / Team / Enterprise;不支持 API Key;
  • 登录:用 /login 走 claude.ai 账号登录;claude setup-token 生成的长期令牌也不行;
  • 接口:使用 Bedrock / Google Cloud / Foundry,或 ANTHROPIC_BASE_URL 指向 api.anthropic.com 以外的网关、代理时,不可用;
  • 设置了 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 或 DISABLE_GROWTHBOOK 也不可用;
  • 电脑要保持开机、claude 进程不能退出;在远程机器上跑,官方建议放进 tmux 或 screen。

连上之后,手机能看到会话对话和 git diff,能切 /model、/effort,权限模式可选 Manual / Accept edits / Plan / Auto(不能选 Bypass);/plugin、/resume 这类只在终端可用。打开 /config 里的推送开关后,任务完成或需要批准时手机会收到通知。

用第三方 API Key 能不能连?实测

官方文档已经写明不行,我们还是在本机跑了一遍,环境是 Claude Code 2.1.316,ANTHROPIC_BASE_URL 指向 https://api.aicodewith.ai,ANTHROPIC_AUTH_TOKEN 用本站 Key:

text
$ claude remote-control
Error: You must be logged in to use Remote Control.

Remote Control is only available with claude.ai subscriptions. Run `claude auth login` to sign in with your claude.ai account.

不到 1 秒就退出。在交互会话里输入 /remote-control,返回 Unknown command: /remote-control——不满足条件时这个命令直接不出现。

所以结论很直接:想用 Duet / Claude App 接管本机 Claude Code,就要用 claude.ai 订阅账号登录,并去掉第三方 ANTHROPIC_BASE_URL。用 API Key 走网关的人,用下面的方案。

Create API Key →

替代方案:服务器 tmux + 手机 SSH 遥控(Claude Code / Codex 都行)

思路:Agent 跑在一台常开的机器(云服务器、家里的主机都行)的 tmux 会话里;手机用任意 SSH 客户端连上去,tmux attach 进去看进度、按回车批准、打字续跑。断网、锁屏都不影响任务,再连上会话还在。

1. 配 Key(只写一次)

先注册并创建 API Key(步骤见创建 API Key 文档)。Claude Code 写进 ~/.claude/settings.json:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key"
  }
}

Codex 写进全局 ~/.codex/config.toml:

toml
model = "gpt-6.1-sol"
model_provider = "aicodewith"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "你的 API Key"

更完整的配置说明见《Claude Code 接入第三方 API》和《Codex config.toml 配置指南》。

2. 在 tmux 里启动 Agent

bash
# Claude Code:交互会话
tmux new -s cc -c ~/project
claude

# Codex:另开一个会话(交互用 codex,一次性任务用 codex exec)
tmux new -s cx -c ~/project
codex

按 Ctrl-b d 离开,Agent 继续在后台跑。

3. 手机上看进度、批准、续跑

bash
ssh you@your-server

# 方式一:直接进会话,和坐在电脑前一样
tmux attach -t cc

# 方式二:不进会话,只看最近 40 行输出
tmux capture-pane -p -t cc | tail -40

# 批准弹窗 / 确认:发一个回车
tmux send-keys -t cc Enter

# 给 Agent 发新指令
tmux send-keys -t cc "跑一下测试,失败就修" Enter

手机屏幕小,方式二最省事:一条命令看进度,一条命令批准或续跑。

4. 实测记录

在一台 Linux 服务器上,新建一个只有一个 bug 的仓库(calc.py 里 add 写成了 a-b),全程用本站 Key:

测试操作结果时长
Claude Code(tmux 交互会话,claude-sonnet-5-5)tmux send-keys 发「修好 add 并用 python3 验证」改成 return a+b,add(2,3) 输出 5状态行显示一轮 14 秒
远程批准会话中途弹出一次 auto mode 说明框,tmux send-keys Enter 确认确认后继续执行,任务完成一条命令
Codex 0.167(codex exec -s workspace-write,gpt-6.1-sol)在 tmux 里跑「修好 mul 并验证」改成 return a*b,mul(2,3) 输出 6约 24 秒
Claude Code 无头模式claude -p "总结最近两次提交"(只读)正确说出两次提交各新增了什么文件和函数约 11 秒

Claude Code 那一轮的真实输出(节选):

text
● Update(calc.py)
  ⎿  Added 1 line, removed 1 line
      2 -    return a-b
      2 +    return a+b
● Bash(python3 -c "from calc import add; print(add(2,3))")
  ⎿  5
  ⎿  Allowed by auto mode

途中弹出的说明框是 auto mode 分类器计费的一次性提示(走网关时出现,auto mode 照常工作),相关背景见《Claude Code auto mode 接网关 403/422》。

Codex 那一轮的真实输出(节选):

text
apply patch
-    return a+b
+    return a*b
exec
/bin/bash -lc "python3 -c 'from m import mul; print(mul(2,3))'"
 succeeded in 0ms:
6

5. 让它更像「手机遥控」

怎么选

你的情况建议
美国 Pro / Max / Ultra,已拿到 Duet 邀请,用 claude.ai 登录 Claude Code直接用 Duet 或 Claude App 的 Code 标签接管会话
有订阅但不在美国 / 没拿到 DuetClaude App 的 Code 标签 + Remote Control(同样要 claude.ai 登录)
用 API Key 或第三方 Base URL(包括本站)服务器 tmux + 手机 SSH;本文实测 Claude Code / Codex,其他命令行 Agent 做法相同

常见问题

Duet 和 Claude App 的 Code 标签是一回事吗?

不是。Duet 是单独的 App(研究预览)。Claude Code 官方文档里,手机接管 Claude Code 的标准入口是 Claude App 的 Code 标签(云端会话 + Remote Control)。据 @davidsuttonca,Duet 现在也能接 Claude Code 会话。

已经设置了 ANTHROPIC_BASE_URL,临时去掉能用 Remote Control 吗?

据官方文档:有符合条件的 claude.ai 订阅登录时,去掉 ANTHROPIC_BASE_URL(以及 settings 里 env 中的同名项)并重启会话即可。这时请求走的是你的订阅额度,不再走第三方 Key。

tmux 方案手机上用什么 App?

任意 SSH 客户端都可以;本文不绑定具体 App。关键是服务器常开、Agent 在 tmux 里。

Codex 有类似的手机接管吗?

本文只用了 Codex CLI 在 tmux 里跑,手机通过 SSH 接管,和 Claude Code 的做法一致。

小结

据 Claude Duet 负责人 @davidsuttonca,Duet 已能接入 Claude Code 的本机和云端会话,在手机上看进度、批准改动、续跑。按官方文档,这条路要求 claude.ai 订阅登录,且不支持 API Key 和第三方 ANTHROPIC_BASE_URL——我们用本站 Key 复现,claude remote-control 直接报错退出。用 API Key 的读者,可以把 Claude Code / Codex 放进服务器的 tmux,手机 SSH 上去看、批、续:实测 Claude Code 一轮约 14 秒、Codex 约 24 秒完成修 bug 并验证。

Create API Key →

相关阅读:Claude Code 接入第三方 API · git worktree 并行跑 Claude Code / Codex · Agent Autoloop 后台接活 · Codex config.toml 配置

相关文章

UI SDK 是什么、怎么用?Vercel + shadcn 给 Agent 的行为库,在 Claude Code / Codex / Cursor 里安装与实测(0.1.0-beta.1)

UI SDK 是什么、怎么用?Vercel + shadcn 给 Agent 的行为库,在 Claude Code / Codex / Cursor 里安装与实测(0.1.0-beta.1)

UI SDK 是 Vercel 在 2026 年 11 月 12 日发布的、给 Agent 用的行为(behaviors)库,版本 0.1.0-beta.1。行为写在与框架无关的 @ui-sdk/core 里,再由 React、Vue、Svelte、Solid 和 Web Components 适配器渲染。本文按官方文档整理它是什么、怎么安装、怎么给 Claude Code / Codex / Cursor 装 skill,并记录我们在测试机上的真实命令、耗时和输出。

AWS Emulator 是什么、怎么装?让 Claude Code / Codex 在本地测 AWS 应用(1.0.322 实测)

AWS Emulator 是什么、怎么装?让 Claude Code / Codex 在本地测 AWS 应用(1.0.322 实测)

AWS Emulator 是 AWS 官方 2026 年 11 月 12 日(北京时间)正式发布的本地 AWS 模拟器,没有额外服务费、源码开放,不需要 AWS 账号,覆盖 200 多个服务。本文在 Debian 13 上实测 1.0.322:安装命令、AWS CLI 指向本地 endpoint 建 S3 桶和 DynamoDB 表、常见报错,以及让 Claude Code、Codex、Cursor 对着模拟器写代码跑测试的接法。

T3 Code 是什么、怎么装?接入 Claude Code 和 Codex、配置第三方 API Key 与常见报错(0.1.9 实测)

T3 Code 是什么、怎么装?接入 Claude Code 和 Codex、配置第三方 API Key 与常见报错(0.1.9 实测)

T3 Code 是 pingdotgg 开源的编码 Agent 控制台,本身不带模型,调用你机器上已装好的 Claude Code、Codex、Cursor 等 CLI。本文在 Linux 上实测 T3 Code 0.1.9:讲清安装命令,Claude Code 和 Codex 先各自接上 AICodeWith API Key、再由 T3 Code 调用的配置方法,用 t3 thread 命令行跑通两端的过程,以及我们实际遇到的报错和解法。