Claude Code 使用 GPT-5.5：国内直连全球AI大模型

Claude Code 使用 GPT-5.5：国内直连一键安装配置指南 + API Key获取

一、教程说明 🚀

Claude Code 是 Anthropic 推出的终端型 AI 编程助手。它不是传统网页聊天工具，而是直接运行在本地项目目录中，可以读取代码、分析项目结构、辅助修复问题、生成代码实现、解释业务逻辑，并协助完成重构和调试。

如果你希望在 Claude Code 中使用 GPT-5.5 模型，可以通过配置第三方 API 网关的方式接入。本文以 QuickRouter API 为例，演示如何让 Claude Code 使用 QuickRouter API 调用 GPT-5.5 模型，实现国内环境下更稳定的直连体验。

本文会按下面顺序展开：

准备 QuickRouter API Key
安装 Node.js
安装 Claude Code CLI
配置 Claude Code 使用 QuickRouter API
指定 GPT-5.5 作为默认模型
分别说明 Windows、macOS、Linux 的配置方法
提供一键配置脚本
汇总常见问题与排查方法

二、Claude Code 适合做什么 🌏

Claude Code 更像一个运行在开发环境里的 AI 编程代理。它可以在终端中直接处理项目相关任务，适合这些场景：

分析项目目录和代码结构
阅读已有代码并解释实现逻辑
根据需求生成新功能
辅助定位和修复 bug
批量修改、重构、优化代码
生成测试用例
协助检查报错日志
辅助完成前端、后端、脚本、配置文件等开发工作

如果你经常使用 VS Code、终端、远程服务器或本地 Git 项目，Claude Code 会比单纯网页对话更贴近真实开发流程。

三、为什么用 GPT-5.5 模型

GPT-5.5 更适合复杂代码任务和长上下文开发场景，尤其适合下面这些工作：

使用场景	适合原因
项目代码分析	能更好理解多文件结构和上下文
Bug 排查	适合结合日志、代码和配置综合分析
复杂功能开发	适合从需求到实现给出完整方案
前端页面优化	能处理组件结构、样式、交互逻辑
后端接口开发	适合生成路由、数据库、鉴权、错误处理
代码重构	能在保持功能不变的情况下优化结构
部署排错	适合分析 Nginx、Docker、PM2、Node.js 等问题

在 Claude Code 中接入 GPT-5.5 后，你可以直接在项目目录里让它分析、修改、生成和排查代码。

四、准备 QuickRouter API Key 🔑

在正式配置 Claude Code 之前，需要先准备一个可用的 QuickRouter API Key。

1）注册 QuickRouter API

打开 QuickRouter API 官网：

https://quickrouter.ai

注册并登录账号。

QuickRouter API 是一个 AI 大模型 API 聚合平台，支持通过统一接口调用多种主流模型。注册后可以进入控制台获取自己的 API Key。

2）获取 API Key

常见流程如下：

登录 QuickRouter API 控制台
进入「令牌」「API Key」或「密钥管理」页面
新建一个 API Key，或者使用系统默认 Key
复制 API Key
妥善保存，不要公开发布

API Key 通常类似下面格式：

sk-xxxxxxxxxxxxxxxxxxxxxxxx

注意：

不要把 API Key 上传到 GitHub
不要写进公开仓库
不要截图公开展示
不要把密钥发给陌生人
如果密钥泄露，建议立即删除并重新生成

五、核心配置信息

本文使用下面这组配置：

配置项	示例值	说明
API Key	`sk-xxxxxxxxxxxxxxxx`	替换成你自己的 QuickRouter API Key
Base URL	`https://api.quickrouter.ai`	QuickRouter API 请求入口
默认模型	`gpt-5.5`	Claude Code 默认调用的模型
配置文件	`~/.claude/settings.json`	Claude Code 用户级配置文件

核心配置内容如下：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换成你自己的APIKey",
    "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
    "ANTHROPIC_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.5",
    "ANTHROPIC_CUSTOM_MODEL_OPTION": "gpt-5.5",
    "ANTHROPIC_CUSTOM_MODEL_OPTION_NAME": "GPT-5.5"
  }
}

字段说明：

