技能库 / 开发编程 / Claude Code 搭配 MiniMax-M2.5

全部分类开发编程创意写作商业办公教育学习效率工具数据分析技术集成通用语言翻译文档生成

Claude Code 搭配 MiniMax-M2.5

使用 MiniMax-M2.5 模型驱动 Claude Code 完成 AI 编程的完整配置与使用说明（中文教程向）。

v1.0.0 l1-m1ng

作者 / 来源

skillhub

在来源站打开

登录后收藏登录后加入合集

安装方式

CLI 安装（推荐）

claw install shub-claude-code-minimax

需要安装 CLAW CLI

手动下载安装

下载 ZIP 后解压到技能目录即可安装。若在桌面客户端 WebView中直接下载出现异常，本站会改为提示页 + 原始链接，请按页内说明操作。

下载 ZIP (shub-claude-code-minimax-v1.0.0.zip)

触发指令

/claude-code-minimax-m2

跨平台安装指引

该技能声明兼容以下 1 个平台，将 ZIP 解压到对应目录即可被识别。

支持矩阵

Claude Code Coding Agent

macOS / Linux：~/.claude/skills/

Windows：%USERPROFILE%\.claude\skills\

unzip shub-claude-code-minimax-v1.0.0.zip -d ~/.claude/skills/

目录不存在时请先 mkdir -p 创建；启用 Skill 后请重启对应 Agent 让配置生效。

使用指南

Claude Code 搭配 MiniMax-M2.5

围绕 Claude Code 搭配 MiniMax-M2.5：使用 MiniMax-M2.5 模型驱动 Claude Code 完成 AI 编程的完整配置与使用说明（中文教程向）。无需在每次任务前把零散英文说明手工拼进上下文，也减少与客户端默认行为脱节的试错；具体命令、钩子与 JSON 参数仍以 ZIP 包内 SKILL.md 为权威。下文结构与站内 MCP CLI 类专题稿相同：何时用、前置、流程、速查与故障。

何时使用

使用 MiniMax-M2.5 模型驱动 Claude Code 完成 AI 编程的完整配置与使用说明（中文教程向）
已获取本技能 ZIP，并准备在 Claude Code / OpenClaw 中按 SKILL.md 挂载。
希望用中文专题稿快速判断「该不该启用」，再深入英文 SKILL 查参数与边界。
需要与团队对齐同一套触发方式、目录约定或回调格式时。

前置条件

通用：可运行 Claude Code 或文档要求的客户端；有可读写的项目工作区（或 SKILL.md 指定的沙箱目录）。
权威细节：API Key / OAuth、钩子路径、环境变量以 ZIP 内 SKILL.md 为准。

典型流程

从 ClawHub / 站内分发获取技能 ZIP，校验版本与校验和（若提供）。
阅读 SKILL.md 的安装段落：目录落点、客户端类型（Claude Code / OpenClaw / 脚本）。
用文档中的最小示例完成第一次调用（单文件修改、单次查询或单次委派）。
确认工作目录、权限边界与输出路径后，再处理多文件或长耗时任务。
需要回调 / Webhook / 通知时，按 SKILL.md 配置端点并在测试环境先验通。

与 ZIP / SKILL.md 的关系

站内专题稿与 MCP CLI 类 oss 稿同样：概括何时用、怎么接、怎么排错；命令模板、钩子名、JSON 字段、版本矩阵一律以 ZIP 内 SKILL.md 与 ClawHub 上游为准。

命令示例（摘自包内 SKILL.md）

以下为从上游 SKILL.md（或入库正文）自动抽取的终端/脚本片段；路径、环境变量与参数以当前 ZIP 与官方说明为准。

ClawHub slug：claude-code-minimax（安装命令以 SKILL.md / claw CLI 为准）。

# macOS / Linux
brew tap farion1231/ccswitch
brew install --cask cc-switch

# Windows
# 前往 https://github.com/farion1231/cc-switch/releases 下载安装包

# 如果文件不存在则创建
touch ~/.claude/settings.json

# 如果文件不存在则创建
touch ~/.claude.json

# 进入项目目录
cd 你的项目文件夹

# 启动对话模式
claude

# 或直接指定任务（一次性执行）
claude "帮我写一个 Python 脚本"

# 1. 启动
$ cd myproject
$ claude

# 2. 首次信任目录
The current directory is /path/to/myproject. Type 'y' to allow Claude to read and edit files in this directory, or 'n' to exit.
→ y

# 3. 开始对话
Hello! How can I help you today?

# 4. 提出需求
> 帮我写一个 Python 脚本，批量重命名文件

# 5. Claude 会先展示计划
# 然后输入 y 确认执行
→ y

# 6. 查看结果
# 文件已创建完成

> 帮我写一个 Python 脚本，读取 CSV 文件并生成统计图表

> 这个代码运行报错：xxx，请帮我修复

> 请审查 src/app.py 的代码质量，并提出改进建议

> 请重构这个函数，使其更易读和高效

> 为 src/utils.py 编写单元测试

站内入库时的触发命令（完整语义见 ZIP）：

