# 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 应填写：
>
> ```text
> 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 可以在控制台中创建：

1. 打开 QuickRouter API 
2. 登录账号
3. 进入「令牌管理」
4. 点击「添加令牌」
5. 创建用于 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 官网较慢时，可以使用清华镜像：

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

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

```text
64-bit Git for Windows Setup.exe
```

安装时建议勾选：

```text
Add Git to PATH
```

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

### 2. 以管理员身份打开 PowerShell

在开始菜单中搜索：

```text
PowerShell
```

右键选择：

```text
以管理员身份运行
```

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

### 3. 安装 Claude Code

在 PowerShell 中执行：

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

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

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

执行：

```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"
```

示例：

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

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

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

进入你的项目目录：

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

启动 Claude Code：

```powershell
claude
```

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

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

---

## 五、macOS 安装 Claude Code

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

### 1. 安装 Homebrew

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

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

### 2. 安装 Node.js

```bash
brew install node
```

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

```bash
node --version
npm --version
```

### 3. 安装 Claude Code

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

验证安装：

```bash
claude --version
```

### 4. 配置 QuickRouter API

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

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

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

写入以下内容：

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

保存后退出。

注意：

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

### 5. 启动 Claude Code

进入项目目录：

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

启动：

```bash
claude
```

---

## 六、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
```

验证安装：

```bash
node --version
npm --version
```

### 2. 安装 Claude Code

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

验证安装：

```bash
claude --version
```

### 3. 配置 QuickRouter API

创建 Claude Code 配置目录：

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

写入：

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

保存后退出。

### 4. 启动 Claude Code

进入你的项目目录：

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

启动 Claude Code：

```bash
claude
```

---

## 七、Claude Code 常用操作方式

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

例如：

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

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

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

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

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

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

---

## 八、常见问题处理

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

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

请检查：

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

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

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

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

### 3. 出现 fetch failed 怎么办？

可以按下面顺序排查：

1. 退出 Claude Code
2. 重新打开终端
3. 重新进入项目目录
4. 再次运行 `claude`
5. 检查 API Key 和 Base URL
6. 检查当前网络是否可访问 

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

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

```powershell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
```

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

```powershell
claude --version
```



---

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

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

### Windows PowerShell

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

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

```powershell
claude
```

### macOS / Linux

编辑：

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

写入：

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

然后进入项目目录运行：

```bash
claude
```

---

## 十、总结

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

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



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

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

人工智能

开发工具

编程语言

国内开发者快速接入ClaudeCode编程助手教程，支持Windows/macOS/Linux系统安装。通过QuickRouterAPI实现国内直连Claude大模型，解决访问不稳定问题。详细步骤包含环境配置、API设置、项目启动指南，助您高效完成代码开发、调试、文档生成等任务。

Windows

Ubuntu

Debian

Linux

JSON

2026采购季 | AI焕新·智启新局

tcap

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

Claude Code 国内直连使用教程： 快速接入 Claude 顶级大模型-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

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

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