convez.ai
AgenteProdutividadeIntermediário
zyh530

Claude Mobile

zyh530/claude-mobile

Controle Claude remotamente do seu celular, tablet ou navegador

Ver no GitHub
BomPluginScore · de 0 a 100

Agent que oferece controle remoto de Claude via interface web, acessível em múltiplos dispositivos (móvel, tablet, desktop). Inclui gerenciamento de sessões, terminal remoto integrado, autenticação segura e arquitetura que mantém chaves de API apenas no dispositivo local.

Instalação

$npx convez-ai zyh530/claude-mobile

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
64
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 8 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Acessar e continuar sessões de Claude de qualquer dispositivo na mesma rede
  • Executar comandos de terminal no desenvolvimento remoto via navegador
  • Gerenciar múltiplas sessões Claude com aprovação de operações críticas
  • Implantar Claude em ambiente corporativo com autenticação por token

Veredito

Projeto robusto de infraestrutura para acesso remoto a Claude Agent. Arquitetura com bom isolamento de segurança (API Key local apenas), suporte mobile sólido e terminal integrado — recomendado para desenvolvedores que precisam acessar ambientes de desenvolvimento de múltiplos dispositivos.

README

A tradução para o português deste README ainda está na fila.

Claude Mobile

通过网页远程控制开发机上的 Claude Agent。支持手机、平板、电脑多端访问。

特性

  • 远程会话管理 — 创建、恢复、追加指令,实时流式输出
  • Markdown 渲染 — Claude 回复自动渲染为 Markdown + 代码高亮
  • 远程终端 — 在浏览器中直接操作开发机命令行(xterm.js + node-pty)
  • 移动端优化 — 响应式布局 + 终端快捷键工具栏(方向键、Tab、Ctrl+C 等)
  • Token 认证 — 可选的访问控制,防止未授权访问
  • 审批机制 — 高风险操作需手动批准
  • Profile 系统 — 自定义 Claude 行为参数(工具、模型、MCP 等)
  • 零外部依赖 WebSocket — 手写实现,无需 ws 库

架构

浏览器 (Web)  ←→  云端中继 (Cloud)  ←→  开发机 Agent
   展示/交互         路由/状态            执行 Claude SDK

安全设计:

  • API Key 仅存放开发机,云端和 Web 永远不接触
  • Agent 主动连出,不暴露公网命令执行入口
  • 可选 Token 认证,防止未授权访问

快速开始

# 安装依赖(需要 Node.js 20+)
npm install

# 配置环境变量
cp .env.example .env
# 编辑 .env,填入 ANTHROPIC_API_KEY

# 启动云端中继(终端 1)
npm run cloud

# 启动 Agent(终端 2)
npm run agent

浏览器打开 http://127.0.0.1:3456

手机访问(局域网)

确保手机和电脑在同一 Wi-Fi,访问 http://<电脑局域网IP>:3456。

建议开启认证:

# Cloud 和 Agent 都设置相同的 AUTH_TOKEN
AUTH_TOKEN=your-secret npm run cloud
AUTH_TOKEN=your-secret npm run agent

环境变量

变量默认值说明
CLOUD_PORT3456Cloud 监听端口
AUTH_TOKEN(空)访问认证 Token,不设则跳过认证
AGENT_CLOUD_URLws://127.0.0.1:3456/wsAgent 连接地址
ANTHROPIC_API_KEY(必填)Claude API 密钥(仅 Agent 需要)
CLAUDE_MODELclaude-sonnet-4-6Claude 模型

完整变量列表见 .env.example。

文档

技术栈

项目结构

apps/
  cloud/                # 云端中继服务
    server.js            # 入口
    lib/                 # 模块:auth, http, ws-handler, sessions, devices, terminal
    public/              # Web 前端(SPA)
      app.js             # 前端入口
      js/                # 模块:state, ws-client, renderer, terminal
  agent/                # 开发机 Agent
    index.js             # 入口
    lib/                 # 模块:claude-runner, sessions, terminal, profiles
packages/
  shared/               # 零依赖共享库
    protocol.js          # 消息协议、常量、工具函数
    ws.js                # WebSocket 客户端 + 服务端实现
    json-store.js        # JSON 文件持久化

License

Apache License 2.0

Ver o original no GitHub

Bom para

Relacionados