Claude Code 国内直连安装配置教程：Windows / macOS 图文版

Claude Code 国内直连安装配置教程：Windows / macOS 图文版

适合对象：想在本地电脑使用 Claude Code，并通过国内直连接入 Claude 大模型的开发者。
本文覆盖 Windows 原生安装和 macOS 安装两种方式，不需要复杂配置，按步骤执行即可。

一、Claude Code 是什么？

Claude Code 是 Anthropic 推出的终端 AI 编程工具。它不是普通网页聊天，而是可以在你的项目目录里直接读取代码、分析项目结构、生成代码、修改文件、执行命令，适合日常开发、Bug 排查、代码重构和项目维护。

如果你在国内使用 Claude Code，常见问题通常不是工具本身，而是：

• Claude API 访问不稳定
• API Key 和 Base URL 不知道怎么配置
• Windows 环境变量容易不生效
• macOS 下载后可能被系统拦截
• 不清楚 Claude Code 的接口地址是否需要/v1

如果你不想直接使用官方默认接口，也可以通过配置的方式，将 Claude Code 接入QuickRouter APIhttps://quickrouter.ai。完成后，Claude Code 就可以通过 QuickRouter 提供的接口访问对应模型，实现更灵活的接入方式。

二、准备工作

开始前请先准备下面几项：

如果上面的图片路径没有显示，可以在发布文章时替换为你首页或控制台截图。建议截图内容包括：首页、控制台入口、API Key 页面、终端配置过程。

三、重要说明：Claude Code 的 Base URL 不要加/v1

很多用户配置 API 中转时容易写错地址。

Claude Code 接入 QuickRouter API 时，Base URL 应填写：

https://api.quickrouter.ai

不要写成：

https://api.quickrouter.ai/v1

/v1通常用于 OpenAI 兼容接口，例如 Python、Node.js、Codex、OpenAI SDK 等场景。Claude Code 使用 Anthropic 兼容环境变量时，建议使用不带/v1的地址。

Windows 安装 Claude Code（原生安装，无需 WSL）

Windows 用户可以直接使用 PowerShell 安装 Claude Code，不需要安装 WSL / Ubuntu。
安装前建议先准备 Node.js 和 Git for Windows。

1. 安装 Node.js

访问 Node.js 下载页，选择 LTS 长期支持版本：

https://nodejs.org/zh-cn/download

如果官网下载较慢，也可以使用国内镜像：

https://npmmirror.com/mirrors/node/

下载 Windows Installer.msi64-bit 安装包，安装时保持默认选项即可。安装程序会自动配置 PATH 环境变量。

安装完成后，重新打开 PowerShell，执行：

node--version npm--version

如果能看到版本号，说明 Node.js 和 npm 已经安装成功。

2. 安装 Git for Windows

Claude Code 在 Windows 下建议安装 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 是否安装成功：

git--version

3. 以管理员身份打开 PowerShell

在开始菜单搜索：

PowerShell

右键选择：

以管理员身份运行

如果你的普通 PowerShell 已经可以正常安装全局 npm 包，也可以不用管理员权限。
但对新手用户来说，管理员 PowerShell 可以减少 PATH、权限不足、全局安装失败等问题。

4. 安装 Claude Code

在 PowerShell 中执行：

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

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

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

执行：

claude--version

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

如果遇到 PowerShell 脚本执行策略报错，例如：

无法加载文件 claude.ps1，因为在此系统上禁止运行脚本

可以先临时使用下面命令放宽当前用户的执行策略：

Set-ExecutionPolicy-Scope CurrentUser RemoteSigned

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

claude--version

6. 配置 QuickRouter API

访问QuickRouter API 控制台，获取你的 API Key。

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

setx ANTHROPIC_BASE_URL"https://api.quickrouter.ai"

setx ANTHROPIC_AUTH_TOKEN"你的 QuickRouter API Key"

示例：

setx ANTHROPIC_AUTH_TOKEN"sk-xxxxxxxxxxxxxxxx"

注意：setx写入的是新的环境变量，当前窗口可能不会立即生效。
执行完成后，请关闭 PowerShell，再重新打开。

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

进入你的项目目录：

cd D:\your-project

启动 Claude Code：

claude

首次启动时，一般会出现一些初始化选项，按提示选择即可：

• 选择喜欢的主题
• 确认安全提示
• 使用默认 Terminal 配置
• 信任当前工作目录
• 开始使用 Claude Code 编程

macOS 安装 Claude Code

macOS 用户可以使用终端安装 Claude Code。
如果你使用的是 Apple M 系列芯片或 Intel 芯片，整体配置流程基本一致。

