Skip to content
NorviTech Helios
Browse the Helios guide

Helios / User guide / Claude Code on Linux

Claude Code on Linux

Install Claude Code, verify its sign-in and use its native sessions, approvals, memory and message forks in Helios on Linux.

Helios 0.114.4 · Source reference ↗

Install the native Claude Code CLI

Helios connects to Anthropic’s official claude CLI. Install it separately using the current Claude Code instructions, then verify the executable:

claude --version
claude

Complete the native sign-in flow. Run the installer under your own account, following the vendor’s guidance. Helios can discover a native installation under ~/.local/bin/claude and the vendor’s versioned installation directory.

Verify the account and binary

claude auth status --json

A healthy signed-in response reports loggedIn: true. Open Helios Settings → Accounts and the Claude section of Providers to inspect discovery.

If the terminal finds Claude but the desktop app does not, compare its installation path with the desktop launch environment. HELIOS_CLAUDE_BINARY can select an executable explicitly. Restart Helios after changing its launch environment.

Start a reviewable first task

  1. Choose a project with Ctrl+Shift+N.
  2. Select a discovered Claude model and inspect Execution.
  3. Ask for a read-only explanation of one file and its tests.
  4. Send with Ctrl+Enter, then read the tool activity and result.

Helios uses Claude Code’s existing project context and transcripts. The Claude memory pane exposes supported memory files, and the command suggestions can include the CLI’s reported commands and skills.

Know the native features

Supported Claude sessions expose tool approvals, questions, Plan review, native compaction, subagent activity and background tasks. A saved user message can fork the conversation before that message. See fork behaviour and context and memory.

Reasoning and live model changes depend on the installed CLI and selected model. Use the controls Helios actually offers.

Check account usage

An API key in the environment can select per-token billing even when a subscription login exists. Verified subscription routes omit Helios’s Claude API budget cap. API-equivalent dollar estimates are not subscription invoices.

For the API path, Helios requires the CLI’s supported process-family budget guard. If it reports that the required --max-budget-usd capability is unavailable, update Claude Code. Read usage and budget stops before clearing a budget block.