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

# Claude Code 接入

> 安装 Claude Code 终端编程助手并接入 HingNet AI 网关

**Claude Code** 是 Anthropic 提供的终端 AI 编程助手（CLI 命令为 `claude`）。完成安装后，可配置为通过 HingNet AI 网关调用。

## 系统要求

| 平台          | 要求                                                                                       |
| ----------- | ---------------------------------------------------------------------------------------- |
| **macOS**   | 13.0 及以上                                                                                 |
| **Windows** | 10（1809+）或 Server 2019+；需安装 [Git for Windows](https://git-scm.com/downloads/win)，或使用 WSL |
| **Linux**   | Ubuntu 20.04+、Debian 10+、Alpine 3.19+ 等                                                  |
| **硬件**      | 约 4GB+ 内存，x64 或 ARM64                                                                    |

## 安装

### 原生安装（推荐，支持自动更新）

<Tabs>
  <Tab title="macOS / Linux / WSL">
    ```bash theme={null}
    curl -fsSL https://claude.ai/install.sh | bash
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={null}
    irm https://claude.ai/install.ps1 | iex
    ```
  </Tab>

  <Tab title="Windows (CMD)">
    ```batch theme={null}
    curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
    ```
  </Tab>
</Tabs>

### 包管理器安装（需手动升级）

<Tabs>
  <Tab title="macOS (Homebrew)">
    ```bash theme={null}
    brew install --cask claude-code
    # 升级：brew upgrade claude-code
    ```
  </Tab>

  <Tab title="Windows (WinGet)">
    ```powershell theme={null}
    winget install Anthropic.ClaudeCode
    # 升级：winget upgrade Anthropic.ClaudeCode
    ```
  </Tab>
</Tabs>

### 验证安装

```bash theme={null}
claude --version
claude doctor
```

## 接入 HingNet AI 网关

在**启动 `claude` 的终端**中设置以下环境变量：

<Tabs>
  <Tab title="Bash / Zsh">
    ```bash theme={null}
    export ANTHROPIC_BASE_URL="https://models.hingnet.com.cn"
    export ANTHROPIC_API_KEY="<在 HingNet AI 控制台创建的 API 密钥>"
    claude
    ```
  </Tab>

  <Tab title="PowerShell">
    ```powershell theme={null}
    $env:ANTHROPIC_BASE_URL = "https://models.hingnet.com.cn"
    $env:ANTHROPIC_API_KEY = "<你的 HingNet AI API 密钥>"
    claude
    ```
  </Tab>
</Tabs>

<Warning>
  **不要**在 `ANTHROPIC_BASE_URL` 末尾拼接 `/v1`，Claude Code 会自动处理路径。
</Warning>

## 验证接入

1. 确认 [HingNet AI 控制台](https://models.hingnet.com.cn/) 中密钥有效、模型路由包含所需 Claude 型号。
2. 启动 `claude`，执行 `/status` 确认网关配置已加载。
3. 发送一条测试消息验证响应正常。

## 排错提示

<AccordionGroup>
  <Accordion icon="globe" title="仍命中 Anthropic 官方直连">
    检查环境变量是否在启动 `claude` 的同一终端中生效，或是否被用户/组织级 settings 覆盖。
  </Accordion>

  <Accordion icon="key" title="认证失败">
    若当前版本要求 `Authorization: Bearer`，尝试改用 `ANTHROPIC_AUTH_TOKEN` 承载同一令牌。
  </Accordion>

  <Accordion icon="network-wired" title="企业网络代理">
    另设 `HTTPS_PROXY` / `HTTP_PROXY`，详见 Claude Code 官方 Enterprise network configuration 文档。
  </Accordion>
</AccordionGroup>

<Note>
  旧版 npm 全局安装已弃用。若仍需在 Node 18+ 下使用：`npm install -g @anthropic-ai/claude-code`（不推荐）。
</Note>