字段	作用
`ANTHROPIC_AUTH_TOKEN`	填写 QuickRouter API Key，并作为 Bearer Token 使用
`ANTHROPIC_BASE_URL`	指定 Claude Code 请求 QuickRouter API
`ANTHROPIC_MODEL`	指定当前默认模型
`ANTHROPIC_DEFAULT_SONNET_MODEL`	将 Sonnet 默认模型映射到 GPT-5.5
`ANTHROPIC_DEFAULT_OPUS_MODEL`	将 Opus 默认模型映射到 GPT-5.5
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	将 Haiku 默认模型映射到 GPT-5.5
`ANTHROPIC_CUSTOM_MODEL_OPTION`	在模型选择中增加自定义模型
`ANTHROPIC_CUSTOM_MODEL_OPTION_NAME`	自定义模型显示名称

如果 QuickRouter 控制台里的模型 ID 不是 gpt-5.5，请以控制台实际模型名称为准。

六、Windows 安装与配置 🏡

1）安装 Node.js

Claude Code CLI 依赖 Node.js 环境。Windows 用户建议安装 Node.js LTS 版本。

可以使用 winget 安装：

winget install OpenJS.NodeJS.LTS

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

node --version
npm --version

如果能正常输出版本号，说明 Node.js 和 npm 已安装成功。

2）安装 Claude Code CLI

在 PowerShell 或 CMD 中执行：

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

安装完成后检查版本：

claude --version

如果能输出版本号，说明 Claude Code CLI 已安装成功。

3）创建 Claude Code 配置目录

Windows 下配置目录通常是：

%USERPROFILE%\.claude

配置文件路径为：

%USERPROFILE%\.claude\settings.json

可以在 PowerShell 中执行：

mkdir $env:USERPROFILE\.claude
notepad $env:USERPROFILE\.claude\settings.json

4）写入 GPT-5.5 配置

在 settings.json 中写入以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换成你自己的APIKey",
    "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
    "ANTHROPIC_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.5",
    "ANTHROPIC_CUSTOM_MODEL_OPTION": "gpt-5.5",
    "ANTHROPIC_CUSTOM_MODEL_OPTION_NAME": "GPT-5.5"
  }
}

把下面这一行：

替换成你自己的APIKey

替换为你在 QuickRouter 控制台获取的 API Key。

5）启动 Claude Code

进入你的项目目录：

cd 你的项目目录
claude

启动后可以输入：

/status

用于检查当前配置是否生效。

6）临时指定 GPT-5.5 启动

也可以在启动时直接指定模型：

claude --model gpt-5.5

进入 Claude Code 后，也可以尝试使用：

/model gpt-5.5

如果模型名无法识别，请检查 QuickRouter 控制台中的实际模型 ID。

七、macOS 安装与配置 💻

1）安装 Node.js

如果你使用 Homebrew，可以执行：

brew install node

验证安装：

node --version
npm --version

2）安装 Claude Code CLI

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

检查安装结果：

claude --version

3）创建配置文件

macOS 下配置文件路径通常是：

~/.claude/settings.json

执行：

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

写入：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换成你自己的APIKey",
    "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
    "ANTHROPIC_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.5",
    "ANTHROPIC_CUSTOM_MODEL_OPTION": "gpt-5.5",
    "ANTHROPIC_CUSTOM_MODEL_OPTION_NAME": "GPT-5.5"
  }
}

保存后退出。

4）启动 Claude Code

cd 你的项目目录
claude

也可以直接指定模型启动：

claude --model gpt-5.5

八、Linux 安装与配置 🐯

下面以 Ubuntu / Debian 系统为例。

1）安装 Node.js

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 CLI

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

检查是否安装成功：

claude --version

3）创建配置文件

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

写入下面内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换成你自己的APIKey",
    "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
    "ANTHROPIC_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.5",
    "ANTHROPIC_CUSTOM_MODEL_OPTION": "gpt-5.5",
    "ANTHROPIC_CUSTOM_MODEL_OPTION_NAME": "GPT-5.5"
  }
}

4）启动 Claude Code

cd 你的项目目录
claude

或者：

claude --model gpt-5.5

九、Windows 一键配置脚本 🏡

如果不想手动创建配置文件，可以使用下面的 .bat 脚本。

使用方法

新建一个文本文件
复制下面代码
保存为：

QuickRouter-GPT55.bat

双击运行
输入你的 QuickRouter API Key

脚本内容

