Ephemeral and secure runner for Claude Code CLI in ScioNos environment
npm install claude-scionosnpx
claude-scionos, ensure you have:
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
``