Windows 11 部署 Claude Code 教程（MiniMax CodingPlan 模型）

本教程详细介绍如何在 Windows 11 系统上部署 Claude Code，并配置使用 MiniMax 的 CodingPlan 模型。

📋 目录

前置要求
安装 Node.js
安装 Claude Code
配置 MiniMax 模型
使用指南
常见问题
使用技巧

前置要求

系统要求

操作系统: Windows 11 (64 位)
内存: 至少 8GB RAM (推荐 16GB+)
磁盘空间: 至少 5GB 可用空间
网络: 稳定的互联网连接

软件要求

Node.js: v18.0 或更高版本 (推荐 v20 LTS)
npm: 随 Node.js 一起安装
Git: (可选，用于版本控制)

API 密钥

MiniMax API Key: 需要前往 MiniMax 开放平台申请
- 官网：https://www.minimaxi.com/
- 进入控制台创建 API Key
- 确保账户有足够的额度

安装 Node.js

步骤 1: 下载 Node.js

访问 Node.js 官网：https://nodejs.org/
下载 LTS 版本 (推荐 v20.x)
选择 Windows Installer (.msi)

步骤 2: 安装

双击下载的 .msi 文件
按照安装向导完成安装
建议勾选 "Automatically install the necessary tools" 选项

步骤 3: 验证安装

打开 命令提示符 (CMD) 或 PowerShell，执行：

node --version
npm --version

应输出类似：

v20.11.0
10.2.4

安装 Claude Code

步骤 1: 全局安装

以管理员身份打开 PowerShell 或 CMD，执行：

npm install -g @anthropic/claude-code

注意: 如果遇到权限错误，可以尝试：

npm install -g @anthropic/claude-code --prefix %APPDATA%\npm

步骤 2: 验证安装

claude --version

步骤 3: 初始化配置

首次运行会自动创建配置文件：

claude

首次启动会提示进行配置，按向导完成即可。

配置 MiniMax 模型

步骤 1: 获取 MiniMax API Key

访问 MiniMax 开放平台：https://platform.minimaxi.com/
登录/注册账户
进入「控制台」→「API Key 管理」
创建新的 API Key
复制并安全保存 API Key（只显示一次）

步骤 2: 配置 Claude Code 使用 MiniMax

Claude Code 支持通过 MCP (Model Context Protocol) 或自定义端点接入第三方模型。

方法 A: 使用环境变量配置（推荐）

打开 系统环境变量 设置
- 右键「此电脑」→「属性」→「高级系统设置」
- 点击「环境变量」
添加以下用户变量：

变量名	变量值
`MINIMAX_API_KEY`	你的 MiniMax API Key
`MINIMAX_MODEL`	`abab6.5s-chat` 或 `CodingPlan`

点击「确定」保存

方法 B: 修改 Claude Code 配置文件

找到 Claude Code 配置目录（通常在 %USERPROFILE%\.claude\），编辑或创建 config.json：

{
  "model": {
    "provider": "minimax",
    "apiKey": "你的 MiniMax API Key",
    "modelName": "abab6.5s-chat",
    "endpoint": "https://api.minimaxi.com/v1/chat/completions"
  },
  "codingPlan": {
    "enabled": true,
    "model": "abab6.5s-chat"
  }
}

方法 C: 使用 MCP Server 配置

创建 %USERPROFILE%\.claude\mcp.json：

{
  "mcpServers": {
    "minimax": {
      "command": "npx",
      "args": ["-y", "minimax-mcp-server"],
      "env": {
        "MINIMAX_API_KEY": "你的 MiniMax API Key"
      }
    }
  }
}

步骤 3: 验证配置

运行以下命令测试连接：

claude --model minimax --message "Hello, test connection"

使用指南

基础命令

启动交互式会话

claude

执行单次任务

claude --message "帮我分析这个项目的代码结构"

指定模型

claude --model abab6.5s-chat --message "优化这段代码"

常用功能

1. 代码生成

claude --message "用 Python 写一个快速排序算法，包含详细注释"

2. 代码审查

