技巧 Linux AI

Claude Code 国内连不上？这款 Github 星标破万的魔法神器助你免费平替所有模型！

Posted by Mike on 2025-08-28

“想让 AI 帮你写代码，但被单一模型限制得死死的？快来试试 Claude Code Router，解放你的编程想象力！”

如果你是个 IT 从业者或科技爱好者，喜欢折腾新工具、追求高效编程，那这篇文章绝对是为你量身打造！

今天，我们要聊一个超酷的 GitHub 开源项目 —— musistudio/claude-code-router。它能让你的 AI 编程体验彻底升级，灵活切换模型、自定义请求，还能无缝融入你的工作流。准备好了吗？让我们一起解锁这个工具的魔法！

Github 开源地址：https://github.com/musistudio/claude-code-router

什么是 Claude Code Router？

Claude Code Router 是一个开源的 Node.js 命令行工具，基于 Anthropic 的 Claude Code CLI 打造。它的核心使命？让开发者摆脱单一 AI 模型的束缚！通过它，你可以将 Claude Code 的请求路由到多个模型供应商，比如 OpenRouter、DeepSeek、Ollama、Gemini 等。简单来说，它就像一个“AI 代码中转站”，帮你根据需求灵活调用不同模型，还能自定义请求和响应。

这个项目为什么值得你关注？它不仅提升了编程效率，还能让你在不依赖 Anthropic 账户的情况下，享受 Claude Code 的强大功能。更重要的是，它开源、免费、社区驱动，随时跟进 Anthropic 的最新更新，简直是程序员的福音！

核心功能：让你的代码更聪明

Claude Code Router 的功能强大到让人心动。以下是它的几大亮点，简单易懂，保证你一看就明白：

1. 灵活的模型路由

想用 Claude 写代码，但觉得它的模型不够给力？Claude Code Router 让你根据任务需求，自由选择模型。比如：

  • 后台任务：交给 Ollama 的轻量模型。

  • 复杂推理：用 DeepSeek 的 deepseek-reasoner。

  • 长上下文处理：切换到 Gemini 的 gemini-2.5-pro-preview。

一句话命令（/model），就能实时切换模型，省时省力！

2. 多供应商支持

支持 OpenRouter、DeepSeek、Ollama、Gemini、Volcengine 等多种模型供应商。你可以根据预算和性能需求，自由搭配，摆脱单一供应商的限制。想用免费模型？没问题！想用高性能模型？也可以！

3. 请求与响应自定义

通过 “转换器”（Transformers），你可以自定义 API 请求和响应的格式。比如，调整 max_tokens 参数，或者为特定模型优化工具调用。这种灵活性让不同供应商的模型无缝适配 Claude Code。

4. GitHub Actions 集成

如果你用 GitHub 做项目，Claude Code Router 能直接嵌入你的工作流。比如，自动触发代码生成、代码审查，甚至处理 PR 和 Issue。效率直接起飞！

5. 插件系统

想加点自己的“魔法”？Claude Code Router 支持自定义插件。你可以编写自己的转换器，扩展功能，满足个性化需求。

6. 降低使用成本

通过支持免费模型和 KV-Cache 技术，Claude Code Router 能帮你省下不少 API 调用费用。对于预算有限的开发者，这简直是救星！

这些功能听起来是不是很诱人？更棒的是，安装和使用超级简单，接下来我们手把手教你！

安装指南：三分钟上手

安装 Claude Code Router 就像搭积木，简单又快。以下是详细步骤，跟着做，保证成功！

1. 准备环境

确保你的电脑已安装 Node.js（推荐版本 v16 或以上）。没有 Node.js？去 Node.js 官网 下载安装，3 分钟搞定。

2. 安装 Claude Code

Claude Code Router 依赖 Anthropic 的 Claude Code CLI，先安装它：

1
2

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

这一步确保你有 Claude Code 的基础环境。

3. 安装 Claude Code Router

接下来，安装主角：

1
2

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

安装完成后，你就拥有了一个强大的 AI 代码路由器！

4. 配置环境

Claude Code Router 需要一个配置文件 ~/.claude-code-router/config.json。你可以参考官方提供的 config.example.json，创建一个属于你的配置。以下是一个简单的配置示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

