Claude Code

使用 Anthropic 兼容接口将 Claude Code 或 Claude CLI 类工具连接到 Moxus AI。

Claude Code 使用 Anthropic Messages 协议。接入 Moxus AI 时，不要填写 OpenAI 兼容地址；应使用 https://moxus.cloud 作为 Anthropic Base URL，并使用支持 Claude / Anthropic 兼容调用的模型。

​

配置值

项	值
API Key	你的密钥
Anthropic Base URL	https://moxus.cloud
最终请求地址	https://moxus.cloud/v1/messages
推荐模型	在“模型广场”选择 Claude 或 Anthropic 兼容模型

​

安装 Claude Code

先安装，再单独执行版本检查。不要把安装命令和验证命令一起复制运行；安装完成后，终端可能需要重新打开才能识别 claude 命令。

macOS / Linux / WSL

安装：

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

验证：

claude --version

Windows PowerShell

安装：

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

如果随后执行 claude 提示 PowerShell 禁止运行 claude.ps1，优先直接使用 claude.cmd，不走 .ps1 包装脚本。

验证：

claude.cmd --version

Windows CMD

下载安装脚本：

curl -fsSL https://claude.ai/install.cmd -o install.cmd

执行安装：

install.cmd

清理安装脚本：

del install.cmd

验证：

claude --version

npm

安装：

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

验证：

claude --version

​

推荐方式：从 API 密钥导入配置

在 Moxus AI 的“API 密钥”页面，每个密钥的操作菜单里都有“导入配置”。选择 Claude Code 后，页面会生成适合当前密钥和当前站点地址的终端脚本。

1. 打开 API 密钥页面

   进入 Moxus AI 控制台的“API 密钥”页面，找到准备用于 Claude Code 的密钥。

2. 打开导入配置

   在该密钥所在行打开操作菜单，选择“导入配置”，然后切换到 Claude Code。

3. 复制对应系统的脚本

   macOS、Linux、WSL 使用 “macOS / Linux terminal” 脚本；Windows 使用 “Windows PowerShell” 脚本。

4. 直接在终端执行脚本

   打开终端，将刚复制的脚本直接粘贴到同一个终端窗口并按回车。脚本兼容 zsh 和 Bash；执行完成后，当前窗口立即可使用新配置。

导入配置脚本的行为如下：

系统	写入内容
macOS / Linux / WSL	创建 ~/.claude/moxus-code-env.sh，写入 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL，并在 ~/.zshrc 和 ~/.bashrc 中加入自动加载配置
Windows PowerShell	写入当前 Windows 用户环境变量 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL，并让当前 PowerShell 窗口立即可用

macOS、Linux、WSL 使用“macOS / Linux terminal”脚本；Windows 使用 PowerShell 脚本。两种脚本均可在对应终端中直接粘贴执行，不需要创建文件或运行额外命令。

导入配置会把 API 密钥保存到本机环境文件或用户环境变量中。不要把终端截图、shell 配置文件或环境变量文件发送给他人。

​

手动配置：仅当前终端

如果你不想使用“导入配置”，可以先用临时环境变量测试。以下命令只对当前终端窗口生效，关闭窗口后会失效，并跳过用户级 ~/.claude/settings.json，避免其中的旧配置覆盖当前密钥。

macOS / Linux / WSL

ANTHROPIC_API_KEY="你的密钥" \
ANTHROPIC_AUTH_TOKEN="你的密钥" \
ANTHROPIC_BASE_URL="https://moxus.cloud" \
claude --setting-sources project,local

Windows PowerShell

$env:ANTHROPIC_API_KEY="你的密钥"
$env:ANTHROPIC_AUTH_TOKEN="你的密钥"
$env:ANTHROPIC_BASE_URL="https://moxus.cloud"
claude.cmd --setting-sources "project,local"

ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 都写入同一个 Moxus AI 密钥，是为了兼容不同 Claude Code 版本或不同 Anthropic 兼容客户端的读取习惯。

​

最终请求方式

配置完成后，Claude Code 仍然按 Anthropic Messages 协议请求，只是接口地址和密钥换成 Moxus AI：

项	值
请求方式	POST
请求地址	https://moxus.cloud/v1/messages
鉴权请求头	x-api-key: 你的密钥
协议版本请求头	anthropic-version: 2023-06-01
模型字段	使用“模型广场”中的 Anthropic 兼容模型

它不会请求 https://moxus.cloud/v1/chat/completions，也不是 OpenAI 兼容的 Authorization: Bearer ... 鉴权方式。

​

手动验证

先用对应终端的命令验证密钥、模型和 Anthropic 兼容接口是否可用：

macOS / Linux / WSL

curl https://moxus.cloud/v1/messages \
  -H "x-api-key: 你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 512,
    "messages": [
      {"role": "user", "content": "请用一句话介绍 Moxus AI"}
    ]
  }'

Windows PowerShell

