Claude Code 安装使用教程
Claude Code 是 Anthropic 官方命令行工具，通过 QuickRouter API 接入 Claude 大模型。它直接在本地项目目录里工作：读代码、辅助排查问题、生成实现、解释逻辑，整体更贴近真实开发流程。
Anthropic 官方命令行工具，通过 QuickRouter API 接入 Claude 大模型。
Windows 安装 Claude Code（原生安装，无需 WSL）
Windows 用户可以直接使用 PowerShell 安装 Claude Code，无需安装 WSL / Ubuntu。安装前请先准备 Git for Windows。
安装 Git for Windows
如果 Git 官网下载较慢，可使用国内镜像下载，选择最新版本，下载 64-bit Git for Windows Setup 结尾的 .exe 安装包。安装时建议勾选 Add Git to PATH。
https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/以管理员身份打开 PowerShell
在开始菜单搜索 PowerShell，右键选择「以管理员身份运行」。如果你使用普通 PowerShell 已经可以正常安装，也可以使用普通 PowerShell。
安装 Claude Code
在 PowerShell 中运行官方 Claude Code 安装命令。
npm install -g @anthropic-ai/claude-code安装完成后，请关闭当前 PowerShell 窗口，并重新打开新的 PowerShell。
验证安装
claude --version如果能看到版本号，说明 Claude Code 安装成功。
进入项目目录并启动
cd D:\your-projectclaude- 选择喜欢的主题（回车）
- 确认安全须知（回车）
- 使用默认 Terminal 配置（回车）
- 信任工作目录（回车）
- 开始编程
配置 QuickRouter API
访问 QuickRouter API 控制台获取你的 API Key，然后在 PowerShell 中执行以下命令。
setx ANTHROPIC_BASE_URL "https://api.quickrouter.ai"
setx ANTHROPIC_AUTH_TOKEN "你的 QuickRouter API Key"设置完成后，关闭当前 PowerShell，重新打开新的 PowerShell，再进入项目目录运行 claude。
https://api.quickrouter.ai，不要加 /v1。
安装 Node.js
使用 Homebrew 安装 Node.js（如果尚未安装 Homebrew，请先安装）。
# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 通过 Homebrew 安装 Node.js
brew install node
# 验证安装
node --version安装 Claude Code
在终端中运行官方 Claude Code 安装命令。
npm install -g @anthropic-ai/claude-code
claude --version配置 QuickRouter API
访问 QuickRouter API 控制台，点击左侧菜单「令牌管理」-「添加令牌」。
- 令牌名称：随意填写，例如 Claude Code
- 过期时间：建议设为永不过期
- 额度设置：设为无限额度
- 分组：选择 Claude code 专属或者官转克劳德3及以上
- 其他选项：保持默认设置
然后在 .claude 目录下新建或修改 settings.json 配置文件，写入以下配置信息，推荐使用这种永久配置方式。
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
"ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
"API_TIMEOUT_MS": "300000"
}
}https://api.quickrouter.ai，不要加 /v1。
启动 Claude Code
配置完成后，先进入到你的项目文件夹中。
cd your-project-folder然后运行以下命令启动 Claude Code。
claude- 选择喜欢的主题（回车）
- 确认安全须知（回车）
- 使用默认 Terminal 配置（回车）
- 信任工作目录（回车）
- 开始编程
安装 Node.js
使用以下命令安装 Node.js LTS 版本（Ubuntu / Debian）。
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证安装
node --version安装 Claude Code
在终端中运行官方 Claude Code 安装命令。
npm install -g @anthropic-ai/claude-code
claude --version配置 QuickRouter API
访问 QuickRouter API 控制台，点击左侧菜单「令牌管理」-「添加令牌」。
- 令牌名称：随意填写，例如 Claude Code
- 过期时间：建议设为永不过期
- 额度设置：设为无限额度
- 分组：选择 Claude code 专属或者官转克劳德3及以上
- 其他选项：保持默认设置
然后在 .claude 目录下新建或修改 settings.json 配置文件，写入以下配置信息，推荐使用这种永久配置方式。
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
"ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
"API_TIMEOUT_MS": "300000"
}
}https://api.quickrouter.ai，不要加 /v1。
启动 Claude Code
配置完成后，先进入到你的项目文件夹中。
cd your-project-folder然后运行以下命令启动 Claude Code。
claude- 选择喜欢的主题（回车）
- 确认安全须知（回车）
- 使用默认 Terminal 配置（回车）
- 信任工作目录（回车）
- 开始编程
常见问题解答
Q: 遇到 "Invalid API Key · Please run /login" 错误？
A: 这表明 Claude Code 未检测到环境变量。请检查：
- 是否正确设置了
ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL - 环境变量值是否正确（令牌以
sk-开头） - 如果使用了永久配置，是否重启了终端
Q: 为什么显示 "offline" 状态？
A: Claude Code 通过连接 Google 来判断网络状态。显示 "offline" 不影响正常使用，只是表明无法连接到 Google。
Q: 请求总是显示 "fetch failed"？
A: 可能是网络环境导致的问题。解决方案：
- 退出 Claude Code（Ctrl+C）
- 重新运行
claude命令 - 如果问题持续，请稍后再试
Q: API 报错如何处理？
A: 可能是转发代理不稳定导致的，建议退出后重新启动。如果问题持续，请稍后再试或联系技术支持。