@echo off
chcp 65001 >nul
setlocal enabledelayedexpansion

echo ========================================
echo Claude Code - QuickRouter GPT-5.5 一键配置工具
echo ========================================
echo.

set "CLAUDE_PATH=%USERPROFILE%\.claude"

if not exist "%CLAUDE_PATH%" (
    mkdir "%CLAUDE_PATH%"
    echo [√] 已自动创建文件夹: %CLAUDE_PATH%
) else (
    echo [*] 文件夹已存在: %CLAUDE_PATH%
)

echo.
set /p API_KEY="请输入 QuickRouter API Key，一般以 sk- 开头: "

(
echo {
echo   "env": {
echo     "ANTHROPIC_AUTH_TOKEN": "%API_KEY%",
echo     "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
echo     "ANTHROPIC_MODEL": "gpt-5.5",
echo     "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.5",
echo     "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.5",
echo     "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.5",
echo     "ANTHROPIC_CUSTOM_MODEL_OPTION": "gpt-5.5",
echo     "ANTHROPIC_CUSTOM_MODEL_OPTION_NAME": "GPT-5.5"
echo   }
echo }
) > "%CLAUDE_PATH%\settings.json"

echo.
echo [√] 配置文件写入完成: %CLAUDE_PATH%\settings.json
echo.
echo 配置成功。请打开新的命令行窗口，进入项目目录后输入 claude 启动。
echo.
echo 也可以使用以下命令指定模型：
echo claude --model gpt-5.5
echo ========================================
echo.
pause

十、macOS / Linux 一键配置脚本 💻

如果你使用 macOS 或 Linux，可以使用下面的 .sh 脚本自动写入配置。

使用方法

新建文件：

nano quickrouter-gpt55.sh

粘贴下面脚本
保存后执行：

bash quickrouter-gpt55.sh

脚本内容

#!/bin/bash

echo "========================================"
echo " Claude Code - QuickRouter GPT-5.5 一键配置工具"
echo "========================================"
echo ""

CLAUDE_PATH="$HOME/.claude"

if [ ! -d "$CLAUDE_PATH" ]; then
    mkdir -p "$CLAUDE_PATH"
    echo "[√] 已自动创建文件夹: $CLAUDE_PATH"
else
    echo "[*] 文件夹已存在: $CLAUDE_PATH"
fi

echo ""
read -p "请输入 QuickRouter API Key，一般以 sk- 开头: " API_KEY

cat > "$CLAUDE_PATH/settings.json" << EOF
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "$API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
    "ANTHROPIC_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.5",
    "ANTHROPIC_CUSTOM_MODEL_OPTION": "gpt-5.5",
    "ANTHROPIC_CUSTOM_MODEL_OPTION_NAME": "GPT-5.5"
  }
}
EOF

echo ""
echo "[√] 配置文件已写入完成: $CLAUDE_PATH/settings.json"
echo ""
echo "配置成功。现在可以进入项目目录后输入 claude 启动。"
echo ""
echo "也可以使用以下命令指定模型："
echo "claude --model gpt-5.5"
echo "========================================"

十一、如何确认 GPT-5.5 是否生效

启动 Claude Code：

claude

进入后可以执行：

/status

也可以直接指定模型启动：

claude --model gpt-5.5

或者在 Claude Code 会话中切换：

/model gpt-5.5

如果启动时报模型不存在、模型不可用或请求失败，请优先检查 QuickRouter 控制台里的模型 ID 是否就是 gpt-5.5。

十二、常见问题

1）输入 `claude` 后提示找不到命令

可能原因：

Node.js 没安装成功
npm 全局安装路径没有加入环境变量
Claude Code CLI 没安装成功
当前终端没有刷新环境变量

处理方法：

node --version
npm --version
claude --version

如果 claude --version 不存在，可以重新安装：

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

Windows 用户安装后建议重新打开 PowerShell 或 CMD。

2）提示 API Key 无效

优先检查：

API Key 是否完整复制
API Key 前后是否有空格
是否误删了 sk- 开头部分
QuickRouter 控制台中 Key 是否仍然有效
账户是否还有可用额度

如果怀疑 Key 泄露，建议删除旧 Key，重新创建一个。

3）提示请求失败或连接失败

可以检查：

