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

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

一、什么是 Claude Code？

Claude Code 是 Anthropic 推出的 AI 编程助手，可以：

读写代码、创建/修改文件
执行命令、运行测试
帮你完成编程任务
支持上下文理解和连续对话

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

二、配置步骤

前置要求

已安装 Claude Code
已拥有 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

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

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

2. 添加 MiniMax 配置

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

3. 配置模型名称

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

4. 启用配置

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

5. 编辑配置文件

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

{
  "hasCompletedOnboarding": true
}

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

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

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

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

{
  "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

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

添加以下内容：

{
  "hasCompletedOnboarding": true
}

方式三：VS Code 插件配置

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

1. 安装插件

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

2. 配置模型

两种方式：

方式A：设置界面

打开 VS Code 设置
搜索 "Claude Code: Selected Model"
输入 MiniMax-M2.5

方式B：settings.json

{
  "claude-code.selectedModel": "MiniMax-M2.5"
}

3. 配置环境变量

打开 VS Code 设置
点击 "Edit in settings.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

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

# 启动对话模式
claude

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

3.2 首次使用设置

首次启动时：

Claude Code 会询问是否信任当前目录
输入 y 选择 "Trust This Folder"
即可开始对话

3.3 核心命令

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

3.4 对话流程

# 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 对话技巧

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

分步进行：复杂任务分多次对话

# 第一次
> 先帮我设计数据库结构

# 第二次
> 基于这个结构，帮我写 CRUD API

查看文件：让 Claude 读取现有代码

> 读取 src/index.js，然后帮我添加登录功能

四、VS Code 插件使用

4.1 打开插件

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

4.2 对话方式

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

五、故障排除

常见问题

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

调试命令

# 查看详细日志
claude --verbose

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

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

重新配置

如果配置出错：

删除配置文件：rm ~/.claude/settings.json
重新按教程配置

六、注意事项

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

七、获取帮助

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

Claude Code MiniMax 配置

Description