Claude Code 安装与 MiniMax 配置指南

Claude Code 安装与 MiniMax 配置指南

这篇文章记录如何在 Windows 上安装 Claude Code，并配置 MiniMax 的 Claude Code 兼容接口。以后自己重装，或者委托具备本机终端与文件操作能力的 AI Agent 代为部署时，可以直接照着做。

目标效果

配置完成后，Claude Code 的 /status 应该显示类似：

Anthropic base URL: https://api.minimaxi.com/anthropic
Model: MiniMax-M3
Setting sources: User settings

启动 Claude Code 时，左侧也会显示：

MiniMax-M3 · API Usage Billing

前置条件

需要准备：

• 已安装 Node.js 和 npm

• 一个 MiniMax API Key

• Windows Terminal 或 PowerShell

• 一个专门作为 Claude Code 工作区的项目文件夹，例如：

  F:\Claude Code项目

不要直接在 C:\Users\你的用户名 这种用户根目录里启动 Claude Code。范围太大，不利于安全和管理。

第一步：全局安装 Claude Code

在 PowerShell 里执行：

npm install -g @anthropic-ai/claude-code

安装完成后检查版本：

claude --version

如果能看到类似下面的输出，就说明安装好了：

2.1.160 (Claude Code)

第二步：创建 MiniMax 配置文件

Claude Code 会读取用户目录下的配置文件。

Windows 路径是：

C:\Users\你的用户名\.claude\settings.json
C:\Users\你的用户名\.claude.json

例如当前机器上是：

C:\Users\27602\.claude\settings.json
C:\Users\27602\.claude.json

写入 settings.json

创建或编辑：

C:\Users\你的用户名\.claude\settings.json

内容如下，把 MINIMAX_API_KEY 替换成你自己的 MiniMax 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-M3",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M3",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M3",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M3"
  }
}

写入 .claude.json

创建或编辑：

C:\Users\你的用户名\.claude.json

内容如下：

{
  "hasCompletedOnboarding": true
}

这个配置可以跳过 Claude Code 第一次启动时的登录引导。

第三步：从项目目录启动 Claude Code

进入你信任的项目目录：

cd "F:\Claude Code项目"

启动 Claude Code：

claude

如果出现安全确认：

Quick safety check: Is this a project you created or one you trust?

确认当前目录是你的项目目录后，选择：

1. Yes, I trust this folder

如果它显示的是 C:\Users\你的用户名，建议选择：

2. No, exit

然后重新进入项目目录再启动。

第四步：检查是否配置成功

进入 Claude Code 后输入：

/status

重点检查：

Anthropic base URL: https://api.minimaxi.com/anthropic
Model: MiniMax-M3
Setting sources: User settings

如果这些都对，就说明 Claude Code 已经通过 MiniMax 接口运行。

常见问题

仍然出现 Claude 登录菜单怎么办？

如果看到：

Select login method:
1. Claude account with subscription
2. Anthropic Console account
3. 3rd-party platform

通常说明 Claude Code 没有读到配置文件。

检查这几个点：

• settings.json 是否放在 Windows 用户目录下，而不是只放在 WSL 的 /home/用户名
• 文件路径是否正确：C:\Users\你的用户名\.claude\settings.json
• settings.json 是否是合法 JSON
• ANTHROPIC_AUTH_TOKEN 是否已经替换成真实 MiniMax API Key

Windows 和 WSL 怎么区分？

如果你在 PowerShell 里运行：

claude

一般读的是 Windows 用户目录：

C:\Users\你的用户名\.claude\settings.json

如果你在 WSL 里运行：

claude

一般读的是 Linux 用户目录：

/home/你的用户名/.claude/settings.json

两个地方是不同的。在哪边启动 Claude Code，就要在哪边配置。

环境变量会覆盖配置文件吗？

会。

如果系统里永久设置了这些环境变量，它们的优先级高于 settings.json：

ANTHROPIC_AUTH_TOKEN
ANTHROPIC_BASE_URL
ANTHROPIC_MODEL

如果配置怎么改都不生效，要检查这些环境变量有没有被设置。

PowerShell 检查方式：

Get-ChildItem Env: | Where-Object { $_.Name -match '^ANTHROPIC_' }

委托本机操作型 Agent 代为部署时，可以直接复制这段提示词

下面这段适合发给已经具备本机操作权限的编程 Agent，例如 Codex、桌面自动化 Agent、远程运维 Agent，或其他可以执行终端命令并编辑本机文件的工具。它的用途是让 Agent 完成 Claude Code 的安装、MiniMax 接口配置和基础校验。

注意：如果 Claude Code 还没有安装，就不要把这段话发给 Claude Code 本身执行；应交给当前已经可用的本机操作型 Agent。记得把里面的 MINIMAX_API_KEY 替换成你的真实 MiniMax API Key。

请在当前 Windows 机器上部署 Claude Code，并将它配置为使用 MiniMax 的 Claude Code 兼容接口。你可以执行终端命令，也可以创建或编辑当前 Windows 用户目录下的配置文件。

1. 使用 npm 全局安装 Claude Code，包名是 @anthropic-ai/claude-code。
2. 检查 claude --version 是否可用。
3. 在 Windows 用户目录创建或编辑 C:\Users\当前用户名\.claude\settings.json，写入以下配置，并把 ANTHROPIC_AUTH_TOKEN 设置为我的 MiniMax 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-M3",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M3",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M3",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M3"
  }
}

4. 在 Windows 用户目录创建或编辑 C:\Users\当前用户名\.claude.json，写入：

{
  "hasCompletedOnboarding": true
}

5. 不要把我的真实 API Key 明文输出到最终回答里。
6. 配置完成后，让我进入自己的项目目录再运行 claude，不要在 C:\Users\当前用户名 这种用户根目录里启动。
7. 最后提醒我在 Claude Code 里运行 /status，确认 base URL 是 https://api.minimaxi.com/anthropic，模型是 MiniMax-M3。

推荐启动流程

以后每次使用时，按这个顺序：

cd "F:\Claude Code项目"
claude

进入 Claude Code 后可以先检查：

/status

看到 MiniMax-M3 和 https://api.minimaxi.com/anthropic 就可以正常使用了。