ANTHROPIC_BASE_URL 是否写错
是否写成了错误域名
是否多加了不必要路径
本地网络是否能访问 QuickRouter API
终端代理环境变量是否影响请求

本文推荐填写：

https://api.quickrouter.ai

4）模型切换后无效

可能原因：

模型名不是 gpt-5.5
QuickRouter 控制台实际模型 ID 不同
当前账号没有该模型权限
Claude Code 会话仍沿用旧配置
项目级 .claude/settings.json 覆盖了用户级配置

建议处理：

退出当前 Claude Code
检查 ~/.claude/settings.json
检查项目目录下是否有 .claude/settings.json
重新启动：

claude --model gpt-5.5

5）Windows 脚本乱码

如果 .bat 运行时乱码，确认脚本开头包含：

chcp 65001 >nul

如果仍然乱码，可以用 VS Code 或记事本另存为 UTF-8 编码。

6）JSON 配置报错

settings.json 必须是合法 JSON。常见错误包括：

少了逗号
多了逗号
使用了中文引号
字符串没有双引号
括号不完整

正确示例：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
    "ANTHROPIC_MODEL": "gpt-5.5"
  }
}

十三、最小可用流程

如果你只想快速跑通，可以按下面步骤执行：

注册 QuickRouter API
获取 API Key
安装 Node.js
安装 Claude Code CLI

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

创建配置文件：

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

写入：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换成你自己的APIKey",
    "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
    "ANTHROPIC_MODEL": "gpt-5.5"
  }
}

claude --model gpt-5.5

十四、使用建议

为了让 Claude Code 更好地完成开发任务，建议这样使用：

1）在项目根目录启动

cd 你的项目目录
claude

不要在无关目录启动，否则它无法正确读取项目结构。

2）先让它分析项目

可以先输入：

请先阅读当前项目结构，分析技术栈、主要目录和启动方式，不要修改文件。

这样可以降低误改文件的概率。

3）修改前先让它说明方案

可以输入：

先不要改代码，先告诉我你准备修改哪些文件，以及为什么这样改。

确认方案后再让它执行修改。

4）让它输出可回滚说明

例如：

修改完成后，请告诉我改了哪些文件，每个文件改了什么，以及如何回滚。

这样更适合线上项目维护。

十五、结语

Claude Code 的核心价值不只是聊天，而是直接进入开发环境，结合项目文件完成分析、修改和排查。通过 QuickRouter API 接入 GPT-5.5 模型后，可以在国内环境下更方便地使用 Claude Code 处理真实开发任务。

只要完成下面三件事，就可以跑通基础流程：

安装 Claude Code CLI
写入 QuickRouter API Key 和 Base URL
指定 GPT-5.5 模型

后续可以继续扩展：

项目级配置
团队统一配置模板
多模型路由
VS Code 组合使用
远程服务器开发
Nginx / Docker / PM2 部署排查
自动化代码审查流程

一、教程说明 🚀

二、Claude Code 适合做什么 🌏

三、为什么用 GPT-5.5 模型

四、准备 QuickRouter API Key 🔑

1）注册 QuickRouter API

2）获取 API Key

五、核心配置信息

六、Windows 安装与配置 🏡

1）安装 Node.js

2）安装 Claude Code CLI

3）创建 Claude Code 配置目录

4）写入 GPT-5.5 配置

5）启动 Claude Code

6）临时指定 GPT-5.5 启动

七、macOS 安装与配置 💻

1）安装 Node.js

2）安装 Claude Code CLI

3）创建配置文件

4）启动 Claude Code

八、Linux 安装与配置 🐯

1）安装 Node.js

2）安装 Claude Code CLI

3）创建配置文件

4）启动 Claude Code

九、Windows 一键配置脚本 🏡

使用方法

脚本内容

十、macOS / Linux 一键配置脚本 💻

使用方法

脚本内容

十一、如何确认 GPT-5.5 是否生效

十二、常见问题

1）输入 claude 后提示找不到命令

2）提示 API Key 无效

3）提示请求失败或连接失败

4）模型切换后无效

5）Windows 脚本乱码

6）JSON 配置报错

十三、最小可用流程

十四、使用建议

1）在项目根目录启动

2）先让它分析项目

3）修改前先让它说明方案

4）让它输出可回滚说明

十五、结语

1）输入 `claude` 后提示找不到命令