Control Claude Code from Your Phone with remote-claude

1. remote-claude usage

Assuming remote-claude is installed, the workflow consists of four steps:

Start a Claude session on the computer with the cla command.

In Feishu, send the /menu command to the bot to open the menu card.

In the session manager, click “Create Group Chat” to join the session.

After entering the group chat, interact with Claude directly from the Feishu card on the phone.

2. remote-claude environment configuration

Installation

Two installation methods are provided:

npm installation npm install remote-claude Requires the uv and tmux dependencies; the first run may be slow.

Source installation

git clone https://github.com/yyzybb537/remote_claude.git
cd remote_claude
./init.sh

Feishu bot configuration

Run the wizard with: remote-claude lark init The wizard opens a browser to the Feishu smart‑app creation page, where you scan a QR code, grant required permissions, configure event callbacks, and write the local configuration. After creating a version, publish the bot; only published bots appear in Feishu search (example bot name “alllen的智能助手”).

First launch

Execute cla to start the Feishu client and launch Claude with the current directory as the session name.

cla

Viewing sessions

List all local sessions linked to Feishu with:

remote-claude list

Remote command of Claude

Open the session via the bot; the Feishu card enables remote prompting of Claude Code.

Additional installation tips are available in the project README at https://github.com/yyzybb537/remote_claude.

3. Development notes

The project was built with AI assistance in roughly one week. The first weekend involved writing an iteration prompt for Claude and OpenClaw, testing, and iterating the workflow to a usable state. The second weekend focused on redesigning the top‑level architecture to avoid case‑by‑case pitfalls, iterating dozens of times over two days to produce the first usable version, followed by further optimizations that improved the remote‑control experience.