admin 管理员组

文章数量: 1184232

ClaudeCode Windows 安装指南

前置要求
Windows 10 或更高版本
Node.js 环境(版本 18 或更高)
有效的 UniVibe API 密钥(注册送6000积分,https://www.univibe/console/auth?type=register&invite=MB8LFU 够几天使用了)
安装步骤

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

方法一:官网下载(推荐)
打开浏览器访问 https://nodejs/
点击 “LTS” 版本进行下载(推荐长期支持版本)
下载完成后双击 .msi 文件
按照安装向导完成安装,保持默认设置即可
方法二:使用包管理器
如果你安装了 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密钥 页面创建一个新的密钥。

  1. 设置环境变量
    为了让 Claude Code 连接到 UniVibe 服务,需要设置两个环境变量:

方法一:PowerShell 临时设置(当前会话)
在 PowerShell 中运行以下命令:

$env:ANTHROPIC_BASE_URL = “https://api.univibe/anthropic”
$env:ANTHROPIC_AUTH_TOKEN = “你的API密钥”
💡 记得将 你的API密钥 替换为在上方 API Keys 标签页中创建的实际密钥。

方法二:PowerShell 永久设置(用户级)
在 PowerShell 中运行以下命令设置用户级环境变量:

设置用户级环境变量(永久生效)

[System.Environment]::SetEnvironmentVariable(“ANTHROPIC_BASE_URL”, “https://api.univibe/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 窗口才能生效。

方法三:系统环境变量设置(图形界面)
打开 系统属性 → 高级 → 环境变量
在 用户变量 中点击 新建,添加以下变量:
变量名:ANTHROPIC_AUTH_TOKEN,变量值:你的 UniVibe API 密钥
变量名:ANTHROPIC_BASE_URL,变量值:https://api.univibe/anthropic
点击 确定 保存
重新打开 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/anthropic
cr_xxxxxxxxxxxxxxxxxx
💡 如果输出为空或显示变量名本身,说明环境变量设置失败,请重新设置。

  1. 开始使用 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 低 快速编程辅助、代码片段生成
💡 提示: 推理预算越高,模型的推理能力越强,但响应速度会相对较慢。根据实际需求选择合适的模型。

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 访问网络。

本文标签: 三方 指南 教程 ClaudeCode Windows