Claude Code 国内直连使用教程：快速接入 Claude 顶级大模型

Claude Code 就是这类工具中很适合开发者使用的一款。它是 Anthropic 推出的命令行 AI 编程助手，可以直接在终端中运行，并围绕当前项目目录进行代码级协作。对于经常写代码、维护项目、改 Bug、整理需求或做二次开发的用户来说，Claude Code 的工作方式比普通聊天窗口更贴近真实开发流程。

不过在国内环境下，很多人使用 Claude时会遇到模型访问不稳定、官方额度不够、模型选择受限等问题。比较实用的方案是把 Claude code桌面版接入 QuickRouter API https://quickrouter.ai 。调用 Claude、Gemini、GPT 等主流模型。

QuickRouter API 支持国内直连使用 Claude 等主流大模型，配置完成后，就可以在本地 Claude Code 中直接使用 Claude 编程能力，不需要频繁切换工具，也不需要复杂代理配置。

一、Claude Code 适合做什么？

Claude Code 不是普通的网页聊天工具，而是一个运行在命令行里的 AI 编程助手。它可以进入你的项目目录，根据当前代码上下文辅助完成开发任务。

常见使用场景包括：

阅读已有项目结构，快速理解代码逻辑
根据需求生成新功能代码
排查报错、定位 Bug、解释异常原因
帮助重构代码、优化目录结构
编写脚本、接口、组件、配置文件
辅助生成 README、接口文档、部署说明
在本地项目中连续完成多轮开发任务

对于开发者来说，Claude Code 的优势在于：它不是单纯回答问题，而是可以围绕本地项目上下文进行协作。

二、为什么建议搭配 QuickRouter API 使用？

Claude Code 默认需要连接 Anthropic 官方接口。对部分用户来说，可能会遇到网络访问不稳定、配置复杂、调用失败等问题。

通过 QuickRouter API 接入后，可以把 Claude Code 的请求转到 QuickRouter API，由 QuickRouter API 负责模型调用。这样更适合希望在国内环境中直接使用 Claude 编程能力的用户。

搭配 QuickRouter API 的主要好处：

支持国内直连调用 Claude 等大模型
配置方式简单，只需要 API Key 和 Base URL
可以统一管理令牌、额度和模型权限
适合 Claude Code、Cherry Studio、OpenCode、Cursor 等多种工具统一接入
对开发者来说，迁移成本低，配置完成即可在终端中使用

需要特别注意：

Claude Code 使用 QuickRouter API 时，Base URL 应填写：
https://api.quickrouter.ai

Claude Code 这里使用的是 Anthropic 兼容方式，因此 Base URL 不需要加 /v1。

三、使用前需要准备什么？

在正式安装 Claude Code 之前，建议先准备好下面几项内容。

准备项	说明
Node.js	Claude Code 通过 npm 安装，需要先安装 Node.js
npm	Node.js 自带 npm，用于安装 Claude Code
Git	Windows 用户建议先安装 Git for Windows
QuickRouter API Key	登录 QuickRouter API 控制台创建令牌
项目目录	Claude Code 通常在具体项目文件夹中运行

QuickRouter API Key 可以在控制台中创建：

打开 https://api.quickrouter.ai/
登录账号
进入「令牌管理」
点击「添加令牌」
创建用于 Claude Code 的专用 API Key

建议令牌配置：

令牌名称：Claude Code
过期时间：可选择永不过期
额度设置：按需设置，也可以设置为无限额度
分组：选择 Claude Code 专属分组，或选择支持 Claude 的相关分组
其他配置：保持默认即可

四、Windows 安装 Claude Code

Windows 用户可以直接使用 PowerShell 原生安装 Claude Code，不一定需要 WSL / Ubuntu。

1. 安装 Git for Windows

如果你的电脑还没有安装 Git，建议先安装 Git for Windows。

国内下载 Git 官网较慢时，可以使用清华镜像：

https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/

