Claush User Manual

Getting Started

Claush is an app that lets you control Claude Code — the world's most advanced AI coding agent — from your iPhone. Simply chat with the AI using a messaging-style interface, and handle everything from coding to deployment right on your phone.

Requirements

How to Create SSH Keys

If you don't have SSH keys yet, run the following commands in your PC's terminal to create them.

ssh-keygen -t ed25519 -C "your-email@example.com"

ssh-copy-id -i ~/.ssh/id_ed25519.pub username@server-ip-address

cat ~/.ssh/id_ed25519

Server List

When you open the app, the server list screen is displayed. Each server has two buttons.

The gear icon (⚙️) in the top left opens the app-wide settings screen. The + button in the top right lets you add a server.

Settings

Tap the ⚙️ gear icon in the top left of the server list to open the settings screen. Settings are organized as a hub with four categories.

Profile

Go to Settings > Profile to configure the following information. AI responses will be tailored based on your profile.

• Name (last name, first name)
• Nickname
• Virtual Age
• Gender
• Programming Experience: Selecting "No experience" will make the AI avoid technical jargon and provide more gentle guidance

AI Image Generation

Go to Settings > AI Character > "AI Image Generation" section to register an API key for automatic character image generation.

Once an API key is registered and tested successfully, you can switch between "Select Image" and "Generate with AI" on the character creation screen. Choosing "Generate with AI" displays appearance settings (gender, skin, body type, age, hair color, hairstyle) and a preview generation button.

Language Settings

Go to Settings > Language to change the display language. The following 10 languages are supported.

• Japanese, English, Chinese, Korean, Spanish
• French, German, Portuguese, Italian, Arabic

Switching the language is immediately reflected across the entire UI. You can give instructions to the AI in any language.

AI Characters

In Claush, you can give the AI a name, speech style, and personality to create "your own personal companion." Characters remember conversations and naturally adjust their emotional distance based on affinity level.

Creating a Character

Go to Settings > AI Character > "Add Character" to open the creation screen.

Character Details

Go to Settings > AI Character > tap a character's name to open the detail screen.

Displayed Information

• Character Image (manually uploaded / default icon. Can be changed via "Change Image")
• Name and Type
• Affinity: 4 hearts (♡♡♡♡ to ❤️❤️❤️❤️) + score (0-100)
• Inventory: Items owned and a "Give" button

Giving Gifts

Select an item from the inventory and tap "Give" to present it to the character. Giving gifts increases affinity.

Shop

Go to Settings > AI Character > "Shop" to open the item purchase screen.

Points

You earn 1 point for each chat message sent. Points are a shared currency across all characters. There are no in-app purchases.

Items

There are 30 items in total across 6 categories (5 per category). Prices range from 10 to 100 points.

Affinity System

Giving items to a character increases their affinity. As affinity grows, the emotional distance in Claude's responses naturally changes.

Adding a Server

Tap the + button in the top right of the server list screen to add a server.

Creating a Dedicated User

SSH into your server as root from your PC's terminal and run the following commands. (Perform this on your PC, not through Claush.)

adduser claude

usermod -aG sudo claude

mkdir -p /home/claude/.ssh
cp ~/.ssh/authorized_keys /home/claude/.ssh/
chown -R claude:claude /home/claude/.ssh
chmod 700 /home/claude/.ssh
chmod 600 /home/claude/.ssh/authorized_keys

echo 'claude ALL=(ALL) NOPASSWD:ALL' > /etc/sudoers.d/claude

Once complete, specify claude (the created username) as the username on the Claush server setup screen.

Server Settings

Tap the ⚙️ button on the server list to open the settings screen. It consists of 4 accordion sections.

Tap the round button on the right side of each section to expand or collapse it. After making changes, tap "Save" in the top right to apply.

Memory Settings

The memory feature lets the AI remember conversation content across sessions. It enables requests like "continue where we left off yesterday."

Database Types

Setup Steps

Claude Settings

Model Selection

Select the Claude model to use. Each model differs in performance, speed, and cost. The currently selected model is indicated with a checkmark.

Sensitive File Access

Use the toggle to control AI access to sensitive files such as .env. The default is OFF (access denied).

AI Character Assignment

