Terminal & Claude Code/Codex
ServerCC provides a full-featured terminal for interacting with Claude Code and Codex. The terminal supports VT100/Xterm emulation with real-time bidirectional I/O.
Terminal Interface
Input Field
The terminal uses a dedicated input field at the bottom of the screen (not the system keyboard directly). This provides a better experience for composing multi-line prompts and interacting with Claude.
Multi-line Edit Mode
For longer prompts, switch to Multi-line Edit Mode — a full-height editor that lets you draft, review, and revise before sending. It pairs particularly well with voice-to-text keyboards: dictate a full paragraph, correct typos in-place, then send the whole thing to Claude or Codex in one shot.
While you edit, the underlying terminal input is kept in sync — what you see in the editor is exactly what will be delivered to the agent, so there are no surprises on send.
Quick Keyboard
The panel above the input field has three pages. It opens on the middle page; swipe to switch.
- Terminal keys — swipe right from the middle page. ⇧, Ctrl and Alt modifiers plus arrow, Home, End, Page Up and Page Down keys. Tap a modifier for the next key or double-tap to lock it. On this page the system keyboard types straight into the terminal.
- Control keys — the middle page. Esc, Tab, 1–4, Backspace, the agent's mode key (Shift+Tab, labeled for what it does in that agent, such as
planin Claude Code), the arrow keys and Enter. Codex shows ⇧← in place of Shift+Tab. Grok Build and OpenCode add a Stop key. - Quick commands — swipe left from the middle page. Built-in slash commands for the current agent, such as
/plan,/compactand/modelfor Codex, plus commands you add.
To change the control keys and quick commands, open Settings → Preferences → Terminal → Quick Commands. Pick an agent, then drag keys between Control Keys, Quick Commands and Available Commands. + adds your own command or keystroke. Layouts are saved per agent and apply in every server and workspace.
Attaching Images
Tap the photo button next to the input field to attach images from your photo library — screenshots, mockups, diagrams, whiteboard photos. You can select multiple images; each is converted to JPEG, uploaded to the server over SFTP, and shown as a thumbnail chip above the input while you keep typing.
When you send the message, the attachments are handed to the agent as native image references — both Claude Code and Codex pick them up and can see the image content. Tap the ✕ on a chip to remove an attachment before sending.
Fullscreen Mode
Toggle fullscreen mode to maximize the terminal area. In fullscreen mode, the system keyboard is enabled directly for terminal input, and the bottom toolbar is hidden.
No Flicker Mode
No Flicker mode switches Claude Code to a full-screen TUI with tap/mouse support, significantly reducing screen flickering on slower or high-latency connections. Enable it in the workspace's Session Picker under Settings. See Workspace Settings for details.
Bottom Toolbar
The toolbar at the bottom shows three tabs of your choice, picked from four available ones in Settings → Preferences → Terminal → Bottom Toolbar Tabs:
- Files — Open the file browser for this workspace
- Git Diff — Review the working changes GitHub-style — see Git Diff
- Skills — Manage Claude Code skills for this workspace
- MCP — Configure MCP servers
Sessions, Ports, VNC, and the other workspace actions live in the top-right menu (⋯). If you prefer a completely clean screen, the Hide Bottom Toolbar toggle in the same Terminal settings removes the toolbar entirely.
Terminal Appearance
In Settings → Preferences → Terminal you can adjust the terminal font size with a slider (with a one-tap reset to the default). A smaller font fits more of Claude's output on screen; a larger one is easier to read at arm's length.
ServerCC has eight built-in terminal themes, including light ones. Switch themes in a session from ⋯ → Terminal Theme with a live preview, or set the default in Settings → Preferences → Terminal → Terminal Theme.
The terminal tells the server whether the current theme is light or dark, so agents that follow the terminal, such as Claude Code in its auto theme, pick matching colors (under tmux this needs tmux 3.6 or later). Text is also kept at a minimum contrast against the background, so text an agent draws in the background color stays readable.
Copying Text
When an agent or tmux copies text with OSC 52 (for example Claude Code's copy on select, or a copy in tmux copy mode), the text goes to your phone's clipboard and Copied to Clipboard appears. ServerCC turns on tmux's set-clipboard and allow-passthrough options for the sessions it attaches, so copies made inside tmux get through.
Long-press the terminal to select text yourself, then tap Copy or Select All. While a selection is showing, drag to move its ends and tap to dismiss it. With Claude Code 2.1.176, Codex 0.163.0, Pi 0.84.2, OpenCode 1.1.51 or later, a long-press followed by a drag selects in the agent itself, with a magnifier above your finger, and the agent copies the selection.
In herdr panes, an agent's OSC 52 copy does not reach the phone yet: herdr sends it only to its own terminal client. A later update will add this. Long-press selection works in herdr.
iPhone Duo
On the unfolded iPhone Duo, the terminal shares the screen with the Files, Skills, MCP and Git Diff tools, and the layout follows folding and display changes. In landscape, the Swap Terminal and Tools button moves the terminal to the other side of the tools; ServerCC remembers the side you choose. Closed, the Duo works like any other iPhone.
Login Flow
When starting Claude Code for the first time (or after session expiry), you'll need to authenticate:
Claude Code outputs a login URL in the terminal.
ServerCC detects the URL and shows a native Authentication Required alert with Open Login Page and Cancel buttons.
Tap Open Login Page to finish OAuth in the in-app Safari view. After logging in, copy the pairing code shown on the page and paste it into the terminal input field.
Session Lifecycle
When you navigate away from the terminal, you have several options:
- Background — Keep Claude running in the background. The session appears in the Running tab and can be resumed later.
- Exit — End the Claude session and close the terminal connection.
Reconnection
If the SSH connection drops (network change, server restart, etc.), ServerCC shows a reconnection banner and automatically attempts to reconnect with exponential backoff (up to 3 retries). You can also tap the banner to retry manually.
Pure Terminal
ServerCC also provides a Pure Terminal mode — a direct SSH shell without Claude Code/Codex. Access it from the server detail screen under the Terminal section. This is useful for:
- Running system commands directly
- Checking server logs
- General server administration
- Debugging connection issues