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

# OpenAI Codex 接入 Global AI：CC Switch 与手动配置

> 在 OpenAI Codex CLI 中接入 Global AI，通过 CC Switch 一键切换或手动编辑 config.toml 与 auth.json。

Codex 是 OpenAI 的命令行编程助手。桌面端下载地址：[openai.com/zh-Hans-CN/codex](https://openai.com/zh-Hans-CN/codex/)。以下两种方式任选其一。

<Warning>
  Codex 配置文件中的密钥必须使用 **Codex 分组** 的令牌。在 [/keys](https://globalai.vip/keys) 创建令牌时请选择 codex 分组。
</Warning>

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

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

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

  <Step title="填写供应商信息">
    按下方内容填写，其他保持默认：

    * **供应商名称**：`globalai`
    * **官网链接**：`https://globalai.vip`
    * **API Key**：粘贴你在 [/keys](https://globalai.vip/keys) 创建的 codex 分组令牌
    * **API 请求地址**：`https://globalai.vip/v1`
    * **模型名称**：`gpt-5.5`、`gpt-5.4` 或 `gpt-5.3-codex`
  </Step>

  <Step title="启动供应商">
    保存后回到列表，点击刚添加的「globalai」右侧的启动按钮即可生效。
  </Step>
</Steps>

## 方式二：手动配置

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

    ```bash 安装 Codex icon=terminal theme={null}
    npm install -g @openai/codex
    ```
  </Step>

  <Step title="编辑 config.toml">
    路径：

    * **Windows**：`C:\Users\你的用户名\.codex\config.toml`
    * **macOS / Linux**：`~/.codex/config.toml`

    ```toml config.toml icon=file-code theme={null}
    model_provider = "globalai"
    model = "gpt-5.4"
    model_reasoning_effort = "high"
    disable_response_storage = true


    [model_providers.globalai]
    name = "globalai"
    base_url = "https://globalai.vip/v1"
    wire_api = "responses"
    requires_openai_auth = true
    ```
  </Step>

  <Step title="编辑 auth.json">
    路径：

    * **Windows**：`C:\Users\你的用户名\.codex\auth.json`
    * **macOS / Linux**：`~/.codex/auth.json`

    文件不存在请自行创建：

    ```json auth.json icon=file-code theme={null}
    {
      "OPENAI_API_KEY": "替换为您的 codex 分组 API Key"
    }
    ```
  </Step>

  <Step title="切换模型 / 启动">
    在终端执行下面的命令进入指定模型：

    ```bash 切换模型 icon=terminal theme={null}
    codex -m gpt-5.4
    ```
  </Step>
</Steps>

## 在 VS Code 中使用

上述任一方式生效后，在 VS Code 扩展市场安装官方 Codex 插件，即可在 IDE 中调用。

## 排查

<AccordionGroup>
  <Accordion title="调用报鉴权失败">
    确认使用的是 **codex 分组** 令牌，而非普通令牌。可以在 [/keys](https://globalai.vip/keys) 编辑令牌查看其分组。
  </Accordion>

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


## Related topics

- [Global AI 客户端接入总览：常用参数与选型](/clients/overview.md)
- [OpenCode 与 CC-Switch 接入 Global AI 指南](/clients/opencode.md)
- [ChatBox 接入 Global AI：桌面与手机端配置](/clients/chatbox.md)
- [Claude Code 接入 Global AI：Windows、macOS 与 Linux 配置](/clients/claude-code.md)
- [ChatWise 接入 Global AI：多提供商统一配置指南](/clients/chatwise.md)