进入页面后，选择较新的版本，下载类似下面名称的安装包：

64-bit Git for Windows Setup.exe

安装时建议勾选：

Add Git to PATH

这样后续在 PowerShell 或终端中可以直接使用 Git 命令。

2. 以管理员身份打开 PowerShell

在开始菜单中搜索：

PowerShell

右键选择：

以管理员身份运行

如果普通 PowerShell 已经可以正常安装 npm 全局包，也可以不使用管理员权限。

3. 安装 Claude Code

在 PowerShell 中执行：

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

安装完成后，关闭当前 PowerShell 窗口，然后重新打开一个新的 PowerShell。

4. 验证 Claude Code 是否安装成功

执行：

claude --version

如果能看到版本号，说明 Claude Code 已经安装成功。

5. 配置 QuickRouter API

在 PowerShell 中执行下面两条命令：

setx ANTHROPIC_BASE_URL "https://api.quickrouter.ai"
setx ANTHROPIC_AUTH_TOKEN "你的 QuickRouter API Key"

示例：

setx ANTHROPIC_BASE_URL "https://api.quickrouter.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-xxxxxxxxxxxxxxxx"

设置完成后，请关闭当前 PowerShell，再重新打开新的 PowerShell。

6. 进入项目目录并启动 Claude Code

进入你的项目目录：

cd D:\your-project

启动 Claude Code：

claude

首次启动时，按提示完成初始化即可：

选择终端主题
确认安全提示
使用默认 Terminal 配置
信任当前工作目录
开始使用 Claude Code 辅助开发

五、macOS 安装 Claude Code

macOS 用户建议先通过 Homebrew 安装 Node.js，然后再安装 Claude Code。

1. 安装 Homebrew

如果你还没有安装 Homebrew，可以执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 Node.js

brew install node

验证 Node.js 是否安装成功：

node --version
npm --version

3. 安装 Claude Code

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

验证安装：

claude --version

4. 配置 QuickRouter API

推荐使用 Claude Code 的永久配置方式。

在用户目录下创建或修改配置文件：

mkdir -p ~/.claude
nano ~/.claude/settings.json

写入以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
    "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
    "API_TIMEOUT_MS": "300000"
  }
}

保存后退出。

注意：

ANTHROPIC_BASE_URL 必须是 https://api.quickrouter.ai
不要加 /v1

5. 启动 Claude Code

进入项目目录：

cd your-project-folder

启动：

claude

六、Linux 安装 Claude Code

下面以 Ubuntu / Debian 系统为例。

1. 安装 Node.js LTS

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

验证安装：

node --version
npm --version

2. 安装 Claude Code

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

验证安装：

claude --version

3. 配置 QuickRouter API

创建 Claude Code 配置目录：

mkdir -p ~/.claude
nano ~/.claude/settings.json

写入：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
    "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
    "API_TIMEOUT_MS": "300000"
  }
}

保存后退出。

4. 启动 Claude Code

进入你的项目目录：

cd your-project-folder

启动 Claude Code：

claude

七、Claude Code 常用操作方式

Claude Code 启动后，可以直接用自然语言描述你要做的事情。

例如：

帮我分析这个项目的目录结构，并说明主要模块的作用

帮我检查这个接口为什么返回 500，并给出修改建议

根据当前项目风格，帮我新增一个用户登录页面

帮我把这个组件拆分得更清晰，并保持原功能不变

帮我生成部署说明，要求适合新手阅读

Claude Code 更适合在真实项目目录中使用。建议每次使用前先进入具体项目文件夹，而不是在系统根目录或无关目录中运行。

八、常见问题处理

1. 提示 Invalid API Key / Please run /login 怎么办？

这通常说明 Claude Code 没有正确读取到环境变量或配置文件。

请检查：

ANTHROPIC_AUTH_TOKEN 是否填写正确
API Key 是否以 sk- 开头
ANTHROPIC_BASE_URL 是否填写为 https://api.quickrouter.ai
是否错误添加了 /v1
修改配置后是否重新打开终端
settings.json 是否为合法 JSON 格式

