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

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

---

一、为什么用 Claude Code

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

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

本文按照分别覆盖 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，执行：

wsl --install

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

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

2. 在 Ubuntu 中安装 Node.js LTS

打开 Ubuntu 终端，执行：

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

检查版本：

node --version
npm --version

3. 安装 Claude Code

继续在 WSL Ubuntu 终端中执行：

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

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

4. 配置 API

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

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

写入以下内容：

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

保存后退出。

5. 启动 Claude Code

进入你的项目目录：

cd your-project-folder
claude

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

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

---

四、macOS 安装 Claude Code

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

1. 安装 Node.js

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

brew install node

检查版本：

node --version
npm --version

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

2. 安装 Claude Code

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

3. 配置 API

创建配置目录：

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

cd your-project-folder
claude

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

---

五、Linux 安装 Claude Code

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

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

---

六、API 令牌创建建议

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

令牌管理 → 添加令牌

建议这样设置：

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

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

---

七、常见问题

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

不要。

Claude Code 使用：

https://api.quickrouter.ai

不要写成：

https://api.quickrouter.ai/v1

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

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

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

3. 配置文件在哪里？

不同系统路径一致：

~/.claude/settings.json

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

4. API Key 应该填在哪里？

填在：

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

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

---

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

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

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

示例：

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

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

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

---

九、总结

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

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

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

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