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

# Codex 配置

> 安装并配置 Codex 以使用 gogogotoken API

本页介绍多种安装 Codex 的方式，选择适合你的即可。

<Info>
  官方地址：[https://developers.openai.com/codex/cli](https://developers.openai.com/codex/cli)
</Info>

## 方式一：Codex CLI

<Tabs>
  <Tab title="macOS / Linux">
    打开终端，执行：

    ```bash theme={null}
    curl -fsSL https://chatgpt.com/codex/install.sh | sh
    ```

    非交互式安装：

    ```bash theme={null}
    curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh
    ```
  </Tab>

  <Tab title="Windows">
    打开 PowerShell：

    ```powershell theme={null}
    powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
    ```
  </Tab>

  <Tab title="NPM">
    ```bash theme={null}
    npm install -g @openai/codex
    ```
  </Tab>

  <Tab title="Homebrew">
    ```bash theme={null}
    brew install --cask codex
    ```
  </Tab>
</Tabs>

## 方式二：VSCode 插件

如果使用 VSCode，可以直接安装官方插件：

* [在 VS Marketplace 中打开](https://marketplace.visualstudio.com/items?itemName=openai.chatgpt)
* 或在 VSCode 扩展中心搜索 `codex` 进行安装

<Frame>
  <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/vscode-codex.png?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=284f89451db1e74956d569789782ef89" alt="Vscode Codex" width="2872" height="1826" data-path="images/vscode-codex.png" />
</Frame>

## 方式三：Codex App

如果你还没安装 `Codex App`，可以从这里下载：\
[https://developers.openai.com/codex/quickstart?setup=app](https://developers.openai.com/codex/quickstart?setup=app)

## 配置 API

如果你希望通过 `CC Switch` 直接把 `gogogotoken` 的 Codex 配置导入到本地客户端，可以按下面步骤操作。

## 打开配置目录

打开 `终端` 程序，根据不同系统，运行下面的命令，打开 Codex 的配置文件夹：

<Columns cols={2}>
  <Column>
    Windows

    ```shellscript theme={null}
    start "" "%USERPROFILE%\.codex"
    ```
  </Column>

  <Column>
    MacOs

    ```shellscript theme={null}
    open "$HOME/.codex"
    ```
  </Column>
</Columns>

<Note>
  如果你的网关提供了专用的环境变量或配置项，请优先按照控制台说明填写。 常见做法是设置 API Base URL、API Key 和默认模型，然后在 Codex 中验证连通性。
</Note>

如果你希望通过 `CC Switch` 直接把 `gogogotoken` 的 Codex 配置导入到本地客户端，可以按下面步骤操作。

## 打开配置目录

打开 `终端` 程序，根据不同系统，运行下面的命令，打开 Codex 的配置文件夹：

<Columns cols={2}>
  <Column>
    Windows

    ```shellscript theme={null}
    start "" "%USERPROFILE%\.codex"
    ```
  </Column>

  <Column>
    macOS

    ```shellscript theme={null}
    open "$HOME/.codex"
    ```
  </Column>
</Columns>

## 使用 CC Switch 导入 Codex 配置

<Steps>
  <Step title="在令牌管理中选择对应令牌并打开 CC Switch">
    安装好 `CC Switch` 之后，进入令牌管理页面，先找到你要给 `Codex` 使用的令牌。

    然后点击这一行右侧的 `聊天` 下拉菜单，选择 `CC Switch`，系统会唤起本地的 `CC Switch` 配置流程。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/codex-cc-switch-enabled.png?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=256e7be2a25d0ecd92cbe24ac7efb3e3" alt="Codex 配置已启用" width="3004" height="1410" data-path="images/codex/codex-cc-switch-enabled.png" />
    </Frame>
  </Step>

  <Step title="选择导入目标为 Codex 并指定模型">
    在弹出的窗口里，把导入目标切换到 `Codex`。

    接着在模型选择框中，选择你希望导入到 `Codex` 里的默认模型，然后点击 `打开 CC Switch`。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/codex-cc-switch-entry.png?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=3d93272f3f9e7737d4099baf13153787" alt="令牌管理中选择 CC Switch" width="1916" height="944" data-path="images/codex/codex-cc-switch-entry.png" />
    </Frame>
  </Step>

  <Step title="确认供应商配置并点击导入">
    `CC Switch` 会展示一份待导入的配置摘要，你需要重点确认这几项信息：

    * 应用类型是否为 `Codex`
    * API 端点是否为 `https://gogogotoken.ai/v1`
    * API 密钥是否为当前令牌
    * 模型是否为你刚才选定的模型

    确认无误后，点击右下角的 `导入`。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/codex-cc-switch-select-model.png?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=bfad673a91bb76e47ff50073bdcf2f05" alt="选择 Codex 和模型" width="2000" height="1300" data-path="images/codex/codex-cc-switch-select-model.png" />
    </Frame>
  </Step>

  <Step title="在 CC Switch 中确认 Codex 已启用">
    导入完成后，切换到 `CC Switch` 顶部的 `Codex` 图标页签。

    如果配置成功，你会看到刚导入的供应商出现在列表中，并显示为 `使用中`。这说明 `Codex` 已经切换到当前配置。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/codex-cc-switch-import-confirm.png?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=335e13510a949f4b64201d3d0d8054fd" alt="确认导入 Codex 配置" width="2000" height="1300" data-path="images/codex/codex-cc-switch-import-confirm.png" />
    </Frame>
  </Step>

  <Step title="在 Codex 中检查配置是否生效">
    回到 `Codex` 客户端，在会话中输入 `/status`。

    如果配置成功，状态面板里的 `Model provider` 会显示为你的自定义供应商，例如 `My Codex - https://gogogotoken.ai/v1`；同时 `Model` 一项会显示你刚才导入的模型。

    如果这里仍然显示默认供应商，建议先重启 `Codex` 客户端，再重新执行一次检查。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/codex-status-provider-check.png?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=10eeb04883cc97dbc13228f34d463270" alt="检查 Codex 当前供应商配置" width="1140" height="976" data-path="images/codex/codex-status-provider-check.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  如果你修改了模型、供应商或令牌映射，建议重启 `Codex` 客户端后再测试，避免旧配置仍然驻留在当前会话中。
</Warning>

## 使用 CC Switch 导入 Codex 配置

<Steps>
  <Step title="在令牌管理中选择对应令牌并打开 CC Switch">
    安装好 `CC Switch` 之后，进入令牌管理页面，先找到你要给 `Codex` 使用的令牌。

    然后点击这一行右侧的 `聊天` 下拉菜单，选择 `CC Switch`，系统会唤起本地的 `CC Switch` 配置流程。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/codex-cc-switch-enabled.png?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=256e7be2a25d0ecd92cbe24ac7efb3e3" alt="Codex 配置已启用" width="3004" height="1410" data-path="images/codex/codex-cc-switch-enabled.png" />
    </Frame>
  </Step>

  <Step title="选择导入目标为 Codex 并指定模型">
    在弹出的窗口里，把导入目标切换到 `Codex`。

    接着在模型选择框中，选择你希望导入到 `Codex` 里的默认模型，然后点击 `打开 CC Switch`。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/codex-cc-switch-entry.png?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=3d93272f3f9e7737d4099baf13153787" alt="令牌管理中选择 CC Switch" width="1916" height="944" data-path="images/codex/codex-cc-switch-entry.png" />
    </Frame>
  </Step>

  <Step title="确认供应商配置并点击导入">
    `CC Switch` 会展示一份待导入的配置摘要，你需要重点确认这几项信息：

    * 应用类型是否为 `Codex`
    * API 端点是否为 `https://gogogotoken.ai`
    * API 密钥是否为当前令牌
    * 模型是否为你刚才选定的模型

    确认无误后，点击右下角的 `导入`。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/codex-cc-switch-select-model.png?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=bfad673a91bb76e47ff50073bdcf2f05" alt="选择 Codex 和模型" width="2000" height="1300" data-path="images/codex/codex-cc-switch-select-model.png" />
    </Frame>
  </Step>

  <Step title="在 CC Switch 中确认 Codex 已启用">
    导入完成后，切换到 `CC Switch` 顶部的 `Codex` 图标页签。

    如果配置成功，你会看到刚导入的供应商出现在列表中，并显示为 `使用中`。这说明 `Codex` 已经切换到当前配置。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/codex-cc-switch-import-confirm.png?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=335e13510a949f4b64201d3d0d8054fd" alt="确认导入 Codex 配置" width="2000" height="1300" data-path="images/codex/codex-cc-switch-import-confirm.png" />
    </Frame>
  </Step>

  <Step title="在 Codex 中检查配置是否生效">
    回到 `Codex` 客户端，在会话中输入 `/status`。

    如果配置成功，状态面板里的 `Model provider` 会显示为你的自定义供应商，例如 `My Codex - https://gogogotoken.ai`；同时 `Model` 一项会显示你刚才导入的模型。

    如果这里仍然显示默认供应商，建议先重启 `Codex` 客户端，再重新执行一次检查。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/codex-status-provider-check.png?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=10eeb04883cc97dbc13228f34d463270" alt="检查 Codex 当前供应商配置" width="1140" height="976" data-path="images/codex/codex-status-provider-check.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  如果你修改了模型、供应商或令牌映射，建议重启 `Codex` 客户端后再测试，避免旧配置仍然驻留在当前会话中。
</Warning>