Claude Code

Claude Code 是在终端中使用的编码助手，可以读取项目、修改代码并调用开发工具。通过 Mozia 的 Anthropic 兼容接口，可以使用自己的 Matrix API Key 接入平台上的文本模型。

本文以 deepseek/deepseek-v4-flash 为例。其他模型需同时支持对话、流式响应和工具调用；模型可调用不等于支持 Claude Code 的所有功能。

一、准备 API Key

1. 登录 Matrix 控制台，创建并保存自己的 API Key。
2. 确认账户余额以及 API Key 的模型权限。
3. 在模型目录中取得完整模型 ID，也可以通过 查询可用模型确认。

配置项	值
API 基础地址	https://mzsjai.com
认证令牌	Matrix API Key
默认模型	deepseek/deepseek-v4-flash
实际请求接口	POST /v1/messages

Claude Code 会自动拼接 /v1/messages，基础地址不要填写 /v1 或完整接口路径。模型请求按 Mozia 平台的实际价格与用量计费。

二、安装 Claude Code

已经安装的用户先执行 claude --version，可以直接进入配置步骤。以下是 Claude Code 官方安装方式；平台要求和更新说明见 官方安装文档。

macOS、Linux、WSL

curl -fsSL https://claude.ai/install.sh | bash
claude --version

Windows PowerShell

irm https://claude.ai/install.ps1 | iex
claude --version

如果新安装后找不到 claude，关闭并重新打开终端，检查安装提示中的 PATH 配置。

三、配置并启动

选择下面一种方式。示例中的 <YOUR_API_KEY> 需要替换为自己的密钥，不要保留尖括号。

方式 A：终端环境变量（macOS、Linux、WSL）

在 Bash 或 Zsh 中复制以下完整配置：

unset ANTHROPIC_API_KEY

export ANTHROPIC_BASE_URL="https://mzsjai.com"
export ANTHROPIC_AUTH_TOKEN="<YOUR_API_KEY>"
export ANTHROPIC_MODEL="deepseek/deepseek-v4-flash"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export CLAUDE_CODE_SUBAGENT_MODEL="$ANTHROPIC_MODEL"
export CLAUDE_CODE_EFFORT_LEVEL="max"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="1000000"

claude --setting-sources ""

请在自己的项目目录启动。首次使用时，按提示确认工作目录和需要的工具权限。

--setting-sources "" 让本次启动不加载用户、项目和本地 settings 文件，避免旧服务地址或旧模型覆盖终端配置；相应文件中的其他设置也不会加载，组织管理策略仍可能生效。此方式适合首次验证和排查。设置来源的含义见 Claude Code CLI 参考。

环境变量只对当前终端及其子进程生效。长期使用可采用下面的 settings 文件方式。

方式 B：保存 settings 文件（所有系统）

编辑用户目录中的配置文件：

• macOS、Linux、WSL：~/.claude/settings.json
• Windows：%USERPROFILE%\.claude\settings.json

新文件可以使用以下内容。如果文件已经存在，只合并相关 env 字段，保留原有权限、插件及其他配置。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://mzsjai.com",
    "ANTHROPIC_AUTH_TOKEN": "<YOUR_API_KEY>",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_MODEL": "deepseek/deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek/deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek/deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek/deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek/deepseek-v4-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
  }
}

这里使用 ANTHROPIC_AUTH_TOKEN 认证，并清空同一配置中的 ANTHROPIC_API_KEY，避免同时发送不同密钥。JSON 中请直接填写模型 ID，"$ANTHROPIC_MODEL" 不会像 Shell 变量一样展开。

保存后退出原有 Claude Code 会话，在项目目录执行：

claude

使用 settings 文件时，不要加 --setting-sources ""，否则刚保存的文件不会加载。可以通过 /status 检查当前模型和设置来源；配置优先级见 官方设置说明。

API Key 应保存在自己控制的本机配置或密钥管理工具中，不要提交到项目仓库，也不要发送包含完整密钥的截图或日志。

配置项说明

变量	作用
ANTHROPIC_BASE_URL	Mozia API 基础地址
ANTHROPIC_AUTH_TOKEN	通过 Bearer 认证发送的 Matrix API Key
ANTHROPIC_MODEL	主会话使用的完整模型 ID
ANTHROPIC_DEFAULT_OPUS_MODEL	Claude Code 的 Opus 别名对应模型
ANTHROPIC_DEFAULT_SONNET_MODEL	Sonnet 别名对应模型
ANTHROPIC_DEFAULT_HAIKU_MODEL	Haiku 别名对应模型
CLAUDE_CODE_SUBAGENT_MODEL	子代理默认使用的模型
CLAUDE_CODE_EFFORT_LEVEL	客户端请求的推理强度；示例使用 max，实际效果取决于模型支持
CLAUDE_CODE_MAX_CONTEXT_TOKENS	客户端估算上下文窗口与自动压缩时使用的 Token 数

Opus、Sonnet、Haiku 在这里是客户端的模型别名。将它们映射到同一平台模型，便于首次接入时统一主会话和辅助调用的配置。

四、验证接入

启动后先输入一条简单指令：

请只回复：连接成功。

然后在项目目录创建一个不含敏感信息的测试文件，例如 claude-check.txt，写入一段自己指定的文字，再输入：

请使用 Read 工具读取 claude-check.txt，并返回文件中的文字。

确认界面中实际出现读取文件的工具调用，并在最终回复中看到文件内容。基础对话成功后，还需要这一步验证工具调用和结果回传。

渠道测试中的简单问候请求不能替代 Claude Code 的完整流程验证。复杂工具、MCP、图片输入和长会话压缩需按实际使用场景进一步确认。

相关文档

• Anthropic 兼容接口
• OpenAI 兼容接口
• Claude Code 官方文档