If custom characters have been created, you can select which character to assign to this server. Once assigned, Claude will respond in that character's speech style and personality.

Notification Settings

Get notified when Claude finishes responding via external services. This lets you switch to other tasks while long-running operations are in progress.

Supported Platforms

You need to obtain a Webhook URL from each service beforehand.

Session Basics

Tapping the chat button connects to the server and opens a screen with three tabs.

Three-Tab Layout

Switching Tabs

Tap the ◀ button in the top right to expand the tab picker. Select Chat / Terminal / Claude to switch tabs.

Tap the server icon to the left of the tabs to return to the server list. The tmux session on the server continues running in the background, so you can resume your work by reconnecting.

Connection Status

Check the connection state via the indicator in the top left.

Chat Tab

This is the main screen of Claush. Send a message and Claude Code responds, displayed as chat bubbles.

Sending Messages

Enter a message in the input field at the bottom of the screen and tap the ✈ send button on the right. An animated indicator appears while Claude is processing.

Message Display

• User Messages: Right-aligned blue bubbles
• Claude's Responses: Left-aligned gray bubbles (with avatar when an AI character is set)
• Markdown Support: Code blocks include syntax highlighting and copy buttons

Attachment Menu

Tap the ≡ menu button on the left of the input field to display the following options.

Past Messages

Scroll to the top of the chat and a "Load earlier messages" button appears. Tapping it loads past messages in batches of 30.

Terminal Tab

A full terminal emulator providing raw shell access. Use it for checking files, Git operations, running commands, and more.

Special Key Bar

Control characters that are difficult to type on the standard iOS keyboard can be entered with a single tap from the key bar at the bottom of the screen.

Claude Tab

Displays the Claude Code TUI (Text User Interface) as-is. You can see tool execution details and thinking processes in real time that are omitted in the Chat tab.

You can also type directly in the Claude tab, so you can manually run Claude Code slash commands (/clear, /cost, etc.).

File Transfer

Upload

From the chat attachment menu, tap "Select File" or "Select Photo" to choose a file. The file is uploaded to ~/claush-uploads/ on the server, and Claude is notified accordingly.

Download

Tap "Download File" in the attachment menu to see a list of files in the server's ~/claush-downloads/ directory. Tap a file to download it to your iPhone, and a share sheet will appear.

Tips & Tricks

Break Work into Small Pieces

Keep each instruction to a single user story. This makes it easier to review on a phone screen. You can verify at the PR level, maintaining quality while developing at a good pace.

Check Progress in the Claude Tab

During long-running tasks, switch to the Claude tab to see what's happening in real time. Switch back to the Chat tab to see the results as chat bubbles.

Use Notifications for Async Work

With notifications configured, Claude's response completions arrive on Slack or Discord. This enables an asynchronous development style: send an instruction, close the app, and do something else.

Carry Context Forward with Memory

With the memory feature enabled, the AI remembers the contents of previous sessions. You can enjoy a natural development experience with requests like "continue from yesterday" or "that thing we discussed before."

Work Continues in the Background

Thanks to tmux session management, server-side work continues even after you close the app. The results are automatically retrieved the next time you open the app.

Troubleshooting

Cannot Connect

• Verify that the host, port, and username are correct
• Make sure the private key is copied exactly from -----BEGIN OPENSSH PRIVATE KEY----- to -----END OPENSSH PRIVATE KEY-----, including line breaks
• Root user connections are not supported. Create a dedicated user
• Keyboard-interactive authentication is not supported. Use key-based authentication

Claude Code Won't Start

• Verify that claude login has been completed on the server. You can run this from the Terminal tab
• Verify that the user has sudo privileges (without password). This is required for automatic installation

No Response

• Switch to the Claude tab to check the Claude Code TUI status
• If the connection status in the top left shows "Reconnecting," check your network connection
• If there's still no response after a long time, check directly from the Claude tab or return to the server list and reconnect

Memory Setup Fails

• For PostgreSQL, verify the connection string starts with postgresql:// or postgres://
• Verify that Node.js is installed on the server (it is usually installed automatically)
• Verify that sudo can be run without a password

Character Storage

Character definitions are stored on your iPhone (in-app storage). When switching devices, restore from an iPhone backup.