# 使用本技能时可在对话中引用或执行上述指令；完整参数与示例见下载包内 SKILL.md。
/claude-code-minimax-m2

最佳实践

先 SKILL.md 再猜参数；站内专题稿不替代 schema 与必填字段说明。
委派任务时写清验收标准（命令、文件路径、测试命令），减少来回追问。
长任务用文档推荐的回调 / 日志落盘代替高频轮询，省 Token 也省机器负载。
多技能同时启用时，注意钩子加载顺序与重复工具调用（以 SKILL.md 冲突说明为准）。

调试与排错

打开 stderr 与客户端日志；PTY/tmux 场景同时看面板最后几十行输出。
参数错误时对照 SKILL.md 中的 JSON/CLI 示例（引号、转义、工作目录）。
网络类失败：查代理、防火墙、MCP 传输方式（stdio / HTTP / SSE）。

速查

| 动作 | 说明 | |------|------| | 获取技能包 | ClawHub / 站内 ZIP，核对版本 | | 权威步骤 | 优先阅读 ZIP 内 SKILL.md | | 首次试跑 | 使用 SKILL.md 最小示例 | | 验收 | 对照路径、测试命令或回调负载 |

常见故障

无输出或立即退出 → 工作目录错误、依赖未装、或 Claude Code 未登录；按 SKILL.md 自检清单执行。
权限被拒绝 → 检查沙箱路径、--permission-mode 与工具白名单。
与简介不符 → 以英文 SKILL 与上游仓库为准，站内稿仅作结构化导读。

# Claude Code + MiniMax-M2.5 配置与使用完全指南

使用 MiniMax-M2.5 模型通过 Claude Code 进行 AI 编程的完整教程。

---

## 一、什么是 Claude Code？

Claude Code 是 Anthropic 推出的 AI 编程助手，可以：
- 读写代码、创建/修改文件
- 执行命令、运行测试
- 帮你完成编程任务
- 支持上下文理解和连续对话

**注意**：默认使用 Anthropic API，接入 MiniMax 后可使用国产模型。

---

## 二、配置步骤

### 前置要求
1. 已安装 Claude Code
2. 已拥有 MiniMax API Key（从 platform.minimaxi.com 获取）

### 重要提示

> 在配置前，请确保清除以下 Anthropic 相关的环境变量，以免影响 MiniMax API 的正常使用：
> - `ANTHROPIC_AUTH_TOKEN`
> - `ANTHROPIC_BASE_URL`

### 方式一：cc-switch（推荐，最简单）

cc-switch 是一个可视化工具，可以快速切换 Claude Code 的 API 配置。

#### 1. 安装 cc-switch

```bash
# macOS / Linux
brew tap farion1231/ccswitch
brew install --cask cc-switch

# Windows
# 前往 https://github.com/farion1231/cc-switch/releases 下载安装包
```

#### 2. 添加 MiniMax 配置

1. 启动 cc-switch 应用
2. 点击右上角 **"+"** 按钮
3. 在预设供应商列表中选择 **MiniMax**
4. 填写您的 MiniMax API Key
5. 点击确认

#### 3. 配置模型名称

1. 在配置列表中，找到刚添加的 MiniMax 配置
2. 将模型名称修改为：`MiniMax-M2.5`（全部模型都要改）
3. 点击右下角 **"添加"**

#### 4. 启用配置

1. 回到 cc-switch 首页
2. 找到您的 MiniMax 配置
3. 点击 **"启用"** 按钮

#### 5. 编辑配置文件

编辑 `~/.claude.json` 文件（如果不存在则创建）：

```json
{
  "hasCompletedOnboarding": true
}
```

---

### 方式二：手动配置（适合高级用户）

#### 1. 编辑 ~/.claude/settings.json

```bash
# 如果文件不存在则创建
touch ~/.claude/settings.json
```

添加以下内容（将 `你的MINIMAX_API_KEY` 替换为实际 API Key）：

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的MINIMAX_API_KEY",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.5"
  }
}
```

#### 2. 编辑 ~/.claude.json

```bash
# 如果文件不存在则创建
touch ~/.claude.json
```

添加以下内容：

```json
{
  "hasCompletedOnboarding": true
}
```

---

### 方式三：VS Code 插件配置

如果你使用 VS Code，可以配置 Claude Code 插件。

#### 1. 安装插件

在 VS Code 扩展商店搜索 "Claude Code" 并安装。

#### 2. 配置模型

两种方式：

**方式A：设置界面**
1. 打开 VS Code 设置
2. 搜索 "Claude Code: Selected Model"
3. 输入 `MiniMax-M2.5`

**方式B：settings.json**
```json
{
  "claude-code.selectedModel": "MiniMax-M2.5"
}
```

#### 3. 配置环境变量

1. 打开 VS Code 设置
2. 点击 "Edit in settings.json"
3. 添加以下配置：

```json
"claudeCode.environmentVariables": [
  {
    "name": "ANTHROPIC_BASE_URL",
    "value": "https://api.minimaxi.com/anthropic"
  },
  {
    "name": "ANTHROPIC_AUTH_TOKEN",
    "value": "你的MINIMAX_API_KEY"
  },
  {
    "name": "API_TIMEOUT_MS",
    "value": "3000000"
  },
  {
    "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
    "value": "1"
  },
  {
    "name": "ANTHROPIC_MODEL",
    "value": "MiniMax-M2.5"
  },
  {
    "name": "ANTHROPIC_SMALL_FAST_MODEL",
    "value": "MiniMax-M2.5"
  },
  {
    "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
    "value": "MiniMax-M2.5"
  },
  {
    "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
    "value": "MiniMax-M2.5"
  },
  {
    "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
    "value": "MiniMax-M2.5"
  }
]
```

---

## 三、使用方法

### 3.1 启动 Claude Code

```bash
# 进入项目目录
cd 你的项目文件夹

