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

# Codex VS Code

> 在 VS Code 中配置 Teio API 使用 Codex 扩展

> Codex 提供了 VS Code 扩展，让你可以直接在编辑器中使用 AI 编程功能。

## 前置条件

* 已 [创建 API 密钥](/create-token)
* 已安装 VS Code
* 已安装并能在终端中正常运行 [Codex CLI](/agents/codex-cli)

## 安装扩展

1. 打开 VS Code
2. 进入扩展市场（macOS：`Cmd+Shift+X` / Windows：`Ctrl+Shift+X`）
3. 搜索 `Codex` 并安装 OpenAI 官方的 Codex 扩展

<Frame>
  <img src="https://mintcdn.com/cdhyzxwl/_AgRGP7xq73J3lmh/images/macshot-clipboard-6DAB5D4D-51E4-4199-A84F-56855D946497.png?fit=max&auto=format&n=_AgRGP7xq73J3lmh&q=85&s=744ca8c3dc28cf4ef73fbf10063216e2" alt="Macshot Clipboard 6DAB5D4D 51E4 4199 A84F 56855D946497" width="1927" height="756" data-path="images/macshot-clipboard-6DAB5D4D-51E4-4199-A84F-56855D946497.png" />
</Frame>

## 配置

Codex Vscode与 CLI 共享配置文件，如果你已经配置过 Codex CLI，vscode会自动读取，无需重复配置。

<Tabs>
  <Tab title="一站式导入（推荐）">
    通过 Teio 站点一键导入，无需手动复制 Key 和地址。需要先安装 [CC Switch](/cc-switch)。

    1. 打开 Teio **密钥**页面，点击密钥右侧下拉按钮，选择 **"CC 切换"**

    <Frame>
      <img src="https://mintcdn.com/cdhyzxwl/6LIm8QzGL-MXydIR/images/macshot-clipboard-CFC10349-AF02-4AF4-A24F-3E93D9BDB544.png?fit=max&auto=format&n=6LIm8QzGL-MXydIR&q=85&s=f2aea52777e880ace76720ce796309ed" alt="Macshot Clipboard CFC10349 AF02 4AF4 A24F 3E93D9BDB544" width="662" height="483" data-path="images/macshot-clipboard-CFC10349-AF02-4AF4-A24F-3E93D9BDB544.png" />
    </Frame>

    2. CC Switch 自动打开导入面板，补充供应商名称并选择模型
           <Frame>
             <img src="https://mintcdn.com/cdhyzxwl/6LIm8QzGL-MXydIR/images/macshot-clipboard-D049F5F7-E73D-4FB2-B331-9AC60DE78E46.png?fit=max&auto=format&n=6LIm8QzGL-MXydIR&q=85&s=ff3309b902a00bb6790377c740eed721" alt="Macshot Clipboard D049F5F7 E73D 4FB2 B331 9AC60DE78E46" width="1117" height="754" data-path="images/macshot-clipboard-D049F5F7-E73D-4FB2-B331-9AC60DE78E46.png" />
           </Frame>
    3. 点击"导入"完成
           <Frame>
             <img src="https://mintcdn.com/cdhyzxwl/6LIm8QzGL-MXydIR/images/macshot-clipboard-E4634FEA-AF0C-4CFC-B541-B90F73CF4B90.png?fit=max&auto=format&n=6LIm8QzGL-MXydIR&q=85&s=8f0122429514c4748065756f11308d5a" alt="Macshot Clipboard E4634FEA AF0C 4CFC B541 B90F73CF4B90" width="1159" height="1039" data-path="images/macshot-clipboard-E4634FEA-AF0C-4CFC-B541-B90F73CF4B90.png" />
           </Frame>
  </Tab>

  <Tab title="手动配置">
    创建 `~/.codex/config.toml` 和 `~/.codex/auth.json`（Windows 路径为 `C:\Users\<用户名>\.codex\`）。

    ```bash theme={null}
    mkdir -p ~/.codex
    ```

    `config.toml`：

    ```toml theme={null}
    model_provider = "teio"
    model = "gpt-5.5"
    model_reasoning_effort = "medium"
    disable_response_storage = true

    [model_providers.teio]
    name = "teio"
    base_url = "https://teio.me/v1"
    wire_api = "responses"
    requires_openai_auth = true
    web_search = "live"
    ```

    `auth.json`：

    ```json theme={null}
    {
      "OPENAI_API_KEY": "你的密钥"
    }
    ```
  </Tab>
</Tabs>

## 使用

1. 确认终端中可以正常运行 `codex`
2. 在项目目录中执行 `code .` 打开 VS Code
3. 在 VS Code 侧边栏打开 Codex
4. 在对话框中输入你的编程需求

<Frame>
  <img src="https://mintcdn.com/cdhyzxwl/E8RJN0HfmbbPgk9f/images/macshot-clipboard-08C8C96D-5FEC-4045-95E8-4DA918B71E96.png?fit=max&auto=format&n=E8RJN0HfmbbPgk9f&q=85&s=f2f35289f9d011711db42c37434550b7" alt="Macshot Clipboard 08C8C96D 5FEC 4045 95E8 4DA918B71E96" width="2940" height="1664" data-path="images/macshot-clipboard-08C8C96D-5FEC-4045-95E8-4DA918B71E96.png" />
</Frame>

## 常见问题

<AccordionGroup>
  <Accordion title="VS Code 扩展加载很慢">
    VS Code 扩展首次加载可能较慢，请耐心等待。

    扩展依赖终端中的 `codex` 命令。建议先在终端中运行 `codex`，确认可以正常使用，再通过终端执行 `code .` 打开 VS Code，等待扩展自动加载完成。
  </Accordion>
</AccordionGroup>

遇到其他问题？请参考 [常见问题](/faq)。