# Claude Code 国内直连教程：快速接入 Claude code


---

## 一、为什么推荐 Claude Code 搭配 QuickRouter API？

Claude Code 是 Anthropic 推出的命令行 AI 编程工具。和普通网页聊天不同，它可以直接在你的本地项目目录中运行，帮助你阅读代码、分析项目结构、生成代码、修复 bug、解释逻辑和辅助重构。

对于开发者来说，Claude Code 的优势在于它更接近真实开发流程：你不需要频繁复制代码到网页里，也不需要手动描述一堆上下文。只要在项目目录中启动 Claude Code，它就可以围绕当前项目进行交互。

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

---

## 二、准备工作

在开始之前，你需要准备以下内容：

| 准备项 | 说明 |
| --- | --- |
| QuickRouter API 账号 | 用于获取 API Key |
| API Key | 在 QuickRouter API 控制台创建令牌 |
| Node.js / npm | Claude Code 需要通过 npm 安装 |
| Git | Windows 用户建议先安装 Git for Windows |
| 一个本地项目目录 | Claude Code 通常在项目文件夹中运行 |

QuickRouter API 控制台地址：

```text
https://api.quickrouter.ai
```

需要特别注意的是，Claude Code 配置 QuickRouter API 时，Base URL 应填写：

```text
https://api.quickrouter.ai
```

Claude Code 使用的是 Anthropic 相关环境变量，因此这里的接口地址不需要加 `/v1`。

---

## 三、Windows 安装 Claude Code

Windows 用户可以原生安装 Claude Code，不一定需要 WSL / Ubuntu。推荐使用 PowerShell 操作。

### 1. 安装 Git for Windows

如果你还没有安装 Git for Windows，可以先下载安装包。安装时建议勾选：
Add Git to PATH


如果 Git 官网下载较慢，也可以使用清华镜像：

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

选择最新版本，并下载 `64-bit Git for Windows Setup` 结尾的 `.exe` 安装包。

### 2. 打开 PowerShell

在开始菜单搜索：

```text
PowerShell
```

右键选择：以管理员身份运行


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

### 3. 安装 Claude Code

在 PowerShell 中执行：

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

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

### 4. 验证安装

执行：

```powershell
claude --version
```

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

### 5. 配置 QuickRouter API

在 PowerShell 中执行以下命令：

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

将 `你的 QuickRouter API Key` 替换成你在 QuickRouter API 控制台创建的真实令牌。

设置完成后，需要关闭当前 PowerShell，并重新打开新的 PowerShell，让环境变量生效。

### 6. 进入项目目录并启动

示例：

```powershell
cd D:\your-project
claude
```

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

- 选择喜欢的主题
- 确认安全须知
- 使用默认 Terminal 配置
- 信任当前工作目录
- 开始使用 Claude Code 辅助开发

---

## 四、macOS 安装 Claude Code

macOS 用户可以通过 Homebrew 安装 Node.js，然后使用 npm 安装 Claude Code。

### 1. 安装 Homebrew 和 Node.js

如果已经安装过 Homebrew，可以直接跳过 Homebrew 安装步骤。

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

确认能看到 Node.js 版本号后，继续安装 Claude Code。

### 2. 安装 Claude Code

```bash
npm install -g @anthropic-ai/claude-code
claude --version
```

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

### 3. 配置 QuickRouter API

推荐使用 Claude Code 的永久配置方式，在 `~/.claude/settings.json` 中写入环境变量。

先创建目录：

```bash
mkdir -p ~/.claude
```

然后编辑配置文件：

```bash
nano ~/.claude/settings.json
```

写入以下内容：

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

保存后退出。

注意：`ANTHROPIC_BASE_URL` 必须是：

```text
https://api.quickrouter.ai
```

不要加 `/v1`。

### 4. 启动 Claude Code

进入你的项目目录：

```bash
cd your-project-folder
claude
```

按提示完成初始化后，就可以开始在项目中使用 Claude Code。

---

## 五、Linux 安装 Claude Code

以下命令以 Ubuntu / Debian 为例。

### 1. 安装 Node.js LTS

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

### 2. 安装 Claude Code

```bash
npm install -g @anthropic-ai/claude-code
claude --version
```

看到版本号后，说明安装完成。

### 3. 配置 QuickRouter API

创建 Claude Code 配置目录：

```bash
mkdir -p ~/.claude
```

编辑配置文件：

```bash
nano ~/.claude/settings.json
```

写入：

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

其中：

```text
sk-你的API令牌
```

