Claude Code is one do most powerful AI-powered coding assistants available today, but using it um partir de um local console window has real limitations: you're tied para o machine where it's installed, você pode't access it um partir de your phone, e there's no fácil way para share um session com um colleague.
sgcClaudeCodeRemote solves all de this. It's um lightweight Windows server that wraps Claude Code dentro um web-based terminal, letting you connect um partir de any browser — em your desktop, laptop, tablet, ou phone. Under o hood, it uses o Windows ConPTY pseudo-console API para um real terminal session, e sgcWebSockets para stream o terminal I/O para o browser em tempo real.
Este artigo covers o features, configuração options, e advantages over running Claude Code directly do console.
Why Use Claude Code Remotely?
sgcClaudeCodeRemote addresses o most common friction points developers face when working com Claude Code no console.
|
Access um partir de Any Device Abrir um browser em your phone, tablet, ou laptop e conectar um Claude Code running em your development machine. No Node.js, no CLI installation — just um URL. |
Collaborative Sessions Multiple developers can join o same named session e see Claude's output em tempo real. Built-in pair programming — no screen sharing tools needed. |
Secure por Default Password autenticação com brute-force protection, configurable timeouts, IP blocking, e optional TLS 1.3 encryption para internet-facing deployments. |
Mobile-Friendly Terminal
The web interface is designed para work em mobile devices. A touch-optimized key toolbar no bottom do screen provides o special keys that Claude Code needs but mobile keyboards lack:
| Button | Function |
|---|---|
| Esc | Cancelar o current operation ou go back |
| Tab | Accept suggestions e autocomplete |
| Intro | Confirm input (Enter key) |
| Ctrl | Sticky modifier — tap once, then tap um letter para combos like Ctrl+C (interrupt) |
| ↑ ↓ ← → | Navigate command history e menus |
The toolbar uses pointerdown events para instant response em touch screens, e prevents focus stealing so o terminal stays active. The viewport adapts para o mobile browser chrome using dynamic viewport units (dvh), ensuring o toolbar is sempre visible sem scrolling.
Named Sessions
Each conexão can specify um session name (e.g. “backend-refactor”, “devops”, “testing”). Sessions persist para o lifetime de o servidor, so você pode desconectar e reconectar later para o same Claude Code instance.
- Multi-client sessions. Multiple browsers can join o same session simultaneously — everyone sees o same terminal output e can type no same console.
- Session history. The browser remembers your 10 most recent sessions em localStorage, com um dropdown para rapidamente reconectar.
- Session indicator. The active session name is displayed no header bar after autenticação.
Autenticação & Security
sgcClaudeCodeRemote inclui multiple layers de protection out do box:
|
Password Autenticação A single shared password protects access. No username is required — just o password. The login form disables browser credential autocomplete para prevent accidental storage. |
Brute-Force Protection After 5 failed attempts do same IP, that address is blocked para 5 minutes. Blocked IPs are rejected no conexão level before any further processing. |
|
Autenticação Timeout Clients must autenticar within um configurable window (default 15 seconds). Idle conexões that don't send credentials are disconnected automaticamente. |
TLS 1.3 Encryption For internet-facing deployments, enable TLS com um certificate e key file. All traffic entre browser e server is encrypted end-to-end. |
Skip permission prompts. A checkbox no login screen (checked por padrão) launches Claude Code com o --dangerously-skip-permissions flag. This is essential para remote sessions where você pode't interact com permission dialogs em o servidor console.
sgcClaudeCodeRemote vs. Console Claude Code
A side-by-side comparison de running Claude Code locally versus through sgcClaudeCodeRemote.
| Feature | Console | sgcClaudeCodeRemote |
|---|---|---|
| Access um partir de any device | No | Yes |
| Mobile / tablet support | No | Yes (touch toolbar) |
| Multiple users em same session | No | Yes |
| Named persistent sessions | No | Yes |
| Password protection | No | Yes (brute-force blocking) |
| TLS encryption | N/A | TLS 1.3 |
| Client software required | Node.js + CLI | Just um browser |
| Pair programming | External tools | Built-in |
| Em tempo real latency display | No | Yes |
| Client platforms | Same machine somente | Windows, macOS, Linux, Android, iOS |
Primeiros passos
Download sgcClaudeCodeRemote e run it do command line com um password:
sgcClaudeCodeRemote.exe --password MySecretPasswordEm seguida abrir your browser e navigate para http://your-server-ip:8765/. Enter o password, choose um session name, e you're in.
Exemplos
Custom port com higher conexão limit:
sgcClaudeCodeRemote.exe --port 9000 --password MyPass --max-conn 20With TLS encryption para secure access over o internet:
sgcClaudeCodeRemote.exe --tls --tls-cert cert.pem --tls-key key.pem --password MyPassCommand-Line Options
| Option | Description | Default |
|---|---|---|
--port |
Server listening port | 8765 |
--password |
Access password (required when auth enabled) | — |
--command |
Command para run no terminal | claude |
--cols / --rows |
Initial terminal dimensions | 120 × 40 |
--max-conn |
Maximum concurrent conexões | 10 |
--timeout |
Autenticação timeout em seconds | 15 |
--no-auth |
Disable autenticação entirely | — |
--tls |
Enable TLS 1.3 encryption | — |
--tls-cert / --tls-key |
Certificate e chave privada PEM files | — |
--tls-password |
Chave privada password (if encrypted) | — |
--tls-port |
TLS listening port | Same como --port |
Use Cases
- Work um partir de your phone. Review code, ask Claude questions, ou run commands um partir de anywhere — o couch, o train, ou um coffee shop.
- Team collaboration. Multiple developers conectar um o same session e interact com Claude em tempo real. No screen sharing needed.
- Headless build servers. Run Claude Code em um powerful remote machine e access it um partir de um thin client ou terminal-less environment.
- Demos e presentations. Share um session URL com your audience. Everyone sees o same live terminal e follows along.
- Secure remote access. Enable TLS, set um strong password, e use Claude Code securely over o internet um partir de any location.
How It Works
sgcClaudeCodeRemote is um Delphi console application built em three core technologies:
|
Windows ConPTY The Windows 10 pseudo-console API creates um real terminal session com full VT100/ANSI sequence support. Claude Code runs dentro this console exactly como it would em um normal terminal window. |
sgcWebSockets The sgcWebSockets library handles all WebSocket communication, HTTP serving, e optional TLS encryption. Binary frames carry terminal output; JSON text frames handle autenticação e control messages. |
xterm.js The browser renders o terminal using xterm.js com o fit addon (auto-resize para window) e web-links addon (clickable URLs). The dark theme matches o Claude Code aesthetic. |
System requirements. O servidor requer Windows 10 version 1809 ou later (for ConPTY support) e Claude Code installed no host machine. Clients need somente um modern web browser.
Web Interface Features
The single-page web UI is embedded directly no executable — no external files para deploy. It inclui:
- Status indicator. Color-coded badge (green = connected, red = disconnected, blue = login required, amber = connecting) com um pulse animation.
- Em tempo real latency. Displays round-trip latency em milliseconds, updated em every frame.
- Terminal dimensions. Shows o current columns × rows e updates dynamically em resize.
- Fit button. Instantly resizes o terminal para fill o browser window.
- Copy & paste. Full clipboard support — Ctrl+C copies selected text, Ctrl+V pastes no terminal.
- Auto-reconectar. If o conexão drops, o cliente automaticamente attempts para reconectar after 3 seconds.
- 10,000-line scrollback. Scroll até review previous Claude Code output sem losing any history.
sgcClaudeCodeRemote is built com sgcWebSockets — high-performance WebSocket components para Delphi e .NET.