Claude Code 接入 Global AI：CC Switch 与手动配置

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

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

安装 Claude Code

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

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

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

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

winget install Anthropic.ClaudeCode

brew install --cask claude-code

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

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

验证安装

claude --version

方式一：CC Switch（推荐）

CC Switch 是一款一键切换供应商的桌面工具，同时支持 Claude Code 与 ChatGPT(Codex)。下载地址：github.com/farion1231/cc-switch/releases。 Global AI 支持将 API 配置一键导入 CC Switch，步骤如下：

创建 API 密钥

打开 CC Switch 导入菜单

在刚创建的密钥最右侧点击「…」按钮，在下拉菜单中选择「CC Switch」。

填写导入信息

在弹出的对话框中：

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

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

确认打开 CC Switch

在浏览器弹出的对话框中确认打开 CC Switch 应用。

导入配置

在 CC Switch 中点击「导入」，等待提示导入成功。

启动 Claude Code

在项目目录输入 claude 命令即可开始使用。在对话中输入 /model 可切换 Sonnet、Opus 等模型。

验证接入状态

进入使用日志，若能看到与测试同一时间的调用记录，则代表接入成功。

方式二：手动配置

编辑 settings.json

根据操作系统找到配置文件路径（不存在请自行创建）：

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

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

settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换为您的 sk- 密钥",
    "ANTHROPIC_BASE_URL": "https://globalai.vip",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

设置环境变量

在终端执行：

环境变量

export ANTHROPIC_BASE_URL="https://globalai.vip"
export ANTHROPIC_AUTH_TOKEN="替换为您的 sk- 密钥"

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

重启并验证

重启终端后，在项目目录输入 claude 命令，发送一条测试消息，并在使用日志中确认调用记录已生成。

验证配置

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

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%

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

在 IDE 中使用

上述任一方式生效后，安装 UI 插件即可在 VS Code、Cursor、Trae 内直接与 Claude Code 对话。

安装插件

在 VS Code / Cursor / Trae 的插件商店搜索「Claude Code」，安装官方插件。

打开对话面板

打开任意项目文件，在编辑器右上角点击 Claude 图标，弹出对话框即可交互。

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

排查

调用报鉴权失败

确认使用的是 Global AI 平台创建的 sk- 密钥，且未过期。可以在 globalai.vip/keys 编辑或重新生成。

环境变量未生效

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

模型名找不到

模型 ID 可能随平台调整而更新，请以 globalai.vip/pricing 中显示的 Claude 相关模型 ID 为准。

接入准备

编程类客户端

聊天类客户端

低代码平台

Claude Code 接入 Global AI：CC Switch 与手动配置

安装 Claude Code

方式一：CC Switch（推荐）

方式二：手动配置

验证配置

在 IDE 中使用

排查

参考链接

​安装 Claude Code

​方式一：CC Switch（推荐）

​方式二：手动配置

​验证配置

​在 IDE 中使用

​排查

​参考链接

安装 Claude Code

方式一：CC Switch（推荐）

方式二：手动配置

验证配置

在 IDE 中使用

排查

参考链接