claude-openrouter-tool 0.1.0

A tool to manage OpenRouter integration with Claude Code.

Claude OpenRouter Tool

Command-line utility for OpenRouter integration with Claude Code. Automates installation and configuration of @musistudio/claude-code-router npm package.

Installation

pipx install claude-openrouter-tool

Requirements

• Python 3.9+
• Node.js/npm
• OpenRouter API key

Commands

setup

claude-openrouter-tool setup

Interactive configuration wizard. Performs npm verification, package installation, API key input, model selection, and configuration file creation.

check

claude-openrouter-tool check

Validates npm installation, router package status, configuration file structure, and API key functionality.

update

claude-openrouter-tool update

Updates @musistudio/claude-code-router to latest version.

config

claude-openrouter-tool config

Interactive configuration management. Supports viewing settings, editing API keys, managing models, and setting defaults.

Supported Models

Model	Parameters	Application
deepseek/deepseek-r1:free	671B	Complex reasoning (default)
deepseek/deepseek-v3-0324:free	685B MoE	General coding
qwen/qwen-2.5-coder-32b-instruct:free	32B	Code generation
Llama/Mistral variants	Various	Lightweight operations

Configuration

File location: ~/.claude-code-router/config.json

{
  "Providers": [{
    "name": "openrouter",
    "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
    "api_key": "sk-or-...",
    "models": ["deepseek/deepseek-r1:free"]
  }],
  "Router": {
    "default": "openrouter,deepseek/deepseek-r1:free"
  }
}

Usage

1. Install: pipx install claude-openrouter-tool
2. Obtain API key: OpenRouter.ai
3. Configure: claude-openrouter-tool setup
4. Verify: claude-openrouter-tool check

Model Management

Add additional models via configuration menu:

claude-openrouter-tool config

Supported model additions:

• anthropic/claude-3-haiku:beta
• google/gemini-pro-1.5
• openai/gpt-4o-mini

Change default model via "Set Default Model" menu option.

Integration

Router package proxies API requests to OpenRouter. Configured models appear automatically in Claude Code interface.

Troubleshooting

Issues and Solutions

Problem	Solution
npm not found	Install Node.js from nodejs.org, verify PATH
Permission denied	Use sudo npm install -g @musistudio/claude-code-router
Invalid API key	Verify sk-or-... format, check account credits
Configuration missing	Execute claude-openrouter-tool setup
Models not visible	Verify package status, restart Claude Code

Diagnostics

claude-openrouter-tool check

Reports npm status, package version, configuration validity, and API key functionality.

References

• OpenRouter documentation
• Router repository

Alternative Commands

ortool-claude setup|check|config|update

Development

Technology Stack

• Python 3.9+, Click framework
• pytest with pexpect testing
• uv package management

Environment Setup

git clone <repository-url>
cd claude-openrouter-tool
uv sync
uv run pre-commit install

Testing

uv run pytest

Architecture Components

• JSON configuration management
• Automated npm package handling
• Interactive CLI with inquirer prompts
• Comprehensive validation system