# Claude Code完全配置指南：国内直连全球AI大模型

> 适用场景：想在国内网络环境下使用 Claude Code，调用 Claude 系列模型进行代码阅读、生成、重构和调试。

---

## 一、为什么用 Claude Code 

Claude Code 是 Anthropic 推出的命令行 AI 编程助手。它不是普通网页聊天工具，而是直接运行在终端里，可以在你的项目目录中读取代码、理解上下文、辅助修改文件、解释报错、生成实现方案，并配合 Git 工作流完成开发任务。

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

本文按照分别覆盖 Windows、macOS、Linux 三类系统。

---

## 二、接入前准备

开始前先准备下面几项：

| 项目 | 说明 |
| --- | --- |
| 账号 | 用于获取 API 令牌 |
| Claude Code 专用令牌 | 建议单独创建，便于额度和权限管理 |
| Node.js LTS | 用于安装 Claude Code CLI |
| 本地项目目录 | Claude Code 通常在项目目录中启动 |

---

## 三、Windows 安装 Claude Code

Windows 用户建议通过 WSL / Ubuntu 运行 Claude Code，这样更接近 Linux 开发环境，也能减少路径和权限问题。

### 1. 安装 WSL / Ubuntu

以管理员身份打开 PowerShell，执行：

```bash
wsl --install
```

安装完成后重启电脑，然后从开始菜单打开 Ubuntu。

> 说明：打开 Ubuntu 是因为后续的 Node.js、Claude Code 和项目命令都建议在 WSL Ubuntu 终端中执行，而不是直接在 Windows CMD 里运行。

### 2. 在 Ubuntu 中安装 Node.js LTS

打开 Ubuntu 终端，执行：

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

检查版本：

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

### 3. 安装 Claude Code

继续在 WSL Ubuntu 终端中执行：

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

如果能正常显示版本号，说明 CLI 已安装完成。

### 4. 配置  API

在 Ubuntu 终端中创建 Claude 配置目录：

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

保存后退出。

### 5. 启动 Claude Code

进入你的项目目录：

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

首次启动时，按提示完成以下操作：

- 选择终端主题
- 确认安全须知
- 使用默认 Terminal 配置
- 信任当前工作目录
- 开始输入开发任务

---

## 四、macOS 安装 Claude Code

macOS 用户可以直接在系统终端中安装和使用 Claude Code。

### 1. 安装 Node.js

如果已经安装 Homebrew，可以执行：

```bash
brew install node
```

检查版本：

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

如果没有 Homebrew，也可以直接访问 Node.js 官网下载 LTS 安装包。

### 2. 安装 Claude Code

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

### 3. 配置  API

创建配置目录：

```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. 启动使用

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

建议在真实项目根目录中启动，这样 Claude Code 可以直接读取项目结构、依赖文件和源码上下文。

---

## 五、Linux 安装 Claude Code

Linux 用户可以直接在终端中完成安装。以下示例适用于 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
claude --version
```

### 3. 配置  API

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

---

## 六、API 令牌创建建议

进入 QuickRouter API 控制台后，打开左侧菜单：

```text
令牌管理 → 添加令牌
```

建议这样设置：

| 配置项 | 建议 |
| --- | --- |
| 令牌名称 | Claude Code |
| 过期时间 | 永不过期，或按你的安全策略设置 |
| 额度设置 | 可设为无限额度，也可以设置单独额度上限 |
| 分组 | 选择 Claude Code 专属分组，或 Claude 相关可用分组 |
| 其他选项 | 保持默认 |

建议 Claude Code 单独使用一个令牌，不要和其他工具共用。这样出现调用异常、额度消耗异常或权限调整时，更容易排查。

---

## 七、常见问题

### 1. Claude Code 的 Base URL 要不要加 `/v1`？

不要。

Claude Code 使用：

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

不要写成：

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

`/v1` 通常用于 OpenAI 兼容接口场景，例如 Codex、OpenAI SDK、部分第三方客户端等。

### 2. Windows 为什么建议打开 Ubuntu？

因为 Claude Code 更适合在类 Unix 环境中运行。Windows 上通过 WSL Ubuntu 执行安装和项目命令，可以减少路径、权限、Shell 兼容性问题。

### 3. 配置文件在哪里？

不同系统路径一致：

```text
~/.claude/settings.json
```

在 Windows WSL 中，这个路径指的是 Ubuntu 环境里的用户目录，不是 Windows 的 `C:\Users\用户名`。

### 4. API Key 应该填在哪里？

填在：

```json
"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌"
```

不要把 Key 写到项目源码里，也不要上传到 GitHub。

---

## 八、适合写给开发者的使用场景

完成安装后，你可以让 Claude Code 处理这些任务：

- 阅读项目结构并总结技术栈
- 分析某个 Bug 的可能原因
- 根据需求生成页面或接口
- 重构重复代码
- 补充 TypeScript 类型
- 编写测试用例
- 解释报错日志
- 协助检查 Git diff

示例：

```text
帮我阅读这个项目，先总结目录结构和主要技术栈，不要修改文件。
```

```text
检查当前报错原因，并给出最小修改方案。
```

```text
帮我实现登录页表单校验，保持现有 UI 风格。
```

---

## 九、总结

Claude Code 更适合需要深度参与本地项目开发的场景。通过 QuickRouter API 配置后，国内开发者可以用更统一的方式接入 Claude 系列模型。

核心配置只需要记住两点：

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

Claude Code 不走 `/v1`，这是和 Codex、OpenAI 兼容接口最容易混淆的地方。配置完成后，在项目目录中执行 `claude`，即可开始使用。

适用场景：想在国内网络环境下使用 Claude Code，调用 Claude 系列模型进行代码阅读、生成、重构和调试。

Claude Code完全指南：国内直连全球大模型API中转站

人工智能

开发工具

后端

国内开发者通过QuickRouterAPI配置ClaudeCode命令行AI编程助手，实现代码阅读、生成、重构和调试。支持Windows(WSL)、macOS和Linux系统安装，提供详细配置指南和API令牌管理建议，解决国内网络环境下使用Claude系列模型的问题。

TypeScript

Windows

GitHub

Ubuntu

Debian

Linux

Unix

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯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完全指南：国内直连全球大模型API中转站-腾讯云开发者社区-腾讯云

Claude Code完全指南：国内直连全球大模型API中转站

Claude Code完全指南：国内直连全球大模型API中转站

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