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

# Claude Code 接入 Global AI：Windows、macOS 与 Linux 配置

> 在官方 Claude Code CLI 中接入 Global AI，支持 Windows 一键脚本、macOS 与 Linux 手动配置，以及 IDE UI 插件。

Claude Code 是 Anthropic 官方的命令行编程助手。本页面说明如何把它接入 Global AI，替代直连官方 API。

<Warning>
  Claude Code 属于 Agent 类工具，运行时会持续消耗大量 Token。请先阅读 [接入总览的费用提示](/clients/overview#关于-claude-模型费用)，并在 [日志](/usage/logs) 中留意消耗。
</Warning>

<Note>
  如需在 Claude Code 中使用 Qwen、DeepSeek、GLM、Kimi、MiniMax 等国内模型，请联系客服获取专用教程。
</Note>

## 前置条件

<Steps>
  <Step title="安装 Node.js 与 Git">
    确保本机已安装 Node.js 与 Git。未安装时请先从各自官网下载安装。
  </Step>

  <Step title="安装 Claude Code">
    在终端执行：

    ```bash 安装 Claude Code icon=terminal theme={null}
    npm install -g @anthropic-ai/claude-code
    claude --version
    ```
  </Step>
</Steps>

## Windows：一键脚本（推荐）

<Steps>
  <Step title="下载脚本">
    使用 **Edge 浏览器** 下载 [一键配置脚本](http://static.globalai.vip/claude/claude%20code%E4%B8%80%E9%94%AE%E8%AE%BE%E7%BD%AE%E5%B7%A5%E5%85%B7.bat)。脚本为开源代码，可放心运行。
  </Step>

  <Step title="运行脚本">
    双击下载的 `.bat` 文件运行。
  </Step>

  <Step title="粘贴密钥">
    将 [你的 `sk-` 密钥](https://globalai.vip/keys) 粘贴到命令行，按回车即可完成设置。
  </Step>

  <Step title="使用 Claude Code">
    重启命令行终端后，在项目目录输入 `claude` 即可开始使用。在对话中输入 `/model` 可切换到 Opus 等更强模型。
  </Step>
</Steps>

<Tip>
  不想使用脚本时，可参考下方 macOS / Linux 的方法在 Windows 上手动配置：把 `~/.claude/settings.json` 换成 `%USERPROFILE%\.claude\settings.json`。
</Tip>

## macOS 与 Linux 配置

<Steps>
  <Step title="创建配置文件">
    创建 `~/.claude/settings.json`，内容如下（把 `ANTHROPIC_AUTH_TOKEN` 替换为你的密钥）：

    ```json ~/.claude/settings.json icon=file-code theme={null}
    {
      "env": {
        "ANTHROPIC_AUTH_TOKEN": "替换为您的 sk- 密钥",
        "ANTHROPIC_BASE_URL": "https://globalai.vip",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
      },
      "permissions": {
        "allow": [],
        "deny": []
      }
    }
    ```
  </Step>

  <Step title="设置环境变量">
    在终端执行：

    ```bash 环境变量 icon=terminal theme={null}
    export ANTHROPIC_BASE_URL="https://globalai.vip"
    export ANTHROPIC_AUTH_TOKEN="替换为您的 sk- 密钥"
    ```

    <Tip>
      为了每次开启终端都生效，可以把上面两条 `export` 语句写入 `~/.zshrc` 或 `~/.bashrc`。
    </Tip>
  </Step>

  <Step title="启动 Claude Code">
    在项目目录输入 `claude` 命令即可开始使用。
  </Step>
</Steps>

## 验证配置

在终端执行以下命令，能输出 `https://globalai.vip` 即代表环境变量已生效：

<CodeGroup>
  ```bash macOS / Linux icon=terminal theme={null}
  echo $ANTHROPIC_BASE_URL
  echo $ANTHROPIC_AUTH_TOKEN
  ```

  ```powershell Windows PowerShell icon=windows theme={null}
  echo $env:ANTHROPIC_BASE_URL
  echo $env:ANTHROPIC_AUTH_TOKEN
  ```

  ```bat Windows CMD icon=windows theme={null}
  echo %ANTHROPIC_BASE_URL%
  echo %ANTHROPIC_AUTH_TOKEN%
  ```
</CodeGroup>

修改配置后，**重启终端** 才会生效。

## 更新 Claude Code

```bash 更新 CLI icon=terminal theme={null}
# 卸载旧版本
npm uninstall -g @anthropic-ai/claude-code

# 安装最新版本
npm install -g @anthropic-ai/claude-code

# 查看版本号
claude --version
```

## 在 IDE 中使用（可选）

安装 UI 插件后可以在 VS Code、Cursor、Trae 内直接与 Claude Code 对话。

<Steps>
  <Step title="安装插件">
    在 VS Code / Cursor / Trae 的插件商店搜索「Claude Code」，安装官方插件。
  </Step>

  <Step title="打开对话面板">
    打开任意项目文件，在编辑器右上角点击 Claude 图标，弹出对话框即可交互。
  </Step>
</Steps>

<Note>
  Cursor 和 Trae 都不能直接把 Global AI 密钥填入模型密钥配置，但都可以通过安装 Claude Code 的方式接入并使用 Agent 功能。
</Note>

## 参考链接

* [Claude Code 官方中文文档](https://docs.anthropic.com/zh-CN/docs/claude-code/quickstart)
* [Global AI 模型定价](https://globalai.vip/pricing)


## Related topics

- [OpenAI Codex 接入 Global AI：CC Switch 与手动配置](/clients/codex.md)
- [Global AI 客户端接入总览：常用参数与选型](/clients/overview.md)
- [OpenCode 与 CC-Switch 接入 Global AI 指南](/clients/opencode.md)
- [Cline、Roo Code、WorkBuddy 接入 Global AI 指南](/clients/coding-agents.md)
- [Cherry Studio 接入 Global AI：Claude、GPT、Gemini 配置](/clients/cherry-studio.md)