> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moxus.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 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` 命令。

<Tabs>
  <Tab title="macOS / Linux / WSL">
    安装：

    ```bash theme={null}
    curl -fsSL https://claude.ai/install.sh | bash
    ```

    验证：

    ```bash theme={null}
    claude --version
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    安装：

    ```powershell theme={null}
    irm https://claude.ai/install.ps1 | iex
    ```

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

    验证：

    ```powershell theme={null}
    claude.cmd --version
    ```
  </Tab>

  <Tab title="Windows CMD">
    下载安装脚本：

    ```batch theme={null}
    curl -fsSL https://claude.ai/install.cmd -o install.cmd
    ```

    执行安装：

    ```batch theme={null}
    install.cmd
    ```

    清理安装脚本：

    ```batch theme={null}
    del install.cmd
    ```

    验证：

    ```batch theme={null}
    claude --version
    ```
  </Tab>

  <Tab title="npm">
    安装：

    ```bash theme={null}
    npm install -g @anthropic-ai/claude-code
    ```

    验证：

    ```bash theme={null}
    claude --version
    ```
  </Tab>
</Tabs>

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

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

<Steps>
  <Step title="打开 API 密钥页面">
    进入 Moxus AI 控制台的“API 密钥”页面，找到准备用于 Claude Code 的密钥。
  </Step>

  <Step title="打开导入配置">
    在该密钥所在行打开操作菜单，选择“导入配置”，然后切换到 `Claude Code`。
  </Step>

  <Step title="复制对应系统的脚本">
    macOS、Linux、WSL 使用 “macOS / Linux terminal” 脚本；Windows 使用 “Windows PowerShell” 脚本。
  </Step>

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

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

| 系统                  | 写入内容                                                                                                                                      |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| 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 窗口立即可用                                |

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

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

## 手动配置：仅当前终端

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

<Tabs>
  <Tab title="macOS / Linux / WSL">
    ```bash theme={null}
    ANTHROPIC_API_KEY="你的密钥" \
    ANTHROPIC_AUTH_TOKEN="你的密钥" \
    ANTHROPIC_BASE_URL="https://moxus.cloud" \
    claude --setting-sources project,local
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    ```powershell theme={null}
    $env:ANTHROPIC_API_KEY="你的密钥"
    $env:ANTHROPIC_AUTH_TOKEN="你的密钥"
    $env:ANTHROPIC_BASE_URL="https://moxus.cloud"
    claude.cmd --setting-sources "project,local"
    ```
  </Tab>
</Tabs>

`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 兼容接口是否可用：

<Tabs>
  <Tab title="macOS / Linux / WSL">
    ```bash theme={null}
    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"}
        ]
      }'
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    ```powershell theme={null}
    $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
    ```
  </Tab>
</Tabs>

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

<Tabs>
  <Tab title="macOS / Linux / WSL">
    ```bash theme={null}
    echo "$ANTHROPIC_BASE_URL"
    echo "$ANTHROPIC_API_KEY"
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    ```powershell theme={null}
    echo $env:ANTHROPIC_BASE_URL
    echo $env:ANTHROPIC_API_KEY
    ```
  </Tab>
</Tabs>

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

## 常见问题

<AccordionGroup>
  <Accordion title="OpenAI Base URL 能不能用于 Claude Code？">
    不建议。Claude Code 使用 Anthropic Messages 协议，应配置 `https://moxus.cloud`，由工具最终请求 `/v1/messages`。`https://moxus.cloud/v1` 是 OpenAI 兼容客户端常用的 Base URL。
  </Accordion>

  <Accordion title="为什么导入配置同时写了 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN？">
    这是为了兼容不同版本的 Claude Code 或不同 Anthropic 兼容客户端。两者都使用同一把 Moxus AI API 密钥。
  </Accordion>

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

    macOS / Linux / WSL：

    ```bash theme={null}
    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：

    ```powershell theme={null}
    [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` 项，不要删除整个设置文件。
  </Accordion>

  <Accordion title="运行 claude 后仍然请求官方 Anthropic 怎么办？">
    关闭并重新打开终端，再确认 `ANTHROPIC_BASE_URL` 的值是 `https://moxus.cloud`。如果你从图形界面启动客户端，它可能没有读取 shell 配置文件，需要改用终端启动或客户端自己的配置入口。
  </Accordion>

  <Accordion title="终端变量被 settings.json 覆盖怎么办？">
    `~/.claude/settings.json` 中的 `env` 配置会覆盖同名终端变量。你可以按使用场景选择以下方式：

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

      macOS / Linux / WSL：

      ```bash theme={null}
      ANTHROPIC_API_KEY="你的密钥" ANTHROPIC_AUTH_TOKEN="你的密钥" ANTHROPIC_BASE_URL="https://moxus.cloud" claude --setting-sources project,local
      ```

      Windows PowerShell：

      ```powershell theme={null}
      $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 密钥写入该参数。
  </Accordion>

  <Accordion title="Windows PowerShell 提示禁止运行 claude.ps1">
    这是 PowerShell 的执行策略拦住了 `claude.ps1`，不是 Claude 本身没安装好。最省事的做法是直接使用：

    ```powershell theme={null}
    claude.cmd --version
    ```

    或：

    ```powershell theme={null}
    claude.cmd --setting-sources "project,local"
    ```

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

    ```powershell theme={null}
    Set-ExecutionPolicy -Scope Process Bypass
    ```
  </Accordion>

  <Accordion title="Windows PowerShell 里的 project,local 为什么会报参数错误？">
    在 PowerShell 中，`project,local` 必须整体加引号，否则它不会按 Claude 需要的单个字符串参数传递。请使用：

    ```powershell theme={null}
    claude.cmd --setting-sources "project,local"
    ```

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

    ```powershell theme={null}
    claude.cmd --setting-sources "local"
    ```
  </Accordion>

  <Accordion title="模型名称应该填什么？">
    使用“模型广场”里显示的完整模型名称。若模型不支持 Anthropic Messages 协议，请改用 OpenAI 兼容客户端或更换模型。
  </Accordion>
</AccordionGroup>

## 相关文档

* [快速入门](/zh/overview/quickstart)
* [模型广场与定价](/zh/overview/models-and-pricing)