> ## 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：CC Switch 与手动配置

> 在 Claude Code CLI 中接入 Global AI，通过 CC Switch 一键切换或手动配置环境变量与 settings.json。

Claude Code 是 Anthropic 官方的命令行编程助手。本页面说明如何把它接入 Global AI，替代直连官方 API。官方文档：[docs.anthropic.com/zh-CN/docs/claude-code](https://docs.anthropic.com/zh-CN/docs/claude-code/quickstart)。

<Note>
  以下两种方式任选其一：**CC Switch** 适合桌面端图形化操作，**手动配置** 适合熟悉命令行与配置文件的用户。
</Note>

## 安装 Claude Code

推荐使用官方原生安装脚本，无需手动安装 Node.js。根据操作系统选择对应命令：

<CodeGroup>
  ```bash macOS / Linux / WSL icon=terminal theme={null}
  curl -fsSL https://claude.ai/install.sh | bash
  ```

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

  ```bat Windows CMD icon=windows theme={null}
  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  ```

  ```bash Windows winget icon=windows theme={null}
  winget install Anthropic.ClaudeCode
  ```

  ```bash macOS Homebrew icon=apple theme={null}
  brew install --cask claude-code
  ```
</CodeGroup>

<Tip>
  `npm install -g @anthropic-ai/claude-code` 已被官方标记为**弃用**，建议使用上面的原生安装方式。Windows 用户建议同时安装 **Git for Windows**，以便 Claude Code 使用 Bash 工具。
</Tip>

安装完成后可用以下命令验证：

```bash 验证安装 icon=terminal theme={null}
claude --version
```

## 方式一：CC Switch（推荐）

CC Switch 是一款一键切换供应商的桌面工具，同时支持 Claude Code 与 ChatGPT(Codex)。下载地址：[github.com/farion1231/cc-switch/releases](https://github.com/farion1231/cc-switch/releases)。

Global AI 支持将 API 配置一键导入 CC Switch，步骤如下：

<Steps>
  <Step title="创建 API 密钥">
    登录 Global AI 平台，在左侧菜单进入「API 密钥」，或直接打开 [globalai.vip/keys](https://globalai.vip/keys)，创建一个「Claude」分组的 `sk-` 开头的密钥。
  </Step>

  <Step title="打开 CC Switch 导入菜单">
    在刚创建的密钥最右侧点击「...」按钮，在下拉菜单中选择「CC Switch」。
  </Step>

  <Step title="填写导入信息">
    在弹出的对话框中：

    * **应用**：选择 `Claude Code`
    * **名称**：按需自定义
    * **主模型**：选择 `claude-sonnet-5`（或按需切换 Opus 等更强模型）

    确认无误后点击底部的「打开 CC Switch」。
  </Step>

  <Step title="确认打开 CC Switch">
    在浏览器弹出的对话框中确认打开 CC Switch 应用。
  </Step>

  <Step title="导入配置">
    在 CC Switch 中点击「导入」，等待提示导入成功。
  </Step>

  <Step title="启动 Claude Code">
    在项目目录输入 `claude` 命令即可开始使用。在对话中输入 `/model` 可切换 Sonnet、Opus 等模型。
  </Step>

  <Step title="验证接入状态">
    进入 [使用日志](https://globalai.vip/usage-logs/common)，若能看到与测试同一时间的调用记录，则代表接入成功。
  </Step>
</Steps>

## 方式二：手动配置

<Steps>
  <Step title="编辑 settings.json">
    根据操作系统找到配置文件路径（不存在请自行创建）：

    * **Windows**：`%USERPROFILE%\.claude\settings.json`
    * **macOS / Linux**：`~/.claude/settings.json`

    写入以下内容（把 `ANTHROPIC_AUTH_TOKEN` 替换为你的 `sk-` 密钥）：

    ```json 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` 命令，发送一条测试消息，并在 [使用日志](https://globalai.vip/usage-logs/common) 中确认调用记录已生成。
  </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>

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

## 在 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>

## 排查

<AccordionGroup>
  <Accordion title="调用报鉴权失败">
    确认使用的是 Global AI 平台创建的 `sk-` 密钥，且未过期。可以在 [globalai.vip/keys](https://globalai.vip/keys) 编辑或重新生成。
  </Accordion>

  <Accordion title="环境变量未生效">
    修改 `~/.zshrc`、`~/.bashrc` 或系统环境变量后，务必 **重启终端**。可通过「验证配置」章节的命令确认是否已生效。
  </Accordion>

  <Accordion title="模型名找不到">
    模型 ID 可能随平台调整而更新，请以 [globalai.vip/pricing](https://globalai.vip/pricing) 中显示的 Claude 相关模型 ID 为准。
  </Accordion>
</AccordionGroup>

## 参考链接

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


## Related topics

- [ChatGPT(Codex) 接入 Global AI：CC Switch 与手动配置](/zh/clients/codex.md)
- [OpenCode 与 CC-Switch 接入 Global AI 指南](/zh/clients/opencode.md)
- [Global AI 客户端接入总览：常用参数与选型](/zh/clients/overview.md)
- [ChatBox 接入 Global AI：桌面与手机端配置](/zh/clients/chatbox.md)
- [Cline、Roo Code 接入 Global AI 指南](/zh/clients/coding-agents.md)