Windows 系统部署 Claude Code 完整教程 (MTUAPI 版本)

1 系统要求与前期准备

在开始安装 Claude Code 之前，请确保您的 Windows 系统满足以下基本要求：

操作系统：Windows 10（2004 及以上版本，Build 19041+）或 Windows 11（推荐）

内存：建议 8GB 或以上

权限：管理员权限

网络：稳定的互联网连接

1.1 安装 Node.js

Claude Code 基于 Node.js 开发，因此需要先安装 Node.js 环境：

访问 https://nodejs.org/ 下载 LTS 版本（推荐 v18.0 或更高版本）

运行安装程序，按照向导完成安装。重要提示：确保勾选 "Add to PATH" 选项

安装完成后，打开命令提示符（CMD）或 PowerShell，执行以下命令验证安装：

如果正确显示版本号（例如 v22.19.0 和 10.9.3），说明安装成功。

此处应配有命令行显示 node -v 和 npm -v 返回结果的截图

1.2 安装 Git

Claude Code 需要 Git 支持某些功能：

访问 https://git-scm.com/download/win 下载 Windows 版 Git

或使用 winget 命令安装（Windows 11 推荐）：

winget install --id Git.Git -e --source winget

验证 Git 安装：

2 安装 Claude Code

2.1 通过 npm 安装

推荐使用 npm（Node.js 包管理器）进行全局安装：

以管理员身份打开命令提示符（CMD）或 PowerShell

执行安装命令：

为加速下载，可使用国内镜像源：

此处应配有npm安装过程的截图，显示下载和安装进度

2.2 验证安装

安装完成后，验证是否成功：

如果显示版本号（例如 1.0.113 (Claude Code)），说明安装成功。

此处应配有claude -v命令成功返回版本号的截图

常见问题：如果出现权限错误，请执行：

Set-ExecutionPolicy RemoteSigned

然后重新启动命令行工具。

3 配置 API 密钥

3.1 获取 MTUAPI 密钥

访问 https://mtuo.ai 注册账号

完成实名认证（如需要）

在用户中心找到 API 密钥管理页面

创建新密钥并复制保存

3.2 设置环境变量

设置系统环境变量使 Claude Code 能识别您的 API 密钥：

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

在"用户变量"或"系统变量"中点击"新建"

添加以下变量：

变量名	变量值示例	说明
ANTHROPIC_BASE_URL	https://mtuo.ai/v1/chat/completions	MTUAPI 服务地址
ANTHROPIC_API_KEY	您的MTUAPI密钥	从MTUAPI获取的API密钥
ANTHROPIC_AUTH_TOKEN	您的MTUAPI密钥	同API_KEY

或者使用命令行设置（需要重启终端生效）：

setx ANTHROPIC_BASE_URL "https://mtuo.ai/v1"
setx ANTHROPIC_API_KEY "您的MTUAPI密钥"
setx ANTHROPIC_AUTH_TOKEN "您的MTUAPI密钥"

4 运行与基本使用

4.1 启动 Claude Code

打开命令提示符或 PowerShell

导航到您的项目目录：

启动 Claude Code：

4.2 初次运行设置

首次启动时会遇到以下交互步骤：

安全提示：显示安全声明，按 Enter 继续

风格选择：选择终端配色方案（Dark/Light）

确认提示：选择 "Yes, proceed" 继续

Claude Code首次启动时的交互界面截图

4.3 基本测试

启动成功后，输入简单指令测试：

你好，请介绍一下你自己

如果看到回复，说明配置成功。

4.4 常用命令

Claude Code 提供了一些实用命令：

命令	功能	示例
/init	初始化项目，分析技术栈并写入CLAUDE.md	/init
/compact	压缩聊天上下文，减少token消耗	/compact
/clear	清除聊天上下文，开始新对话	/clear
/model	切换不同模型	/model claude-3-opus-20240229
Alt+M	切换任务模式	按快捷键切换模式

Claude Code 有三种任务模式：

默认模式：代码改动需要手动确认

accept edits模式：自动接受所有操作

plan mode模式：只提出想法和计划，不修改代码

5 高级配置与故障排除

5.1 自定义配置文件

创建或编辑 ~/.claude/config.json 文件：

{
  "api_base_url": "https://mtuo.ai/v1/chat/completions",
  "api_key": "sk-FastAPI1va****",
  "models": ["gpt-4.1", "gpt-4o", "gpt-5"]
    }
  ],
  "Router": {
    "default": "mtuo-ai,gpt-4.1"
  }
}

5.2 常见问题与解决方案

端口冲突：Claude Code 默认使用 3456 端口，如果冲突可修改配置文件更改端口

权限错误：以管理员身份运行命令行工具

429请求频率错误：MTUAPI可能有频率限制，可联系平台支持或升级套餐

API连接错误：检查环境变量设置是否正确，特别是API基础地址

5.3 在VS Code中使用

在VS Code扩展市场中搜索"Claude Code for VSCode"并安装

确保VS Code打开的项目目录与Claude Code启动目录相同

即可在IDE中享受Claude Code的辅助编程功能

总结

通过本教程，您已经成功在Windows系统上部署了Claude Code，并配置了MTUAPI作为API中转服务。现在您可以享受AI辅助编程的便利，无论是代码生成、调试还是重构，Claude Code都能提供强大支持。

重要提示：始终审查Claude生成的代码，特别是在运行关键任务代码前，因为它有时可能犯错误。

如果您在安装过程中遇到任何问题，可以查阅 https://doc.mtuo.ai/ 或相关社区获取更多帮助。

Claude code 部署教程接入MTUAPI

Windows 系统部署 Claude Code 完整教程 (MTUAPI 版本)#

1 系统要求与前期准备#

1.1 安装 Node.js#

1.2 安装 Git#

2 安装 Claude Code#

2.1 通过 npm 安装#

2.2 验证安装#

3 配置 API 密钥#

3.1 获取 MTUAPI 密钥#

3.2 设置环境变量#

4 运行与基本使用#

4.1 启动 Claude Code#

4.2 初次运行设置#

4.3 基本测试#

4.4 常用命令#

5 高级配置与故障排除#

5.1 自定义配置文件#

5.2 常见问题与解决方案#

5.3 在VS Code中使用#

总结#