ClaudeCode Windows 安装指南

前置要求

• Windows 10 或更高版本
• Node.js 环境（版本 18 或更高）
• 有效的 UniVibe API 密钥

注册UniVibe API 密钥 点击注册

安装步骤

1. 安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。

方法一：官网下载（推荐）

1. 打开浏览器访问 https://nodejs.org/
2. 点击 "LTS" 版本进行下载（推荐长期支持版本）
3. 下载完成后双击 .msi 文件
4. 按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

验证 Node.js 安装

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

node --version
npm --version

如果显示版本号，说明安装成功了！

Windows 注意事项：

• 建议使用 PowerShell 而不是 CMD
• 如果遇到权限问题，尝试以管理员身份运行
• 某些杀毒软件可能会误报，需要添加白名单

2. 安装 Claude Code

打开 PowerShell 或 CMD，运行以下命令：

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

提示：

• 建议使用 PowerShell 而不是 CMD，功能更强大
• 如果遇到权限问题，以管理员身份运行 PowerShell

3. 获取 API 密钥

登录 UniVibe 控制台，在 API密钥 页面创建一个新的密钥。

4. 设置环境变量

为了让 Claude Code 连接到 UniVibe 服务，需要设置两个环境变量：

方法一：PowerShell 临时设置（当前会话）

在 PowerShell 中运行以下命令：

$env:ANTHROPIC_BASE_URL = "https://api.univibe.cc/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

💡 记得将 你的API密钥 替换为在上方 API Keys 标签页中创建的实际密钥。

方法二：PowerShell 永久设置（用户级）

在 PowerShell 中运行以下命令设置用户级环境变量：

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.univibe.cc/anthropic", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)

查看已设置的环境变量：

# 查看用户级环境变量
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", [System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", [System.EnvironmentVariableTarget]::User)

💡 设置后需要重新打开 PowerShell 窗口才能生效。

方法三：系统环境变量设置（图形界面）

1. 打开 系统属性 → 高级 → 环境变量

2. 在 用户变量 中点击 新建，添加以下变量：

   • 变量名：ANTHROPIC_AUTH_TOKEN，变量值：你的 UniVibe API 密钥
   • 变量名：ANTHROPIC_BASE_URL，变量值：https://api.univibe.cc/anthropic

3. 点击 确定 保存

4. 重新打开 PowerShell 或 CMD 使配置生效

验证环境变量设置

设置完环境变量后，可以通过以下命令验证是否设置成功：

在 PowerShell 中验证：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

在 CMD 中验证：

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%

预期输出示例：

https://api.univibe.cc/anthropic
cr_xxxxxxxxxxxxxxxxxx

💡 如果输出为空或显示变量名本身，说明环境变量设置失败，请重新设置。

5. 开始使用 Claude Code

现在你可以开始使用 Claude Code 了！

启动 Claude Code

claude

在特定项目中使用

# 进入你的项目目录
cd C:\path\to\your\project

# 启动 Claude Code
claude

6. 在 Claude Code CLI 中使用 Codex 模型 🚀

全球首家！UniVibe 率先在 Claude Code CLI 命令行工具中适配 Codex 推理模型

通过路由层协议兼容技术，您现在可以直接在 Claude Code CLI 中使用 OpenAI 的 Codex 推理模型，实现强强联合：

• Claude Code CLI：强大的 Agent 和工具调用能力
• Codex 模型：顶级的编程推理和代码生成能力

简单来说，您可以在 Claude Code 命令行中使用 Codex 的强大推理能力来完成更复杂的编程任务。

模型命名规则

Codex 模型的命名格式为：[模型名]-[推理预算]，例如：gpt-5.1-codex-high

切换模型命令

在 Claude Code 中，使用 /model 命令切换模型：

/model gpt-5.1-high

可用的模型列表

GPT-5.1 系列（最新）：

模型名称	推理预算	适用场景
gpt-5.1-high	高	复杂算法设计、架构规划、疑难问题解决
gpt-5.1-medium	中等	常规开发任务、代码重构
gpt-5.1-low	低	简单代码编写、快速问答

GPT-5.1 Codex 系列（专为编程优化）：

模型名称	推理预算	适用场景
gpt-5.1-codex-high	高	复杂编程任务、算法优化
gpt-5.1-codex-medium	中等	日常编程开发、代码审查
gpt-5.1-codex-low	低	快速编程辅助、代码片段生成

GPT-5.1 Codex Mini 系列（轻量级编程模型）：

模型名称	推理预算	适用场景
gpt-5.1-codex-mini-high	高	代码生成、快速开发
gpt-5.1-codex-mini-medium	中等	代码补全、简单编程任务

GPT-5 系列：

模型名称	推理预算	适用场景
gpt-5-high	高	复杂算法设计、架构规划、疑难问题解决
gpt-5-medium	中等	常规开发任务、代码重构
gpt-5-low	低	简单代码编写、快速问答
gpt-5-minimal	最低	代码补全、简单修改（最快速度）

GPT-5 Codex 系列（专为编程优化）：

模型名称	推理预算	适用场景
gpt-5-codex-high	高	复杂编程任务、算法优化
gpt-5-codex-medium	中等	日常编程开发、代码审查
gpt-5-codex-low	低	快速编程辅助、代码片段生成

💡 提示：  推理预算越高，模型的推理能力越强，但响应速度会相对较慢。根据实际需求选择合适的模型。

7. 在 Claude Code CLI 中使用 Gemini 模型 🚀

UniVibe 已上线：Claude Code 里原生使用 Gemini 模型

现在，您可以直接通过 UniVibe 在 Claude Code 里原生使用：Claude 系列、Codex 系列、Gemini 系列模型——三家目前世界最顶尖的模型。

切换模型命令

在 Claude Code 中，使用 /model 命令切换到 Gemini 模型：

/model gemini-3-pro-preview

可用的 Gemini 模型列表

模型名称	特点	适用场景
gemini-3-pro-preview	顶级性能，前端开发神器	复杂前端开发、架构设计、高质量代码生成
gemini-3-flash-preview	Pro 四分之一成本，上一代 Pro 级能力	日常开发任务、快速迭代、性价比首选

💡 提示：  Gemini-3-Flash 以仅 Pro 四分之一的成本，提供上一代 Pro 级别的能力，非常适合日常开发使用。

Windows 常见问题解决

安装时提示 "permission denied" 错误

这通常是权限问题，尝试以下解决方法：

• 以管理员身份运行 PowerShell
• 或者配置 npm 使用用户目录：npm config set prefix %APPDATA%\npm

PowerShell 执行策略错误

如果遇到执行策略限制，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

环境变量设置后不生效

设置永久环境变量后需要：

• 重新启动 PowerShell 或 CMD
• 或者注销并重新登录 Windows
• 验证设置：echo $env:ANTHROPIC_BASE_URL

防火墙问题

确保防火墙允许 ClaudeCode 访问网络。