windows 环境使用 claude code

claude code 一直呼声很高，正好有个 openrouter key 拿来试试水。先说简短使用步骤：

1. 先全局安装 claude code
   npm install -g @anthropic-ai/claude-code
2. 启动 claude code
   2.1. 如果使用第三方 key，安装 claude code router，配置第三方 key
   npm install -g @musistudio/claude-code-router
   执行 ccr start 初始化配置，执行 ccr code 启动 claude code
   2.2. 如果使用 claude 官方账号，执行 claude 启动 claude code，并登录 claude 账号

1. 在常规 windows 中使用 claude code

1.1 安装 claude code

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

1.2 安装 claude code router 配置第三方 key

npm install -g @musistudio/claude-code-router
首次使用执行 ccr start 初始化配置，这里以 openrouter 为例

此时用户文件夹下会生成一个 .claude-code-router/config.json 文件，通过修改该文件来修改第三方 key，修改示例如下：

{
  "LOG": false,
  "Providers": [
    {
      "name": "openrouter",
      "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
      "api_key": "",
      "models": [
        "anthropic/claude-sonnet-4",
        "anthropic/claude-opus-4",
        "anthropic/claude-3.7-sonnet",
        "moonshotai/kimi-k2",
        "google/gemini-2.5-pro"
      ],
      "transformer": { "use": ["openrouter"] }
    }
  ],
  "Router": {
    "default": "openrouter,anthropic/claude-3.7-sonnet",
    "longContext": "openrouter,moonshotai/kimi-k2"
  }
}

1.3 启动 claude code

cd 到项目目录，执行 ccr code 通过 claude code router 启动 claude code

2. 在 wsl 中使用 claude code

2.1 安装 wsl

执行 wsl --install 安装 wsl

2.2 配置 wsl 网络（使用 claude code router 可不用配置）

为了将 windows 环境的代理配置到 wsl 中，需要在用户目录下修改 .wslconfig 文件，内容如下：

[wsl2]
networkingMode=Mirrored
nestedVirtualization=true
dnsTunneling=true
firewall=true
autoProxy=true

配置完成后，需要重启 wsl 才能生效。需要在 wsl 中执行 sudo shutdown now 或者 windows 中执行 wsl --shutdown，再重新启动 wsl，关闭选项卡再打开貌似无效。

2.3 安装 claude code（同 windows）

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

2.4 安装 claude code router 配置第三方 key（同 windows）

npm install -g @musistudio/claude-code-router
首次使用执行 ccr start 初始化配置，这里以 openrouter 为例

此时用户文件夹下会生成一个 .claude-code-router/config.json 文件，通过修改该文件来修改第三方 key，修改示例如下：

{
  "LOG": false,
  "Providers": [
    {
      "name": "openrouter",
      "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
      "api_key": "",
      "models": [
        "anthropic/claude-sonnet-4",
        "anthropic/claude-opus-4",
        "anthropic/claude-3.7-sonnet",
        "moonshotai/kimi-k2",
        "google/gemini-2.5-pro"
      ],
      "transformer": { "use": ["openrouter"] }
    }
  ],
  "Router": {
    "default": "openrouter,anthropic/claude-3.7-sonnet",
    "longContext": "openrouter,moonshotai/kimi-k2"
  }
}

2.5 启动 claude code（同 windows）

cd 到项目目录，执行 ccr code 通过 claude code router 启动 claude code

2.6 注意事项

wsl 与 模拟器不能共存，如果已经存在冲突，导致另一个无法启动

1. 使用 wsl，执行 bcdedit /set hypervisorlaunchtype auto，重启
2. 使用模拟器，执行 bcdedit /set hypervisorlaunchtype off，重启

3. 查看 claude code 用量

为了查看 claude code 多维度的用量情况，这里引入 ccusage 用来可视化用量。全局安装 ccusage
npm install -g ccusage

# 基本用法
ccusage          # 显示每日报告（默认）
ccusage daily    # 每日 token 使用量和费用
ccusage monthly  # 月度汇总报告
ccusage session  # 按对话会话统计使用量
ccusage blocks   # 5小时计费窗口

# 实时监控
ccusage blocks --live  # 实时使用量仪表板

# 过滤器和选项
ccusage daily --since 20250525 --until 20250530
ccusage daily --json  # JSON 格式输出
ccusage daily --breakdown  # 按模型细分费用

ccusage blocks --live 实时使用量仪表板

ccusage daily 每日 token 使用量和费用

参考文档：
一个查看Claude Code用量的工具
claude-code-router