Claude Code MiniMax 配置

配置 Claude Code 使用 MiniMax-M2.5 模型，实现国产模型API接入与高效AI编程助手功能。

Security Scan

The instructions generally match the stated goal (point Claude Code at MiniMax), but the skill metadata omits the required API key and the guide recommends installing a third‑party brew/cask (and editing home config files), so there are coherence and supply‑chain concerns you should review before proceeding.

Purpose & Capability

The skill's stated purpose is to configure Claude Code to use the MiniMax-M2.5 model, and the SKILL.md does provide concrete steps to do that (editing ~/.claude/settings.json, setting ANTHROPIC_* env vars, configuring VS Code). However the metadata declares no required environment variables or primary credential while the instructions explicitly require a MiniMax API Key and setting ANTHROPIC_AUTH_TOKEN — a mismatch that reduces transparency and is concerning.

Instruction Scope

Most instructions stay within configuration tasks for Claude Code (editing ~/.claude/settings.json and ~/.claude.json, setting env vars, configuring VS Code). The doc also instructs users to clear Anthropic-related environment variables and to 'Trust This Folder' when launching claude (which grants the tool permission to read/write project files). Those are within the scope of reconfiguring the client, but the guidance to clear env vars and to trust folders is impactful and should be done deliberately.

Install Mechanism

There is no install spec in the skill bundle, but the instructions recommend installing 'cc-switch' via a third‑party brew tap (farion1231/ccswitch) or downloading releases from a GitHub repo. That directs users to add an unverified tap and install a GUI cask from an external maintainer — a supply‑chain risk. The skill itself does not provide provenance or hashes for that tool.

Credentials

The guide requires a MiniMax API Key and asks the user to set it as ANTHROPIC_AUTH_TOKEN (and other ANTHROPIC_* variables) in config files or VS Code settings, but the skill metadata lists no required env vars or primary credential. Requiring a secret while declaring none is a transparency gap. Storing API keys in persistent home config files or editor settings can leak secrets if those files are backed up or committed; the guide warns not to commit keys but still shows examples that embed them inline.

Persistence & Privilege

The skill is instruction-only with no install spec and does not request 'always:true' or other elevated privileges. It does not modify other skills or system-wide agent settings directly. The main persistence concern is the user's decision to store the API key and model settings in home config files (user-controlled).

What to consider before installing

What to consider before installing/using this skill: - Metadata mismatch: the SKILL.md expects you to have a MiniMax API key and to set ANTHROPIC_* variables, but the skill declares no required credentials — treat that as an omission and don't assume harmless defaults. - Verify third‑party tooling: the guide recommends installing 'cc-switch' from a third‑party brew tap / GitHub repo. Before installing, review the project's source, releases, and maintainer reputation; avoid installing unknown taps or binaries you can't verify. - Protect your API key: prefer setting API keys in ephemeral environment variables or an OS credential store rather than embedding them in ~/.claude/settings.json or editor settings. If you must store them, ensure the files are excluded from backups and git (add to .gitignore). - Be cautious clearing Anthropic env vars: removing or changing ANTHROPIC_AUTH_TOKEN/ANTHROPIC_BASE_URL can break other workflows that use Anthropic; back up current settings first. - Trusting folders: the claude CLI may ask to 'Trust This Folder' to allow read/write — only grant that to directories you control and have reviewed. - Validate endpoints: confirm https://api.minimaxi.com and platform.minimaxi.com are the official MiniMax endpoints and review their docs/privacy/policy. If you want, I can: (1) extract exactly which files and env vars the guide will change, (2) produce safer alternative commands that avoid writing secrets to disk, or (3) help you vet the cc-switch GitHub repo for signs of trustworthiness.

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

# 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 文件（如果不存在则创建）：

{
  "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：设置界面

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

方式B：settings.json

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

3. 配置环境变量

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

"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 首次使用设置

首次启动时：

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

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

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

调试命令

# 查看详细日志
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