2. 显示 offline 是否影响使用？

Claude Code 可能会通过连接 Google 判断网络状态。部分网络环境下，即使显示 offline，也不一定影响模型调用。

如果 Claude Code 可以正常回答和处理代码任务，可以忽略该状态。

3. 出现 fetch failed 怎么办？

可以按下面顺序排查：

退出 Claude Code
重新打开终端
重新进入项目目录
再次运行 claude
检查 API Key 和 Base URL
检查当前网络是否可访问 https://api.quickrouter.ai

4. Windows 提示无法加载 claude.ps1 怎么办？

如果 PowerShell 提示脚本执行策略限制，可以临时使用下面命令调整当前用户策略：

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

然后重新打开 PowerShell，再执行：

claude --version

5. 为什么不能填写 https://api.quickrouter.ai/v1？

因为 Claude Code 使用的是 Anthropic 兼容环境变量配置，QuickRouter API 在 Claude Code 场景下的 Base URL 应填写：

https://api.quickrouter.ai

/v1 通常用于 OpenAI 兼容接口场景，例如部分 Chat 客户端、OpenAI SDK 或其他支持 OpenAI Base URL 的工具。Claude Code 这里不要加 /v1。

九、适合发布时使用的简版配置总结

如果你已经安装好 Node.js 和 Claude Code，只想快速配置 QuickRouter API，可以直接看下面这部分。

Windows PowerShell

setx ANTHROPIC_BASE_URL "https://api.quickrouter.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-你的API令牌"

然后关闭 PowerShell，重新打开，再运行：

claude

macOS / Linux

编辑：

~/.claude/settings.json

写入：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
    "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
    "API_TIMEOUT_MS": "300000"
  }
}

然后进入项目目录运行：

claude

十、总结

Claude Code 适合希望在本地项目中使用 AI 辅助开发的用户。它可以直接在终端中读取项目上下文，帮助完成代码分析、功能开发、Bug 排查、文档生成和重构优化等任务。

如果你在国内环境中使用 Claude Code，希望减少 API 访问和配置方面的障碍，可以通过 QuickRouter API 进行接入。配置时只需要准备好 QuickRouter API Key，并将 Claude Code 的 Base URL 设置为：

https://api.quickrouter.ai

不要加 /v1。

完成配置后，就可以在 Windows、macOS 或 Linux 中直接运行 Claude Code，并通过 QuickRouter API 调用 Claude 大模型进行本地开发辅助。

Claude Code 国内直连使用教程： 快速接入 Claude 顶级大模型

一、Claude Code 适合做什么？

二、为什么建议搭配 QuickRouter API 使用？

三、使用前需要准备什么？

四、Windows 安装 Claude Code

1. 安装 Git for Windows

2. 以管理员身份打开 PowerShell

3. 安装 Claude Code

4. 验证 Claude Code 是否安装成功

5. 配置 QuickRouter API

6. 进入项目目录并启动 Claude Code

五、macOS 安装 Claude Code

1. 安装 Homebrew

2. 安装 Node.js

3. 安装 Claude Code

4. 配置 QuickRouter API

5. 启动 Claude Code

六、Linux 安装 Claude Code

1. 安装 Node.js LTS

2. 安装 Claude Code

3. 配置 QuickRouter API

4. 启动 Claude Code

七、Claude Code 常用操作方式

八、常见问题处理

1. 提示 Invalid API Key / Please run /login 怎么办？

2. 显示 offline 是否影响使用？

3. 出现 fetch failed 怎么办？

4. Windows 提示无法加载 claude.ps1 怎么办？

5. 为什么不能填写 https://api.quickrouter.ai/v1？

九、适合发布时使用的简版配置总结

Windows PowerShell

macOS / Linux

十、总结

Claude Code 国内直连使用教程：快速接入 Claude 顶级大模型