# 启动对话模式
claude

# 或直接指定任务（一次性执行）
claude "帮我写一个 Python 脚本"
```

### 3.2 首次使用设置

首次启动时：
1. Claude Code 会询问是否信任当前目录
2. 输入 `y` 选择 **"Trust This Folder"**
3. 即可开始对话

### 3.3 核心命令

| 命令 | 说明 |
|------|------|
| `claude` | 启动交互式对话 |
| `claude -p "任务描述"` | 一次性任务模式 |
| `Ctrl+C` | 中断当前对话 |
| `Ctrl+L` | 清屏 |
| `y` | 确认执行代码修改 |
| `n` | 拒绝执行 |

### 3.4 对话流程

```bash
# 1. 启动
$ cd myproject
$ claude

# 2. 首次信任目录
The current directory is /path/to/myproject. Type 'y' to allow Claude to read and edit files in this directory, or 'n' to exit.
→ y

# 3. 开始对话
Hello! How can I help you today?

# 4. 提出需求
> 帮我写一个 Python 脚本，批量重命名文件

# 5. Claude 会先展示计划
# 然后输入 y 确认执行
→ y

# 6. 查看结果
# 文件已创建完成
```

### 3.5 常用场景

#### 场景1：写新代码
```
> 帮我写一个 Python 脚本，读取 CSV 文件并生成统计图表
```

#### 场景2：调试代码
```
> 这个代码运行报错：xxx，请帮我修复
```

#### 场景3：代码审查
```
> 请审查 src/app.py 的代码质量，并提出改进建议
```

#### 场景4：重构代码
```
> 请重构这个函数，使其更易读和高效
```

#### 场景5：写测试
```
> 为 src/utils.py 编写单元测试
```

#### 场景6：解释代码
```
> 解释这段代码的功能：
```

#### 场景7：项目初始化
```
> 帮我创建一个 React 项目，使用 TypeScript
```

### 3.6 对话技巧

1. **明确需求**：越具体越好
   - ❌ "帮我写个程序"
   - ✅ "帮我写一个 Python 脚本，读取 /data/users.csv，统计每个城市的用户数量，输出为 JSON 文件"

2. **分步进行**：复杂任务分多次对话
   ```
   # 第一次
   > 先帮我设计数据库结构
   
   # 第二次
   > 基于这个结构，帮我写 CRUD API
   ```

3. **查看文件**：让 Claude 读取现有代码
   ```
   > 读取 src/index.js，然后帮我添加登录功能
   ```

---

## 四、VS Code 插件使用

### 4.1 打开插件

- 侧边栏点击 Claude Code 图标
- 或使用快捷键 `Cmd+Shift+L` (Mac) / `Ctrl+Shift+L` (Windows)

### 4.2 对话方式

1. 在输入框输入需求
2. Claude 会分析代码并给出方案
3. 点击 "Accept" 应用修改

---

## 五、故障排除

### 常见问题

| 问题 | 原因 | 解决方案 |
|------|------|----------|
| 认证失败 | API Key 错误 | 检查 MiniMax API Key 是否正确 |
| 连接超时 | 网络问题 | 确认网络可访问 api.minimaxi.com |
| 模型不响应 | 配置错误 | 检查 ANTHROPIC_MODEL 是否为 MiniMax-M2.5 |
| 请求超时 | 超时时间太短 | 增加 API_TIMEOUT_MS 到 3000000 |

### 调试命令

```bash
# 查看详细日志
claude --verbose

# 查看当前配置
cat ~/.claude/settings.json

# 测试 API 连接
curl -H "Authorization: Bearer 你的APIKEY" https://api.minimaxi.com/anthropic/v1/models
```

### 重新配置

如果配置出错：
1. 删除配置文件：`rm ~/.claude/settings.json`
2. 重新按教程配置

---

## 六、注意事项

1. **环境变量优先级**：命令行设置的环境变量 > 配置文件
2. **API Key 安全**：不要将 API Key 提交到公开仓库
3. **使用配额**：注意 MiniMax API 的调用配额限制
4. **超时设置**：长代码生成建议设置 5 分钟超时
5. **清除旧配置**：如果之前配置过 Anthropic，需要清除相关环境变量

---

## 七、获取帮助

- MiniMax 平台：https://platform.minimaxi.com
- Claude Code 文档：https://docs.claude.com
- cc-switch GitHub：https://github.com/farion1231/cc-switch