在 Claude Code 中使用 PixMind

通过 PixMind Anthropic Messages 兼容端点接入 Claude Code，并配置认证、模型发现和默认模型。

PixMind 已提供 Claude Code 所需的 Anthropic Messages 兼容接口，包括消息生成、Token 统计和模型发现端点。

1. 接入地址

Claude Code 会在 Base URL 后自动追加 /v1/messages，因此 Base URL 应填写：

https://aihub-admin.aimix.pro/api-platform/anthropic

对应端点为：

消息生成：POST /api-platform/anthropic/v1/messages
Token 统计：POST /api-platform/anthropic/v1/messages/count_tokens
模型发现：GET /api-platform/anthropic/v1/models

不要把 Base URL 写成 .../api-platform/anthropic/v1/messages，否则 Claude Code 会重复拼接路径。

2. 配置 Claude Code

先在 PixMind API Platform创建 API Key，并将下面的 YOUR_API_KEY 替换为实际密钥。

方式一：PowerShell 当前终端（Windows）

$env:ANTHROPIC_BASE_URL="https://aihub-admin.aimix.pro/api-platform/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
$env:ANTHROPIC_MODEL="claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-sonnet-5"
$env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"

这组变量只对当前 PowerShell 窗口生效。

方式二：Shell 当前终端（macOS 与 Linux）

export ANTHROPIC_BASE_URL="https://aihub-admin.aimix.pro/api-platform/anthropic"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-sonnet-5"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"

这组变量只对当前 Shell 会话生效。

方式三：手动配置（macOS、Linux 与 Windows）

手动配置会持久应用到该用户的所有 Claude Code 项目。编辑或新建用户级 settings.json：

macOS 与 Linux：~/.claude/settings.json
Windows：%USERPROFILE%\.claude\settings.json，例如 C:\Users\你的用户名\.claude\settings.json
WSL：使用 Linux 路径 ~/.claude/settings.json，不要修改 Windows 用户目录下的文件

在文件中新增或合并 env 字段，并将 YOUR_API_KEY 替换为实际 API Key：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://aihub-admin.aimix.pro/api-platform/anthropic",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
    "API_TIMEOUT_MS": "3000000"
  }
}

如果文件已有其他配置，不要整段覆盖；只合并缺少的字段，并检查相邻字段之间的逗号。JSON 不允许注释或末尾多余逗号。CLAUDE_CODE_AUTO_COMPACT_WINDOW 只调整自动压缩的计算窗口，不会扩大模型实际上下文长度。

如果首次启动仍停留在 Anthropic 登录或引导流程，请另外编辑用户目录根部的状态文件：

macOS 与 Linux：~/.claude.json
Windows：%USERPROFILE%\.claude.json

将 hasCompletedOnboarding 合并到该文件的顶层；不要把它放进 ~/.claude/settings.json 的 env 中：

{
  "hasCompletedOnboarding": true
}

如果 .claude.json 已有其他字段，请保留原内容，只新增或修改 hasCompletedOnboarding。

ANTHROPIC_AUTH_TOKEN 会以 Authorization: Bearer 发送。也可以改用 ANTHROPIC_API_KEY，Claude Code 会发送 x-api-key；PixMind 两种认证头都支持。

3. 启动并验证

在同一个终端中启动 Claude Code：

claude --model claude-sonnet-5

进入后执行：

/status：确认 Anthropic Base URL 指向 PixMind。
/model：查看网关发现的 Claude 模型。
让 Claude Code 列出当前工作区文件，验证工具调用。

模型发现需要 Claude Code 2.1.129 或更高版本；旧版本仍可通过 ANTHROPIC_MODEL 或 claude --model <model-id> 指定模型。

可用 Claude 模型

claude-fable-5
claude-opus-5
claude-sonnet-5
claude-opus-4-8
claude-opus-4-8-cc

常见问题

401 Unauthorized：确认 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY 已在启动 Claude Code 的同一个终端生效。
404 Not Found：Base URL 应停在 /api-platform/anthropic，不要手动添加 /v1/messages。
模型选择器没有 PixMind 模型：升级 Claude Code 并启用 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1，或直接使用 --model。
能对话但不能操作文件：检查工作区信任、工具权限和 Claude Code permission mode。

在 Claude Code 中使用 PixMind

On this page