{

  "APIKEY": "your-secret-key",

  "PROXY_URL": "http://127.0.0.1:7890",

  "LOG": true,

  "API_TIMEOUT_MS": 600000,

  "Providers": [

    {

      "name": "deepseek",

      "api_base_url": "https://api.deepseek.com/chat/completions",

      "api_key": "sk-xxx",

      "models": ["deepseek-chat", "deepseek-reasoner"],

      "transformer": { "use": ["deepseek"] }

    },

    {

      "name": "gemini",

      "api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/",

      "api_key": "sk-xxx",

      "models": ["gemini-2.5-flash"],

      "transformer": { "use": ["gemini"] }

    }

  ],

  "Router": {

    "default": "deepseek,deepseek-chat",

    "think": "deepseek,deepseek-reasoner",

    "webSearch": "gemini,gemini-2.5-flash"

  }

}

配置要点：

  • APIKEY：设置一个密钥，保护你的请求安全。

  • Providers：列出你想用的模型供应商和对应的 API 密钥。

  • Router：定义不同场景的默认模型，比如“think”用于复杂推理，“webSearch”用于搜索任务。

  • PROXY_URL（可选）：如果需要代理访问，填入代理地址。

  • LOG：开启日志，方便调试。

配置好后，保存文件到 ~/.claude-code-router/config.json。

5. 启动服务

一切就绪，运行以下命令启动 Claude Code Router：

1
2

$ ccr code

看到命令行提示服务启动成功，你就进入 AI 编程的新世界了！

小贴士：每次修改 config.json 后，记得运行 ccr restart 重启服务，让配置生效。

使用方法：让 AI 为你写代码

Claude Code Router 的使用简单到爆！以下是几种常见场景，帮你快速上手。

1. 基本使用：生成代码

假设你想让 AI 帮你写一个 Python 函数，比如计算阶乘。运行：

1
2

$ ccr code

然后输入：

1
2
3
4

/model deepseek,deepseek-chat

Generate a Python function to calculate factorial with docstrings and type hints.

几秒后，AI 会返回类似下面的代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

def calculate_factorial(n: int) -> int:

    """Calculate the factorial of a non-negative integer.

    

    Args:

        n (int): The non-negative integer to calculate factorial for.

    

    Returns:

        int: The factorial of n.

    """

    if n < 0:

        raise ValueError("Factorial is not defined for negative numbers")

    if n == 0:

        return 1

    return n * calculate_factorial(n - 1)

直接复制粘贴，代码就能用！

2. 切换模型

想试试 Gemini 的表现？随时切换：

1
2
3
4

/model gemini,gemini-2.5-flash

Generate the same factorial function.

Claude Code Router 会自动将请求路由到 Gemini 模型，灵活又方便。

3. UI 模式管理配置

手动改 JSON 配置文件太麻烦？试试 UI 模式：

1
2

$ ccr ui

这会打开一个网页界面，你可以直观地编辑 config.json，适合新手。

4. GitHub Actions 集成

如果你用 GitHub 管理代码，可以通过 Claude Code Router 的 GitHub Actions 集成，自动处理 PR 或 Issue。比如，配置一个 Action 监听评论中的触发词，自动让 AI 审查代码或生成补丁。详细配置可参考 musistudio/claude-code-router-action。

为什么你会爱上它？

Claude Code Router 就像你的编程“超级助手”。它不仅让 AI 编程更灵活，还能无缝融入你的开发流程。以下是它的魅力所在：

  • 省钱又高效：支持免费模型，降低 API 成本。

  • 自由度爆棚：随时切换模型，满足不同任务需求。

  • 社区驱动：开源项目，更新快，bug 修复及时。

  • 简单易上手：几分钟配置，轻松融入你的工具链。

更重要的是，它让你感受到“掌控 AI”的快感！无论是写代码、优化代码，还是自动化工作流，Claude Code Router 都能让你事半功倍。

小结：开启你的 AI 编程冒险

musistudio/claude-code-router 是一个让人眼前一亮的开源项目。它让 AI 编程变得更灵活、更高效，还能省钱！通过简单的安装和配置，你就能解锁多模型路由、自定义请求、GitHub 集成等强大功能。无论是独立开发者还是团队协作，它都能成为你的得力助手。

还在等什么？快去 GitHub 仓库 给个 Star，下载试试吧！用过之后，别忘了在社区分享你的“魔法时刻”，让更多人感受到 AI 编程的魅力！

“代码不够优雅？让 Claude Code Router 带你飞！你的下一个项目，可能就是从这里开始腾飞的！”

FEATURED TAGS
技巧 Linux AI
FRIENDS