1. 打开终端

打开系统自带的 Terminal，或使用 iTerm2 等终端工具。

先确认是否已经安装 Node.js：

node--versionnpm--version

如果没有安装 Node.js，可以访问：

https://nodejs.org/zh-cn/download

也可以使用国内镜像下载：

https://npmmirror.com/mirrors/node/

2. 安装 Claude Code

在终端中执行：

npminstall-g@anthropic-ai/claude-code

安装完成后，重新打开一个新的终端窗口。

验证安装：

claude--version

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

3. 配置 QuickRouter API 环境变量

macOS 使用export配置环境变量。

在终端执行：

exportANTHROPIC_BASE_URL="https://api.quickrouter.ai"

exportANTHROPIC_AUTH_TOKEN="你的 QuickRouter API Key"

这样只对当前终端窗口生效。
如果希望长期生效，需要写入 Shell 配置文件。

4. 写入 zsh 配置文件，长期生效

macOS 默认使用 zsh，可以执行：

echo'export ANTHROPIC_BASE_URL="https://api.quickrouter.ai"'>>~/.zshrc

echo'export ANTHROPIC_AUTH_TOKEN="你的 QuickRouter API Key"'>>~/.zshrc

然后让配置立即生效：

source~/.zshrc

验证环境变量：

echo$ANTHROPIC_BASE_URL

如果输出：

https://api.quickrouter.ai

说明 Base URL 已经生效。

5. 进入项目目录并启动

进入你的项目目录：

cd~/your-project

启动 Claude Code：

claude

首次进入后，根据提示完成初始化即可。

可选：使用 QuickRouter 一键配置工具

如果你不想手动配置环境变量，也可以使用 QuickRouter 首页提供的一键配置工具。

一键配置工具的作用是：

• 配置 Claude Code 的 Base URL
• 写入 API Key
• 配置模型参数
• 减少手动编辑环境变量的步骤
• 本地运行，不上传 API Key

注意：一键配置工具用于配置 Claude Code，不是安装 Claude Code。使用前仍然需要先安装 Claude Code。

常见问题

1. Claude Code 配置 QuickRouter API 时，Base URL 要不要加/v1？

不要加。

Claude Code 使用：

https://api.quickrouter.ai

不要写成：

https://api.quickrouter.ai/v1

2. Windows 设置环境变量后为什么还是不生效？

因为setx写入后，当前 PowerShell 窗口通常不会立即读取新变量。
解决方法：

1. 关闭当前 PowerShell
2. 重新打开 PowerShell
3. 重新进入项目目录
4. 再执行claude

3. macOS 配置后为什么新终端不生效？

请确认是否写入了~/.zshrc：

cat~/.zshrc

确认里面包含：

exportANTHROPIC_BASE_URL="https://api.quickrouter.ai"exportANTHROPIC_AUTH_TOKEN="你的 QuickRouter API Key"

然后执行：

source~/.zshrc

4. 提示 Not logged in 怎么办？

如果你已经配置 QuickRouter API Key，优先检查：

echo$ANTHROPIC_BASE_URL

macOS / Linux 继续检查：

echo$ANTHROPIC_AUTH_TOKEN

Windows PowerShell 检查：

echo$env:ANTHROPIC_BASE_URLecho$env:ANTHROPIC_AUTH_TOKEN

重点确认：

• API Key 是否复制完整
• Base URL 是否为https://api.quickrouter.ai
• 是否错误添加了/v1
• 设置后是否重新打开终端

5. Claude Code 适合哪些场景？

Claude Code 适合放在真实项目里使用，例如：

• 分析项目结构
• 解释陌生代码
• 生成新功能
• 修复 Bug
• 重构旧代码
• 编写测试
• 生成提交说明
• 辅助排查命令行报错

它更适合“在项目目录里工作”，而不是只做普通聊天。

总结

通过 QuickRouter API 配置 Claude Code，核心流程可以概括为三步：

安装 Node.js / Git ↓ 安装 Claude Code ↓ 配置 QuickRouter API Key 和 Base URL

Windows 用户可以直接使用 PowerShell 原生安装，不需要 WSL。
macOS 用户可以通过终端配置环境变量，写入~/.zshrc后长期生效。

最关键的一点是：

ANTHROPIC_BASE_URL="https://api.quickrouter.ai"

Claude Code 使用 QuickRouter API 时，Base URL 不要加/v1。

完成配置后，在项目目录运行：

claude

即可开始使用 Claude Code 辅助开发。