Set up Claude Code for your Rokid Glasses.

Before you start

Check the exact glasses model first. This setup is developed for Rokid Glasses with the built-in display, running YodaOS-Sprite on an Android 12 base. Rokid Max, Air and the display-free Style are not supported by this project. A similarly named product is not enough to establish compatibility.

• A Mac that can stay awake and connected while the agent works.
• Claude Code installed and signed in on that Mac.
• Node.js 20 or later and the Rokid Claude relay.
• Whisper and its speech model for voice transcription.
• Hi Rokid on your phone, developer mode enabled as required for app installation, and an internet connection for the glasses.

Hardware and Claude access are separate from Rokid Claude. See the compatibility checklist before buying anything.

1. Prepare your Mac and a real project

Install Node.js from the official Node.js site and Claude Code using Anthropic’s Claude Code instructions. Open Claude Code in a repository you own or have permission to work on, complete sign-in, and confirm it can answer a simple question about that project.

Rokid Claude discovers projects from local Claude Code session history and checks that their working folders still exist. Creating a normal Claude Code conversation in the intended repository is therefore a useful first step, not just an authentication check.

node --version
claude --version

These read-only checks confirm that the programs are available in Terminal. They do not prove that Claude is authenticated; verify that inside Claude Code itself.

2. Connect the Mac from your account

Open the Rokid Claude setup portal and sign in with your email link. In Your Mac, choose Connect this Mac. Copy the one-time command into Terminal on the Mac that will run the agent.

The command downloads the packaged relay into ~/rokid-relay and starts it using your relay key. That key is private and is shown once. Never paste the command into a public issue, screenshot or shared chat. The starter saves the key locally so it is not needed on every launch.

Voice input needs whisper-cli. The starter explains how to install it if it is missing. Its first model download is roughly 470 MB; allow extra free space and let the download finish. A relay can be online while voice input is still unavailable.

Wait for the portal to show the relay online. Keep its Terminal window open. For later starts, use:

~/rokid-relay/start

The supplied starter uses macOS caffeinate to prevent idle sleep while it runs. It cannot keep working through shutdown, power loss or a disconnected network.

3. Install the app through Hi Rokid

First install Hi Rokid from Rokid’s official download links and connect your glasses in that app. Hi Rokid pairing manages the hardware; the Rokid Claude QR pairing below authorizes access to your Mac. They are separate steps.

In the portal, find Install Rokid Claude and download the glasses app on your phone. In Hi Rokid, open Toolbox → Install a new app, select the downloaded APK and follow the installation prompts.

For an update, install over the existing app rather than uninstalling first. The documented device refused direct adb install, so this guide uses the Hi Rokid installation route. Do not treat an Android base as a promise that every sideloading method works.

Turn on Wi-Fi in the glasses and open Rokid Claude. Allow the microphone for voice input and the camera when using the pairing scanner. If your Hi Rokid menus differ, check your app and device version before proceeding.

Rokid developer mode and app installation

The project’s tested setup uses developer mode enabled on the glasses. Developer-option names and availability depend on the glasses firmware and Hi Rokid version; follow the instructions for your exact model. If the option or installer is missing, check your device and app version and contact Rokid support before proceeding.

Rokid documents Toolbox as the route for installing third-party apps in its official help center. The Rokid Claude cloud pairing code is not an Android wireless-debugging code. This setup does not ask you to root the glasses, flash firmware or expose a debugging port to the internet.

4. Pair the glasses by QR code

1. In the portal, choose Pair a device.
2. Select Rokid Glasses, give the connection a recognizable name, then choose Create pairing code.
3. While Rokid Claude is disconnected on the glasses, tap once to open its scanner.
4. Aim the glasses at the QR code shown by the portal and wait for the connection.

The QR code contains a device credential. Do not publish it. If you close it before scanning, create a fresh pairing entry; revoke unused entries so your device list stays clear.

The Mac and glasses do not have to share a Wi-Fi network in this cloud-broker setup. Both must have working internet access. The glasses can use a phone hotspot.

5. Verify a first, low-risk session

Choose the intended project and ask for a read-only task such as: Explain the structure of this project. Do not change files. Tap to record, speak, and tap again to stop. With the default confirmation setting, read the Heard transcript and choose Send or Discard.

Confirm that the result appears in the glasses and belongs to the expected repository. Only then move on to file-changing tasks. For a larger change, define its scope and review the diff on your Mac before committing or shipping it.

If the relay is online but you receive no transcript, check Whisper and microphone access. If a project is missing, check the local Claude session history. The troubleshooting guide separates these cases.