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 项目，使用 TypeScript3.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