Claude Code接入任意大模型教程

简介

Claude Code Router 是一个强大的路由工具，它以 Claude Code 为基础构建编程基础设施，允许将 Claude Code 的请求路由到不同的模型提供商，让您可以在享受 Anthropic 官方更新的同时，自由选择和切换任何大模型。

系统要求

操作系统: macOS, Windows, 或 Linux

Node.js: 版本 18.0 或更高

内存: 至少 4GB RAM

网络: 稳定的互联网连接

安装指南

🍎 macOS 安装

方法一: 使用 npm (推荐)

方法二: 使用 Homebrew + npm

🪟 Windows 安装

方法一: 使用 npm

方法二: 使用 Chocolatey + npm

🐧 Linux 安装

方法一: 使用 npm

方法二: 使用包管理器 + npm (Ubuntu/Debian)

方法三: 使用包管理器 + npm (CentOS/RHEL/Fedora)

接入中转站配置

这是将 Claude Code Router 连接到 AQIAPI 中转服务的核心步骤。

1. 创建配置目录

2. 创建配置文件

在 ~/.claude-code-router/config.json 中创建配置文件：

3. 填写配置信息

将以下配置内容写入 ~/.claude-code-router/config.json：

{
  "providers": {
    "aqiapi": {
      "baseURL": "https://bestapi.aqi.email/v1/chat/completions",
      "apiKey": "sk-your-token-here",
      "models": {
        "claude-3-5-sonnet": "claude-3-5-sonnet-20241022",
        "claude-3-haiku": "claude-3-haiku-20240307",
        "gpt-4": "gpt-4o",
        "gpt-3.5": "gpt-3.5-turbo"
      }
    }
  },
  "defaultProvider": "aqiapi",
  "defaultModel": "claude-3-5-sonnet",
  "routing": {
    "background": "gpt-3.5",
    "thinking": "claude-3-5-sonnet",
    "longContext": "claude-3-5-sonnet",
    "coding": "claude-3-5-sonnet"
  }
}

4. 核心配置项说明

配置项	值	说明
baseURL	`https://bestapi.aqi.email/v1/chat/completions`	AQIAPI 中转服务完整地址
apiKey	`sk-your-token-here`	您的 AQIAPI 密钥
defaultProvider	`aqiapi`	默认使用的提供商
defaultModel	`claude-3-5-sonnet`	默认使用的模型

获取配置信息

API 地址 (baseURL): 使用 https://bestapi.aqi.email/v1/chat/completions 作为 AQIAPI 中转服务的完整端点地址。

API 密钥 (apiKey): 请登录 AQIAPI 官网，在控制台创建新的 API 密钥，复制以 sk- 开头的完整密钥。

5. 启动 Claude Code Router

🎯 可用模型列表

配置完成后，您可以使用的具体模型和定价信息，请访问：
👉 查看完整模型列表和定价

使用指南

基本使用

启动 Claude Code Router 后，您可以：

正常使用 Claude Code 功能：所有请求会自动路由到配置的模型

动态切换模型：在对话中使用 /model 命令

智能路由：系统会根据任务类型自动选择最适合的模型

动态模型切换

在 Claude Code 中，您可以使用以下命令切换模型：

智能路由场景

代码编写和重构：自动使用 claude-3-5-sonnet

后台任务：自动使用 gpt-3.5-turbo 节省成本

长文档处理：自动使用支持长上下文的模型

快速问答：自动使用响应更快的轻量模型

❓ 常见问题解答 (FAQ)

Q: 启动时提示 "Configuration file not found"？
A: 请确保配置文件位于正确路径 ~/.claude-code-router/config.json，并且 JSON 格式正确。

Q: API 连接失败，提示认证错误？
A: 请检查以下几点：

API 密钥是否正确复制，必须以 sk- 开头

baseURL 是否为完整地址 https://bestapi.aqi.email/v1/chat/completions

检查网络连接是否正常

Q: 在 macOS 上无法执行 ccr 命令？
A: 这可能是权限问题。请尝试：

Q: Windows 上提示 "ccr 不是内部或外部命令"？
A: 请确保 npm 的全局 bin 目录在系统 PATH 中：

Q: 模型切换后没有生效？
A: 请检查：

模型名称是否在配置文件的 models 中定义

使用 /model 命令的格式是否正确

重启 Claude Code Router 试试

Q: Linux 上安装时提示权限不足？
A: 请使用以下方法之一：

Q: 提示 "Invalid API endpoint" 错误？
A: 请确保 baseURL 配置为完整的端点地址：https://bestapi.aqi.email/v1/chat/completions，而不是简化的地址。

📌 注意事项

API 密钥安全: 您的 API 密钥非常重要，请勿泄露给他人或提交到公开代码仓库。建议使用环境变量存储敏感信息。

用量监控: 定期登录 AQIAPI 控制台查看 API 调用量和费用，合理设置预算提醒。

数据隐私: 通过中转服务的请求会经过 AQIAPI 服务器，请查阅相关隐私政策。

定期更新: 建议定期更新 Claude Code 和 Claude Code Router 到最新版本，以获取新功能和安全修复。

配置备份: 建议备份您的配置文件，避免重新配置的麻烦。

完整端点: 确保使用完整的 API 端点地址，包含 /v1/chat/completions 路径。

🔗 相关链接

Claude Code Router 官方仓库: https://github.com/musistudio/claude-code-router

Claude Code 官方文档: https://github.com/anthropics/claude-code

AQIAPI 官网: https://bestapi.aqi.email

模型定价页面: https://bestapi.aqi.email/pricing

Claude Code接入任意大模型教程

简介#

系统要求#

安装指南#

🍎 macOS 安装#

🪟 Windows 安装#

🐧 Linux 安装#

接入中转站配置#

1. 创建配置目录#

2. 创建配置文件#

3. 填写配置信息#

4. 核心配置项说明#

获取配置信息#

5. 启动 Claude Code Router#

🎯 可用模型列表#

使用指南#

基本使用#

动态模型切换#

智能路由场景#

❓ 常见问题解答 (FAQ)#

📌 注意事项#

🔗 相关链接#

简介