Claude Code (via ScioNos)

Ephemeral and secure runner for Claude Code CLI

🇫🇷 Lire en français

📖 Table of Contents

• Overview
• Key Features
• Requirements
• Installation
• Usage
• How It Works
• Security Considerations
• Troubleshooting
• Contributing
• License

🛡️ Overview

claude-hubs0225 is an ephemeral and secure runner for the official Claude Code CLI. It initializes all required environment variables directly in memory, ensuring that no configuration files or authentication data are ever written to disk.

The goal is to offer a clean, isolated, and professional execution layer fully compatible with Claude Code, specifically designed for the SNIA environment.

📌 Key Features

• 🔒 Token Isolation — Authentication token never written to disk
• 💾 Zero Persistence — No temporary files or local configuration stored
• 🧩 Full Compatibility — Works seamlessly with the official Claude Code CLI
• 🔐 Memory-Only Storage — All credentials destroyed on process exit
• 🚀 Quick Start — Single command execution via npx
• 🧪 CI/CD Ready — Suitable for automated workflows and pipelines

⚙️ Requirements

Before using claude-hubs0225, ensure you have:

• Node.js version 22 or later (Download)

• Claude Code CLI installed globally:

  npm install -g @anthropic-ai/claude-code

• A valid ANTHROPIC_AUTH_TOKEN from https://hubs02225.snia.ch/console/token

📥 Installation

Option 1: Direct Execution (Recommended)

No installation required! Run directly with npx:

npx claude-hubs0225

Option 2: Global Installation

For frequent use, install globally:

npm install -g claude-hubs0225

Then run:

claude-hubs0225

🚀 Usage

Basic Usage

Simply execute the command:

npx claude-hubs0225

What happens:

1. The tool checks if Claude Code CLI is installed
2. Prompts you to enter your ANTHROPIC_AUTH_TOKEN
3. Launches Claude Code with the token stored only in memory
4. Automatically cleans up credentials when you exit

Example Session

$ npx claude-hubs0225

Claude Code (via ScioNos)
To retrieve your token, visit: https://hubs02225.snia.ch/console/token
? Please enter your ANTHROPIC_AUTH_TOKEN: ********

# Claude Code starts...

Model Selection Strategy

During startup, you can choose how Claude Code interacts with the underlying models:

1. Default: Standard behavior. Claude decides which model to use.
2. Force GLM-4.7: Intercepts traffic via a local proxy and routes everything to GLM-4.7.
3. Force MiniMax-M2.1: Intercepts traffic via a local proxy and routes everything to MiniMax-M2.1.

This feature allows you to experiment with different models seamlessly within the Claude Code interface.

Command-Line Options

# Display version
npx claude-hubs0225 --version
npx claude-hubs0225 -v

Full Claude Code Compatibility

claude-hubs0225 is a transparent wrapper — it accepts all flags and commands supported by the official Claude Code CLI.

You can use any Claude Code flag or command, such as:

• npx claude-hubs0225 --model opus "explain this code"
• npx claude-hubs0225 --verbose --continue
• npx claude-hubs0225 -p --output-format json "query"
• npx claude-hubs0225 --chrome --agents '{"reviewer":{...}}'

For a complete list of available flags and commands, see the official Claude Code CLI documentation.

🔍 How It Works

1. Verification: Checks if claude command is available in your PATH
2. Token Input: Securely prompts for your authentication token (masked input)
3. Environment Setup: Creates isolated environment variables:
   • ANTHROPIC_BASE_URL → https://hubs02225.snia.ch
   • ANTHROPIC_AUTH_TOKEN → Your token (memory only)
4. Execution: Spawns Claude Code process with custom environment
5. Cleanup: Automatically destroys credentials on exit

No files are created. No data persists.

🔐 Security Considerations

While claude-hubs0225 ensures maximum security by keeping tokens in memory only, please be aware:

⚠️ Important Notes:

• Tokens are never written to disk
• Memory dumps or debuggers could potentially expose the token while the process runs
• Tokens are automatically cleared when the process terminates
• Use only in trusted environments

✅ Best Practices:

• Never share your ANTHROPIC_AUTH_TOKEN with others
• Retrieve a fresh token for each session from https://hubs02225.snia.ch/console/token
• Avoid running on shared/untrusted systems
• Use for local development or secure CI/CD pipelines

🛠️ Troubleshooting

Error: 'claude' command not found

Problem: Claude Code CLI is not installed or not in PATH.

Solution:

npm install -g @anthropic-ai/claude-code

Verify installation:

claude --version

Windows: Git Bash not found

Problem: On Windows, Claude Code requires git-bash to run. If you see an error after entering your token, or if claude-hubs0225 exits with a Git Bash warning, this is the issue.

Solution:

1. Install Git for Windows (includes Git Bash):

   Download from: https://git-scm.com/downloads/win

2. Alternative: If Git Bash is already installed but not detected, set the environment variable:

   # Windows Command Prompt
   set CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe
   
   # Windows PowerShell
   $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

3. Restart your terminal and run again:

   npx claude-hubs0225

Note: Git Bash is automatically included when you install Git for Windows. After installation, claude-hubs0225 will detect it automatically.

Token authentication fails

Problem: Invalid or expired token.

Solution:

1. Get a fresh token from https://hubs02225.snia.ch/console/token
2. Ensure you're copying the complete token (no extra spaces)
3. Check your network connection to hubs02225.snia.ch

Node.js version error

Problem: Node.js version is below 22.

Solution:

# Check your Node version
node --version

# Upgrade Node.js to version 22 or later
# Visit: https://nodejs.org/

🤝 Contributing

Contributions are welcome! Here's how you can help:

1. Report Bugs — Open an issue
2. Suggest Features — Share your ideas via issues
3. Submit PRs — Fork, create a branch, and submit a pull request

Development Setup:

# Clone the repository
git clone https://github.com/ScioNos/claude-hubs0225.git
cd claude-hubs0225

# Install dependencies
npm install

# Test locally
node index.js

📝 License

MIT License — © 2025 ScioNos

See LICENSE file for details.

🔗 Links

• Homepage: https://scionos.ch
• npm Package: https://www.npmjs.com/package/claude-hubs0225
• Issues: https://github.com/ScioNos/claude-hubs0225/issues
• Claude Code: https://github.com/anthropics/claude-code

Made with ❤️ by ScioNos

⬆ Back to Top