简体中文

English

简体中文

English

Appearance

通过 ZenMux 使用 Claude Code CLI 指南 ​

Claude Code 是 Anthropic 推出的官方 Coding Agent，通过与 ZenMux 的集成，您可以使用更多模型选择，而不仅仅局限于 Claude 官方 API。

兼容性说明

ZenMux 完全支持 Anthropic API 协议，可以无缝集成到 Claude Code、Cursor 等工具中。只需修改两个参数即可使用。

注意 Anthropic 协议的 base_url="https://zenmux.ai/api/anthropic"。

配置方案 ​

安装 Claude Code ​

bash
# 使用 pnpm 安装（推荐）
pnpm install -g @anthropic-ai/claude-code

# 或使用 npm 安装
npm install -g @anthropic-ai/claude-code

配置 Claude Code ​

Claude Code 支持通过配置文件来设置环境变量。编辑或创建 ~/.claude/settings.json 文件，添加以下配置：

bash
# 如果 .claude 目录不存在，先创建目录
mkdir -p ~/.claude

# 创建或编辑配置文件
nano ~/.claude/settings.json  # 或使用其他编辑器如 vim、code 等

在配置文件中添加以下内容：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-ai-v1-xxx",
    "ANTHROPIC_BASE_URL": "https://zenmux.ai/api/anthropic",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-4.5"
  }
}

重要配置

请确保将 sk-ai-v1-xxx 替换为您的真实 ZenMux API Key。您可以在 ZenMux 控制台 中获取 API Key。

配置说明

  • ANTHROPIC_AUTH_TOKEN: 您的 ZenMux API Key
  • ANTHROPIC_BASE_URL: ZenMux Anthropic API 端点
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 禁用非必要流量
  • ANTHROPIC_DEFAULT_HAIKU_MODEL: 指定默认的 Haiku 模型（用于快速任务）
  • ANTHROPIC_DEFAULT_SONNET_MODEL: 指定默认的 Sonnet 模型（用于常规任务）
  • ANTHROPIC_DEFAULT_OPUS_MODEL: 指定默认的 Opus 模型（用于复杂任务）

直接启动使用 ​

配置好 settings.json 后，直接进入您的项目目录并启动 Claude Code：

bash
# 进入项目目录
cd my-project

# 直接启动 Claude Code
claude

便捷使用

配置文件方式更加便捷，无需每次手动设置环境变量，配置会自动在每次启动 Claude Code 时加载。

支持的模型 ​

Anthropic 协议支持模型说明

支持 Anthropic 协议的模型正在分批适配中，当前已支持的模型可以通过官方模型列表筛选 Anthropic API Compatible 查看: anthropic-support 或者也可以通过模型详情页查看: anthropic-support

下面是一些推荐使用的编程能力较强的模型模型列表，完整的支持 Anthropic 协议的模型请按照上述方式获取。

模型 slug
anthropic/claude-sonnet-4.5
anthropic/claude-opus-4.5
google/gemini-3-pro-preview
openai/gpt-5.1-codex
openai/gpt-5.1-codex-mini
anthropic/claude-opus-4.1
baidu/ernie-5.0-thinking-preview
volcengine/doubao-seed-code
moonshotai/kimi-k2-thinking
moonshotai/kimi-k2-thinking-turbo
minimax/minimax-m2
kuaishou/kat-coder-pro-v1
anthropic/claude-haiku-4.5
google/gemini-2.5-pro
openai/gpt-5-codex
openai/gpt-5
x-ai/grok-4-fast
x-ai/grok-code-fast-1
x-ai/grok-4-fast-non-reasoning
deepseek/deepseek-chat
qwen/qwen3-coder-plus
moonshotai/kimi-k2-0905
z-ai/glm-4.6
z-ai/glm-4.5-air
inclusionai/ring-1t
inclusionai/ling-1t

更多模型可以通过上述 Anthropic 协议支持模型说明来获取！

使用效果 ​

配置完成后，您就可以在 Claude Code 中使用 ZenMux 的多种模型了：

Claude Code

您可以通过'/model'命令来确定当前使用的模型：

Claude Code Model

故障排除 ​

常见问题解决 ​

API Key 错误

问题：提示 API Key 无效或未授权

解决方案：

  • 检查环境变量中的 ZenMux API Key 是否正确
  • 确认 API Key 是否已激活且有足够余额
  • 验证 API Key 格式是否以 sk-ai-v1- 开头
模型不支持 Anthropic 协议

问题：使用某个模型时提示不支持 Anthropic 协议

解决方案：

  • 请通过 ZenMux 模型列表 筛选 "Anthropic API Compatible" 查看当前支持的模型
  • 或访问具体模型的详情页确认是否支持 Anthropic 协议
  • 选择上述支持列表中的模型进行使用
连接失败问题

问题：Claude Code 无法连接到 ZenMux 服务

解决方案：

  • 检查网络连接是否正常
  • 验证 ANTHROPIC_BASE_URL 是否配置正确为 https://zenmux.ai/api/anthropic
  • 确认防火墙设置是否阻止了外部连接
配置文件不生效

问题：设置了 settings.json 配置后仍然不生效

解决方案：

  • 确认配置文件路径为 ~/.claude/settings.json
  • 检查 JSON 格式是否正确（注意 JSON 标准不支持注释，如有注释请删除）
  • 使用 cat ~/.claude/settings.json 验证配置文件内容
  • 重新启动 Claude Code 以加载最新配置
VSCode Claude Code 插件配置

问题：在 VSCode 的 Claude Code 插件 GUI 模式下遇到问题

解决方案：

您可以通过 VSCode 插件设置直接调整 Claude Code 的模型配置，修改为您配置文件中配置的模型 slug。具体操作方式如下图所示：

VSCode Claude Code 插件配置VSCode Claude Code 插件配置

进阶配置 ​

配置不同规模的模型 ​

您可以根据不同任务需求在 ~/.claude/settings.json 中配置不同规模的模型：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-ai-v1-xxx",
    "ANTHROPIC_BASE_URL": "https://zenmux.ai/api/anthropic",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-4.5"
  }
}
json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-ai-v1-xxx",
    "ANTHROPIC_BASE_URL": "https://zenmux.ai/api/anthropic",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-sonnet-4.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-opus-4.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "google/gemini-2.5-pro"
  }
}
json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-ai-v1-xxx",
    "ANTHROPIC_BASE_URL": "https://zenmux.ai/api/anthropic",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek/deepseek-chat",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "moonshotai/kimi-k2-0905",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen/qwen3-coder-plus"
  }
}

通过这种方式，您可以在不同的使用场景下获得最佳的性能和成本平衡。

更多模型

查看 ZenMux 模型列表 了解所有可用模型及其详细信息

联系我们

如果您在使用过程中遇到任何问题，或有任何建议和反馈，欢迎通过以下方式联系我们：

更多联系方式和详细信息，请访问我们的联系我们页面。