Windows环境下的安装配置

环境准备

在开始配置Claude Code Router之前，需要确保系统满足以下基本要求：

首先，确保已安装最新版本的Node.js和npm。可以在PowerShell或命令提示符中运行以下命令检查版本：

node -v
npm -v

建议使用PowerShell（以管理员身份运行）来执行后续的安装和配置命令，这样可以避免权限相关的问题。

安装步骤

第一步：安装Claude Code CLI

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

第二步：安装Claude Code Router

npm install -g @musistudio/claude-code-router

第三步：生成初始配置

在任意目录下运行以下命令启动交互式配置生成器：

ccr start

首次运行时，可以随意填写配置信息，因为后续会直接编辑配置文件。完成初始化后，按Ctrl+C退出。

配置文件详解

配置文件位于Windows系统的用户目录下：

C:\Users\<你的用户名>\.claude-code-router\config.json

可以通过资源管理器直接导航到该路径，或使用文本编辑器打开该文件。

OpenRouter配置实例

基础配置结构

以下是笔者自己使用的一个简单的连接OpenRouter的完整配置示例，供大家参考：

{
  "Providers": [
    {
      "name": "dev",
      "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
      "api_key": "key-xxxxxx",
      "models": [
        "google/gemini-2.5-pro-preview",
        "anthropic/claude-sonnet-4",
        "anthropic/claude-3.5-sonnet",
        "anthropic/claude-3.7-sonnet:thinking"
      ],
      "transformer": {
        "use": ["dev"]
      }
    }
  ],
  "Router": {
    "default": "dev,anthropic/claude-sonnet-4",
    "background": "dev,google/gemini-2.5-pro-preview",
    "think": "dev,google/gemini-2.5-pro-preview",
    "longContext": "dev,google/gemini-2.5-pro-preview"
  }
}

配置参数详解

Providers配置：

• name：提供商的唯一标识符，可以自定义命名
• api_base_url：OpenRouter的统一聊天接口地址
• api_key：在OpenRouter控制台创建的API密钥
• models：可用的模型列表，需要从OpenRouter支持的模型中选择
• transformer：指定使用的转换器，确保API兼容性

Router配置：

• default：指定默认使用的提供商和模型

高级配置选项

对于更复杂的使用场景，可以配置多个提供商和路由规则：

{
  "PROXY_URL": "http://127.0.0.1:7890",
  "LOG": true,
  "APIKEY": "your-secret-key",
  "HOST": "0.0.0.0",
  "Providers": [
    {
      "name": "dev",
      "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
      "api_key": "sk-xxx",
      "models": [
        "google/gemini-2.5-pro-preview",
        "anthropic/claude-sonnet-4",
        "anthropic/claude-3.5-sonnet"
      ],
      "transformer": { "use": ["openrouter"] }
    },
    {
      "name": "deepseek",
      "api_base_url": "https://api.deepseek.com/chat/completions",
      "api_key": "sk-xxx",
      "models": ["deepseek-chat", "deepseek-reasoner"],
      "transformer": {
        "use": ["deepseek"],
        "deepseek-chat": { "use": ["tooluse"] }
      }
    }
  ],
  "Router": {
    "default": "dev,anthropic/claude-3.5-sonnet",
    "background": "deepseek,deepseek-chat",
    "think": "deepseek,deepseek-reasoner",
    "longContext": "dev,google/gemini-2.5-pro-preview"
  }
}