需要替换成你在 QuickRouter API 控制台创建的真实 API Key。

### 4. 启动 Claude Code

```bash
cd your-project-folder
claude
```

首次启动时按照提示完成配置即可。

---

## 六、如何创建 QuickRouter API 令牌？

登录 QuickRouter API 控制台：

```text
https://api.quickrouter.ai
```

进入后台后，找到「令牌管理」，然后点击「添加令牌」。

建议配置如下：

| 配置项 | 推荐设置 |
| --- | --- |
| 令牌名称 | Claude Code |
| 过期时间 | 永不过期 |
| 额度设置 | 按需设置，测试阶段可使用默认配置 |
| 分组 | 选择 Claude Code 专属或 Claude 相关分组 |
| 其他选项 | 保持默认 |

创建完成后，复制生成的 API Key，并填入前面的配置中。

---

## 七、常见问题

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

这个报错通常说明 Claude Code 没有正确读取到 API Key。

可以检查：

- `ANTHROPIC_AUTH_TOKEN` 是否填写正确
- API Key 是否以 `sk-` 开头
- `ANTHROPIC_BASE_URL` 是否填写为 `https://api.quickrouter.ai`
- Windows 是否在设置环境变量后重新打开了 PowerShell
- macOS / Linux 的 `~/.claude/settings.json` 是否保存成功

### 2. 为什么 Claude Code 显示 `offline`？

Claude Code 可能会通过连接 Google 来判断网络状态。如果你的网络环境无法访问 Google，可能会显示 `offline`。

这个状态不一定影响实际使用。只要模型请求可以正常返回，就可以继续使用。

### 3. 请求时出现 `fetch failed` 怎么办？

可以尝试：

```bash
Ctrl + C
claude
```

也就是退出 Claude Code 后重新启动。

如果仍然失败，可以检查网络环境、API Key、接口地址，以及 QuickRouter API 控制台中的令牌权限和额度。

### 4. Base URL 到底要不要加 `/v1`？

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

正确写法：

```text
https://api.quickrouter.ai
```

错误写法：

```text
https://api.quickrouter.ai/v1
```

这是很多用户配置失败的常见原因。

---

## 八、适合哪些使用场景？

Claude Code 搭配 QuickRouter API，适合以下场景：

- 本地项目代码阅读
- 老项目重构
- Bug 定位和修复
- 根据需求生成新功能
- 分析项目目录和依赖关系
- 生成 README、接口文档、注释说明
- 辅助前端页面修改
- 辅助后端接口开发
- 快速理解陌生代码库

相比普通 AI 聊天工具，Claude Code 的优势是可以直接在项目目录中工作，更适合持续开发和复杂项目维护。

---

## 九、总结

如果你正在寻找一种更接近真实开发流程的 AI 编程方式，Claude Code 是一个值得尝试的工具。它可以直接运行在本地项目中，围绕当前代码库进行分析、修改和生成。

通过 QuickRouter API 配置 Claude Code 后，只需要准备 API Key，并设置：

```text
ANTHROPIC_BASE_URL=https://api.quickrouter.ai
ANTHROPIC_AUTH_TOKEN=你的 QuickRouter API Key
```

即可完成接入。

需要重点记住的一点是：Claude Code 使用 QuickRouter API 时，Base URL 填写 `https://api.quickrouter.ai`，不要加 `/v1`。

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

```bash
claude
```

就可以开始使用 Claude Code 辅助开发。

Claude Code 是 Anthropic 推出的命令行 AI 编程工具。和普通网页聊天不同，它可以直接在你的本地项目目录中运行，帮助你阅读代码、分析项目结构、生成代码、修复 bug、解释逻辑和辅助重构。

Claude Code 国内直连教程：快速接入 Claude code

如果你不想直接使用官方默认接口，也可以通过配置环境变量的方式，国内可以直连使用。

人工智能

开发工具

后端

ClaudeCode国内直连教程：通过QuickRouter API快速接入ClaudeCode命令行AI编程工具。支持Windows/macOS/Linux系统安装，详细步骤包含环境配置、API密钥设置和项目目录操作指南。解决常见报错问题，适用于代码阅读、重构、bug修复等开发场景，提升本地项目开发效率。

Windows

Ubuntu

Debian

Linux

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Claude Code 国内直连教程：快速接入 Claude code-腾讯云开发者社区-腾讯云

Claude Code 国内直连教程：快速接入 Claude code

Claude Code 国内直连教程：快速接入 Claude code

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