ShellSage
ShellSage AI server agent assisting mobile SSH workflow
AI WORKFLOWS

Run Claude or Codex AI on Your Server from Your Phone

Learn how to effectively run Claude or Codex AI directly on your server using ShellSage from your mobile device.


ShellSage tutorial: run Claude or Codex AI on your server from your phone.

To run Claude or Codex AI on your server from your phone, use ShellSage's "Launch Claude" or "Launch Codex" features, choosing between manual or automated control.

Setting Up Your Server for Claude or Codex

Before you can run Claude or Codex AI on your server, you need to ensure that the necessary CLI tools are installed. These AI models require specific command-line interfaces to interact with your server’s environment. Typically, you'll start by accessing your server via SSH. Use a command like ssh user@host to connect securely.

Once connected, you can install the required CLI tools. For most distributions, you'll use a package manager like apt for Ubuntu or yum for CentOS. Here's a general command to install a hypothetical tool:

sudo apt update
sudo apt install claudex-cli

Make sure to replace claudex-cli with the actual package name for the AI model you intend to use. If the package isn't available in your distribution's repositories, you might need to download it from the AI provider's website and follow their installation instructions.

Installing the correct CLI is crucial to interact with Claude or Codex effectively.

How to Use ShellSage to Launch Claude or Codex

With the CLI tools set up, you can now leverage ShellSage to run these AI models from your phone. ShellSage facilitates this through its "Launch Claude" and "Launch Codex" features, which are conveniently pinned at the bottom of the Productivity Toolbox within the app.

To begin, connect to your server using ShellSage. Once connected, tap either "Launch Claude" or "Launch Codex" depending on your needs. ShellSage will prompt you to choose between two modes: "I Want Control" and "Full Automation". In the "I Want Control" mode, the AI will pause at every confirmation prompt, waiting for your explicit Yes or No before proceeding. This mode is ideal if you prefer to oversee each operation closely.

Alternatively, "Full Automation" allows ShellSage to auto-confirm prompts for that session, streamlining processes but placing full responsibility for actions on you. If you ever need to switch back to manual control, simply reconnect to the server.

ShellSage's dual-mode control offers flexibility between manual oversight and streamlined automation.

What Makes ShellSage Different from Other SSH Clients?

While many mobile SSH clients like Termius and JuiceSSH provide fundamental SSH connectivity, ShellSage stands out with its AI-driven features and user-friendly interface. For example, most SSH clients require manual command entry and lack integrated AI support. ShellSage not only allows for voice input, making command entry faster and more convenient on a phone, but it also includes a blast-radius preview feature that assesses the potential impact of commands before execution.

Moreover, ShellSage’s AI assistant, Sage, can explain command outputs and suggest fixes, which is particularly beneficial when dealing with complex AI models like Claude or Codex. This level of integration and assistance is something other SSH clients typically do not offer, making ShellSage a unique choice for developers and sysadmins looking for advanced capabilities.

Executing and Managing AI Workflows on Your Server

Once your AI model is running, managing workflows effectively is key to getting the most out of Claude or Codex. ShellSage provides tools to assist in this regard. For instance, you can use its real SFTP capabilities to manage files directly from your phone, streamlining the process of uploading model inputs and downloading outputs.

Additionally, using the Sage AI assistant, you can gain insights into the AI model's outputs. If a command returns unexpected results, Sage can help explain the output and suggest corrections. This feature is invaluable during troubleshooting and ensures that your AI workflows run smoothly and efficiently.

Here’s a simple workflow example to run a model prediction:

./claudex-cli predict --input data.txt --output results.txt

This command runs a prediction using the input file data.txt and stores the results in results.txt. With ShellSage, you can monitor this process and make adjustments as needed, all from the convenience of your mobile device.

Are There Any Limitations or Considerations?

While ShellSage offers robust features, there are some considerations to keep in mind. Running AI models requires significant server resources, so ensure your server meets the necessary specifications for the AI models you plan to run. Additionally, while "Full Automation" can speed up processes, it's crucial to be aware of the risks associated with auto-confirming commands.

Another practical aspect is network reliability. Running these workflows over a mobile connection can be challenging if your connection is unstable. It’s advisable to use a stable Wi-Fi connection when working with resource-intensive tasks.

Finally, while ShellSage provides a comprehensive suite of tools, always keep your server’s security in mind. Regularly update your software and follow best practices for SSH security to prevent unauthorized access.

⚡ Key takeaways

Marcin Migdal
Your Questions, Answered

Frequently Asked Questions

To transfer files over SSH, you can use the SCP (Secure Copy Protocol) or SFTP (SSH File Transfer Protocol) commands. SCP allows you to copy files between a local and remote host or between two remote hosts. SFTP is a secure version of FTP that works over SSH. With ShellSage, you can easily transfer files using real SFTP directly from your mobile device, making it convenient to manage files on the go.
Yes, you can use an SSH terminal on a phone. Various apps allow you to establish SSH connections from your mobile device to a server, enabling remote management and command execution. ShellSage offers a mobile-first SSH experience with features like voice input and an AI assistant to streamline tasks from your phone.
To run AI models like Claude or Codex on a server, you need to install the necessary command-line interface (CLI) tools provided by the AI model's developers. Access your server via SSH and use your distribution's package manager to install these tools. ShellSage simplifies this process by allowing you to manage installations and run AI commands directly from your mobile device.
ShellSage offers various pricing models, including a free tier with basic functionalities. For advanced features like the AI assistant 'Sage' and voice input, you may need to subscribe to a paid plan. Check the official ShellSage website for detailed pricing information.
ShellSage requires an internet connection to establish SSH/SFTP connections and access the AI assistant 'Sage'. However, some local functionalities, like command history and local file management, may still be accessible offline.
Two layers, and it is worth being exact about both. On your phone the private key is held in encrypted secure storage behind an optional biometric gate. On the server, every host you save has its key or password stored encrypted at rest (AES-256), which is how a new phone picks up your servers without re-entering anything. That means it is encryption at rest rather than end-to-end: the server can decrypt the secret and hands it back to the app when you connect. Your commands, terminal scrollback and voice audio are never stored on ShellSage's servers, and deleting a host removes its stored credential.
Yes, ShellSage can run AI commands using its 'Launch Claude' or 'Launch Codex' features. This allows users to control AI models on their servers directly from their mobile devices, either manually or through automated processes facilitated by the AI assistant 'Sage'.
Download ShellSage free
ShellSage is an AI-first SSH terminal with Sage built in: it explains output, fixes broken commands, and previews the blast radius before anything runs. Start on the free Hobby plan with no credit card, and get a 7-day full-Pro trial when you want everything.
← More tutorials