安装 Claude Code
如果使用下方一键配置向导，可跳过本节。向导检测不到 claude 命令时，会询问是否运行 Claude Code 官方安装脚本。
可参考 Claude Code 文档 进行安装。
配置 MiniMax API
配置前请清除以下环境变量，它们的优先级高于配置文件，会覆盖 MiniMax 设置：如果 ~/.bashrc 或 ~/.zshrc 中导出了这两个变量，请同时删除对应行，否则新开的终端会重新加载。 方式一：一键配置向导
方式二：手动编辑配置文件
方式三：使用 cc-switch
直接运行：在工具列表中选择 Claude Code。如果尚未安装，在第二个多选列表中保留 Claude Code。向导会运行官方安装脚本并检查 claude --version，然后更新 ~/.claude/settings.json，配置 MiniMax 模型列表。命令参数与备份说明见 MiniMax CLI。
-
编辑或创建
~/.claude/settings.json（Windows 为 用户目录\.claude\settings.json），将 <MINIMAX_API_KEY> 替换为你的 订阅 Key：
-
编辑或创建
~/.claude.json（Windows 为 用户目录\.claude.json），加入：
-
进入工作目录，运行
claude，选择 信任此文件夹（Trust This Folder） 后即可开始使用。
手动示例使用推荐的 512K 自动压缩窗口（CLAUDE_CODE_AUTO_COMPACT_WINDOW=524288），详见512K 配置建议。cc-switch 可以快速切换 Claude Code 的 API 配置。
- 安装 cc-switch：macOS / Linux 运行
brew tap farion1231/ccswitch && brew install --cask cc-switch；Windows 从 GitHub Releases 下载安装包。
- 启动 cc-switch，点击右上角 +，选择预设的 MiniMax 供应商，填入你的 订阅 Key。
- 将所有模型名称改为
MiniMax-M3.1-Flash-Preview，勾选 声明支持1M。
- 在该供应商配置 JSON 的
env 中加入 "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "524288"，然后点击右下角 添加。
- 回到首页，点击 启用。
- 按「方式二」第 2 步在
~/.claude.json 中加入 hasCompletedOnboarding。
验证配置生效
启动 claude 后，在 TUI 中依次输入以下 slash 命令，确认已切换到 MiniMax：
/status 应显示 ANTHROPIC_BASE_URL 指向 api.minimax.cn/anthropic。/model 应显示当前模型为 MiniMax-M3.1-Flash-Preview。
MiniMax-M3.1-Flash-Preview 默认开启思考且不可关闭。
