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

# OpenCode 与 CC-Switch 接入 Global AI 指南

> 在 OpenCode 中通过配置文件切换 Anthropic Base URL，或用 CC-Switch 一键管理多个 Claude Code 供应商。

OpenCode 与 CC-Switch 都是围绕命令行编程助手打造的工具。OpenCode 是独立 CLI，CC-Switch 是一款方便地在多个 Claude Code 供应商之间切换的桌面工具。

## OpenCode

[OpenCode 官方文档](https://opencode.ai/docs/) 提供了完整参考，本页只列出接入 Global AI 所需的关键步骤。

<Steps>
  <Step title="安装 OpenCode">
    使用 npm 安装：

    ```bash 安装 OpenCode icon=terminal theme={null}
    npm install -g opencode-ai
    ```
  </Step>

  <Step title="配置提供商 Base URL">
    编辑 `~/.config/opencode/opencode.json`（文件不存在则新建）：

    ```json ~/.config/opencode/opencode.json icon=file-code theme={null}
    {
      "$schema": "https://opencode.ai/config.json",
      "provider": {
        "anthropic": {
          "options": {
            "baseURL": "https://globalai.vip/v1"
          }
        }
      }
    }
    ```

    <Note>
      `~` 代表用户目录，例如 Windows 上是 `C:\Users\你的用户名`。
    </Note>
  </Step>

  <Step title="配置密钥">
    编辑 `~/.local/share/opencode/auth.json`，把 `anthropic.key` 替换为你的 `sk-` 密钥（建议在 [/keys](https://globalai.vip/keys) 创建 claude code 分组的密钥）：

    ```json ~/.local/share/opencode/auth.json icon=file-code theme={null}
    {
      "anthropic": {
        "type": "api",
        "key": "sk-xxxxxxxxxxxxx"
      }
    }
    ```
  </Step>

  <Step title="选择模型并使用">
    打开终端运行 `opencode`，输入 `/models`，从列表中选择一个 Anthropic 模型（如 `claude-sonnet-4-5`），即可开始对话。
  </Step>
</Steps>

### UI 配置方式

如果不想手动编辑文件，可在 OpenCode 的图形界面里进入设置，切换 Provider 为 Anthropic，Base URL 填 `https://globalai.vip/v1`，API Key 填你的令牌；返回主界面在下方模型选择器中选择目标模型即可。

## CC-Switch

CC-Switch 用来在多个 Claude Code / Codex 供应商之间快速切换。下载地址：[github.com/farion1231/cc-switch/releases](https://github.com/farion1231/cc-switch/releases)。

<Steps>
  <Step title="新增供应商">
    打开 CC-Switch 主界面，切换到 **Claude Code** 栏目，点击左上角的「+」新增。
  </Step>

  <Step title="填写 Global AI 信息">
    * **供应商名称**：`全球AI`
    * **官网链接**：`https://globalai.vip`
    * **API Key**：粘贴你在 [/keys](https://globalai.vip/keys) 复制的 `sk-` 密钥
    * **请求地址**：`https://globalai.vip`

    其他字段留空保持默认，点击右下角「保存」。
  </Step>

  <Step title="启动供应商">
    在列表中找到刚添加的「全球AI」，点击「启动」即可切换到 Global AI。
  </Step>
</Steps>

<Tip>
  Codex 用户请参考 [Codex 接入指南](/clients/codex) 中的 CC Switch 章节，它对应的是 Codex 栏目而非 Claude Code 栏目。
</Tip>

## 排查

<AccordionGroup>
  <Accordion title="OpenCode 里模型列表没有 Anthropic">
    检查 `opencode.json` 是否放在了正确路径，并确认 `auth.json` 中的 `anthropic.key` 已填入有效密钥。修改后重启 OpenCode。
  </Accordion>

  <Accordion title="CC-Switch 切换后仍连接不上">
    确认已完全退出 Claude Code 终端后重新启动。CC-Switch 只在下一次启动 Claude Code 时读取新配置。
  </Accordion>
</AccordionGroup>


## Related topics

- [OpenAI Codex 接入 Global AI：CC Switch 与手动配置](/clients/codex.md)
- [Global AI 客户端接入总览：常用参数与选型](/clients/overview.md)
- [Cline、Roo Code、WorkBuddy 接入 Global AI 指南](/clients/coding-agents.md)
- [ChatWise 接入 Global AI：多提供商统一配置指南](/clients/chatwise.md)
- [Claude Code 接入 Global AI：Windows、macOS 与 Linux 配置](/clients/claude-code.md)