claude --message "审查这个文件的安全问题" --file ./src/main.py

3. 项目分析

claude --message "分析这个项目的架构和依赖"

4. 自动修复

claude --message "修复这个文件中的 bug" --file ./src/app.js

CodingPlan 模式

CodingPlan 是 MiniMax 针对代码任务优化的模式，适合：

大型代码生成任务
多文件项目重构
复杂算法实现

启用方式：

claude --coding-plan --message "帮我设计一个完整的电商网站后端架构"

常见问题

Q1: 安装时提示权限错误

解决方案:

# 方法 1: 使用管理员权限运行 CMD/PowerShell
# 右键 → 以管理员身份运行

# 方法 2: 更改 npm 全局安装目录
npm config set prefix "%APPDATA%\npm"
npm install -g @anthropic/claude-code

Q2: 无法连接 MiniMax API

检查清单:

确认 API Key 正确且未过期
检查网络连接
确认账户有足够额度
检查防火墙设置

测试连接:

curl -X POST https://api.minimaxi.com/v1/chat/completions \
  -H "Authorization: Bearer 你的 API Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"abab6.5s-chat","messages":[{"role":"user","content":"test"}]}'

Q3: 响应速度慢

优化建议:

使用 CodingPlan 模式处理大任务
将大任务拆分为多个小请求
检查网络延迟
考虑使用国内 CDN 加速

Q4: 中文输出乱码

解决方案:

# 设置终端编码为 UTF-8
chcp 65001

# 或在 PowerShell 中
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8

Q5: 模型返回不符合预期

调整建议:

优化提示词，更明确地描述需求
提供示例代码作为参考
使用系统提示设定角色和风格
调整 temperature 参数（0-1，越低越确定）

使用技巧

🎯 提示词优化技巧

1. 明确上下文

❌ "写个函数"
✅ "用 Python 写一个处理 CSV 文件的函数，需要支持大文件流式读取，内存占用不超过 100MB"

2. 提供示例

"按照以下格式生成 API 响应：
{
  "code": 200,
  "data": {...},
  "message": "success"
}"

3. 分步请求

复杂任务拆分为多轮对话：

第一轮："设计一个用户认证系统的数据库结构"
第二轮："基于上面的数据库，写登录 API"
第三轮："添加 JWT token 刷新机制"

⚡ 效率提升技巧

1. 使用项目上下文

# 让 Claude Code 读取整个项目
claude --message "重构这个项目的错误处理机制" --project ./

2. 批量处理

# 一次性处理多个文件
claude --message "为所有文件添加类型注解" --file ./src/*.py

3. 保存常用提示

创建提示模板文件 prompts.md：

## 代码审查模板
请审查以下代码：
- 安全问题
- 性能问题
- 代码风格
- 潜在 bug

## 重构模板
请重构以下代码以：
- 提高可读性
- 减少重复
- 优化性能

🔒 安全最佳实践

不要提交 API Key 到版本控制

# 添加到 .gitignore
echo "*.key" >> .gitignore
echo ".env" >> .gitignore

使用环境变量存储敏感信息

# 创建 .env 文件
MINIMAX_API_KEY=your_key_here

定期轮换 API Key
审查 AI 生成的代码
- 特别是涉及安全、认证、加密的代码
- 不要盲目信任 AI 输出

📊 成本优化

使用合适的模型
- 简单任务：使用轻量模型
- 复杂任务：使用 CodingPlan

控制输出长度

claude --max-tokens 1000 --message "简要说明..."

批量请求
- 合并多个小请求为一个大请求
- 减少 API 调用次数

附录

A. 推荐工具

工具	用途	链接
Windows Terminal	现代化终端	Microsoft Store
VS Code	代码编辑器	https://code.visualstudio.com/
Git for Windows	版本控制	https://git-scm.com/
Node Version Manager	Node 版本管理	https://github.com/nvm-sh/nvm

B. 参考文档

C. 社区资源

更新日志

版本	日期	更新内容
1.0	2026-03-31	初始版本

祝你使用愉快！🚀

如有问题，欢迎查阅本文档或联系技术支持。

分享