$headers = @{
  "x-api-key" = "你的密钥"
  "anthropic-version" = "2023-06-01"
}
$body = @{
  model = "claude-opus-4-6"
  max_tokens = 512
  messages = @(@{ role = "user"; content = "请用一句话介绍 Moxus AI" })
} | ConvertTo-Json -Depth 4 -Compress

Invoke-RestMethod -Method Post -Uri "https://moxus.cloud/v1/messages" -Headers $headers -ContentType "application/json" -Body $body

如果请求成功，但 Claude Code 失败，优先检查启动 Claude Code 的终端是否能读取这些变量：

macOS / Linux / WSL

echo "$ANTHROPIC_BASE_URL"
echo "$ANTHROPIC_API_KEY"

Windows PowerShell

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEY

不要把第二条命令的完整输出截图发给他人。

​

常见问题

OpenAI Base URL 能不能用于 Claude Code？

不建议。Claude Code 使用 Anthropic Messages 协议，应配置 https://moxus.cloud，由工具最终请求 /v1/messages。https://moxus.cloud/v1 是 OpenAI 兼容客户端常用的 Base URL。

为什么导入配置同时写了 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN？

这是为了兼容不同版本的 Claude Code 或不同 Anthropic 兼容客户端。两者都使用同一把 Moxus AI API 密钥。

如何删除 Claude Code 的 Moxus AI 配置？

以下命令会删除“导入配置”创建的 Moxus AI 环境文件、Shell 自动加载标记和当前用户环境变量，不会删除其他 Claude Code 设置。

macOS / Linux / WSL：

rm -f "$HOME/.claude/moxus-code-env.sh"

for profile in "$HOME/.zshrc" "$HOME/.bashrc"; do
  [ -f "$profile" ] || continue
  sed -i.bak '/# Moxus AI Claude Code start/,/# Moxus AI Claude Code end/d' "$profile"
done

unset ANTHROPIC_API_KEY ANTHROPIC_AUTH_TOKEN ANTHROPIC_BASE_URL

Windows PowerShell：

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", $null, "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "User")

Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
Remove-Item Env:ANTHROPIC_BASE_URL -ErrorAction SilentlyContinue

关闭并重新打开终端后生效。若你曾手动在 ~/.claude/settings.json 中写入这些变量，请只删除其中同名的 env 项，不要删除整个设置文件。

运行 claude 后仍然请求官方 Anthropic 怎么办？

关闭并重新打开终端，再确认 ANTHROPIC_BASE_URL 的值是 https://moxus.cloud。如果你从图形界面启动客户端，它可能没有读取 shell 配置文件，需要改用终端启动或客户端自己的配置入口。

终端变量被 settings.json 覆盖怎么办？

~/.claude/settings.json 中的 env 配置会覆盖同名终端变量。你可以按使用场景选择以下方式：

• 仅本次终端优先：启动时跳过用户级设置，但继续读取当前项目的 project 和 local 设置：

  macOS / Linux / WSL：

  ANTHROPIC_API_KEY="你的密钥" ANTHROPIC_AUTH_TOKEN="你的密钥" ANTHROPIC_BASE_URL="https://moxus.cloud" claude --setting-sources project,local
  

  Windows PowerShell：

  $env:ANTHROPIC_API_KEY="你的密钥"
  $env:ANTHROPIC_AUTH_TOKEN="你的密钥"
  $env:ANTHROPIC_BASE_URL="https://moxus.cloud"
  claude.cmd --setting-sources "project,local"
  

  此方式不会读取 ~/.claude/settings.json，因此其中的旧地址或空值不会覆盖终端变量；同时，该文件中的主题、模型偏好等用户级设置也不会加载。

• 长期使用 Moxus AI：通过“API 密钥”页面的“导入配置”保存配置。若 ~/.claude/settings.json 中仍有旧值，只删除或更新冲突的 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL 三项，不要删除其他个人设置；之后正常运行 claude 即可。

Claude Code 没有让 Shell 环境变量自动高于所有设置文件的开关。--settings 可为单次启动覆盖设置，但不建议把 API 密钥写入该参数。

Windows PowerShell 提示禁止运行 claude.ps1

这是 PowerShell 的执行策略拦住了 claude.ps1，不是 Claude 本身没安装好。最省事的做法是直接使用：

claude.cmd --version

或：

claude.cmd --setting-sources "project,local"

如果你确实想继续直接执行 claude，可以先在当前窗口临时放开执行策略：

Set-ExecutionPolicy -Scope Process Bypass

Windows PowerShell 里的 project,local 为什么会报参数错误？

在 PowerShell 中，project,local 必须整体加引号，否则它不会按 Claude 需要的单个字符串参数传递。请使用：

claude.cmd --setting-sources "project,local"

如果你当前目录就是用户主目录，并且只想临时跳过 ~/.claude/settings.json，则改用：

claude.cmd --setting-sources "local"

模型名称应该填什么？

使用“模型广场”里显示的完整模型名称。若模型不支持 Anthropic Messages 协议，请改用 OpenAI 兼容客户端或更换模型。

​

相关文档

• 快速入门
• 模型广场与定价