Claude Code — Windows 安装配置

本指南帮助你在 Windows 上安装并配置 Claude Code，接入 TinyPx API 服务。

前置要求

• Windows 10 或更高版本
• Node.js 18.0 或更高版本
• npm 包管理器

步骤 1：安装 Node.js

方法一：官方安装包（推荐）

1. 访问 nodejs.org
2. 下载 LTS 版本的 Windows Installer（.msi）
3. 运行安装程序，按默认设置完成安装
4. 安装程序会自动写入 PATH 环境变量

方法二：包管理器

# Winget（Windows 11 或 Windows 10 自带）
winget install OpenJS.NodeJS.LTS

# Chocolatey
choco install nodejs-lts

# Scoop
scoop install nodejs-lts

验证安装

打开命令提示符或 PowerShell：

node --version
npm --version

步骤 2：安装 Claude Code CLI

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

验证安装：

claude --version

权限问题

如果安装报权限错误，请以管理员身份运行命令提示符或 PowerShell。

步骤 3：配置 API 端点

创建配置目录：

mkdir $env:USERPROFILE\.claude
cd $env:USERPROFILE\.claude

创建或编辑 settings.json：

{
  "env": {
    "ANTHROPIC_API_KEY": "粘贴为 Claude Code 专用分组令牌 key",
    "ANTHROPIC_BASE_URL": "https://ai.tinypx.cn"
  }
}

注意端点格式

Claude Code 不带 /v1 后缀 —— 使用 https://ai.tinypx.cn， 而不是 https://ai.tinypx.cn/v1。详见 API 端点说明。

可选：指定默认模型

{
  "env": {
    "ANTHROPIC_API_KEY": "粘贴为 Claude Code 专用分组令牌 key",
    "ANTHROPIC_BASE_URL": "https://ai.tinypx.cn"
  },
  "model": "填写该 Claude Code 分组支持的模型名"
}

具体可用模型请到 模型广场 查阅对应分组支持的 model。

步骤 4：设置 API 密钥

方法 1：环境变量（推荐）

# 临时设置（当前会话有效）
$env:ANTHROPIC_API_KEY = "你的 TinyPx API 令牌"

# 永久设置（写入用户环境变量）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的 TinyPx API 令牌", "User")

方法 2：写进配置文件

{
  "env": {
    "ANTHROPIC_API_KEY": "你的 TinyPx API 令牌",
    "ANTHROPIC_BASE_URL": "https://ai.tinypx.cn"
  },
  "model": "填写该 Claude Code 分组支持的模型名"
}

安全提示

请妥善保管 API 密钥，不要提交到 Git 等版本控制系统。

步骤 5：验证配置

claude "你好，请介绍一下你自己"

配置正确的话，Claude 会正常响应。

VSCode 集成（可选）

1. 打开 VSCode
2. 按 Ctrl+Shift+X 打开扩展面板
3. 搜索 "Claude Code"
4. 点击安装

安装扩展后继续使用前面的 ~/.claude/settings.json 即可，不需要单独填写 claude.apiBaseUrl 或 claude.apiKey。

常用命令

# 启动交互式会话
claude

# 非交互式输出
claude --print "请审查 src/ 目录并列出主要问题"

# 查看帮助
claude --help

故障排除

命令未找到

确认 npm 全局安装路径在系统 PATH 中：

npm config get prefix

添加到 PATH：

$npmPath = npm config get prefix
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$npmPath", "User")

API 连接失败

1. 检查网络连接
2. 验证 API 密钥：echo $env:ANTHROPIC_API_KEY
3. 确认端点是 https://ai.tinypx.cn（不带 /v1）

权限错误

右键点击 PowerShell 图标，选择「以管理员身份运行」。

PowerShell 执行策略错误

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

下一步

• macOS 安装指南
• Linux 安装指南
• Codex 配置
• 常见问题

获取 API 密钥

访问 TinyPx API 控制台 获取你的 API 令牌。