Claude Code (via ScioNos)

---

$3

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

---

$3

claude-scionos 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 ScioNos environment.

---

$3

- 🔒 Token Isolation — Authentication token never written to disk
- 🔄 Model Mapping — Transparently route requests to GLM-4.7 or MiniMax-M2.1 via local proxy
- 💾 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

---

$3

Before using claude-scionos, ensure you have:

- Node.js version 22 or later (Download)
- A valid ANTHROPIC_AUTH_TOKEN from https://routerlab.ch/keys

(Note: If Claude Code is not installed, the tool will offer to install it for you automatically.)

---

$3

#### Option 1: Direct Execution (Recommended)

No installation required! Run directly with npx:

``bash
npx claude-scionos
`

#### Option 2: Global Installation

For frequent use, install globally:

`bash
npm install -g claude-scionos
`

Then run:

`bash
claude-scionos
`

---

$3

#### Basic Usage

Run the command:

`bash
npx claude-scionos
`

What happens:

1. Checks if Claude Code CLI is installed (if not, offers automatic installation)
2. Prompts for your ANTHROPIC_AUTH_TOKEN and validates it instantly
3. Selection Menu: Choose your model strategy:
- Default: Use standard Anthropic models (Opus/Sonnet/Haiku)
- Force GLM-4.7: Maps all requests to GLM-4.7
- Force MiniMax-M2.1: Maps all requests to MiniMax-M2.1
4. Launches Claude Code (starting a transparent local proxy if needed)
5. Automatically cleans credentials on exit

#### Debugging

If you encounter issues, you can run with the debug flag to see detailed diagnostic information:

`bash
npx claude-scionos --scionos-debug
`

#### Command Line Options

`bash

Display version

npx claude-scionos --version
npx claude-scionos -v
`

#### Full Claude Code Compatibility

claude-scionos 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-scionos --model opus "explain this code"
- npx claude-scionos --verbose --continue
- npx claude-scionos -p --output-format json "query"
- npx claude-scionos --chrome --agents '{"reviewer":{...}}'

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

---

$3

1. Verification: Checks if claude command is available in your PATH
2. Token Validation: Prompts for and validates your token in real-time via the API (ensuring it works before launch)
3. Environment Setup: Creates isolated environment variables:
- ANTHROPIC_BASE_URL → https://routerlab.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.

---

$3

While claude-scionos 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://routerlab.ch/keys
- Avoid running on shared/untrusted systems
- Use for local development or secure CI/CD pipelines

---

$3

#### Error: 'claude' command not found

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

Solution:
`bash
npm install -g @anthropic-ai/claude-code
`

Verify installation:
`bash
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-scionos 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:

`bash
# 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:

`bash
npx claude-scionos
`

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

---

#### Token authentication fails

Problem: Invalid or expired token.

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

---

#### Node.js version error

Problem: Node.js version is below 22.

Solution:
`bash

Check your Node version

node --version

Upgrade Node.js to version 22 or later

Visit: https://nodejs.org/

`

---

$3

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:

`bash

Clone the repository

git clone https://github.com/ScioNos/claude-scionos.git
cd claude-scionos

Install dependencies

npm install

Test locally

node index.js
``

---

$3

MIT License — © 2025 ScioNos

See LICENSE file for details.

---

$3

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

---