ÆthelHookGuide
How to approve Claude Code and Codex from your phone
A step-by-step walkthrough of setting up remote control for Claude Code and Codex with ÆthelHook, so tool calls, plan reviews, and questions can be answered from your phone instead of your IDE.
What you need
- A Windows PC running Claude Code (CLI or VS Code extension) and/or Codex (CLI or IDE).
- An Android phone.
- No account and no subscription, both installs are free.
1. Download the installer and the app
Grab the Windows installer and the Android APK from the download section on the homepage. Both are also available directly from the GitHub releases page.
2. Run the installer on your PC
Run AethelHook-Setup.exe as Administrator. It installs a background service and the tray app, then opens the tray app automatically. Look for the ÆthelHook icon in your Windows system tray, the row of small icons near the clock. Click the small up arrow (^) if you do not see it right away.
3. Install the app on your phone
Open the APK you downloaded. Android will warn that it is from an unknown source since it is not on the Play Store yet, allow the install and continue.
4. Pair your phone with your PC
In the tray app window, click Pair New Device. It shows a QR code. Open the app on your phone, go to Settings, and tap Scan QR to Pair, then scan the code from the tray window. Pairing is a one-time QR handshake, each device gets its own token, and the connection is end-to-end encrypted with certificate pinning, not a shared cloud relay.
5. Optional: install Tailscale for mobile data
Pairing over the same Wi-Fi network works automatically with no extra setup. If you want approvals to keep working when your phone is on mobile data and your PC is somewhere else entirely, install Tailscale on both devices (free for personal use), sign into the same account on both, and enter your PC's Tailscale IP in the ÆthelHook app's Settings tab.
6. You are done
From here, every tool call, plan review, and clarifying question from Claude Code or Codex routes to your phone. You can allow once, always allow for that project, always allow everywhere, deny, or deny with a reason fed back to the agent, all from the notification.