> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cdhyzxwl.cn/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/ykQo7Ago8hPqFZru/images/Screenshot-2026-09-07-at-21-08-20.png?fit=max&auto=format&n=ykQo7Ago8hPqFZru&q=85&s=60b657860dc4c3b346759ddb879fd315" alt="Screenshot 2026 09 07 At 21 08 20" width="983" height="807" data-path="images/Screenshot-2026-09-07-at-21-08-20.png" />
           </Frame>
    3. 点击"导入"完成

           <Frame>
             <img src="https://mintcdn.com/cdhyzxwl/ykQo7Ago8hPqFZru/images/Screenshot-2026-09-07-at-21-08-41.png?fit=max&auto=format&n=ykQo7Ago8hPqFZru&q=85&s=4aab1f8bf92027837ede4e069b07fdff" alt="Screenshot 2026 09 07 At 21 08 41" width="1102" height="1018" data-path="images/Screenshot-2026-09-07-at-21-08-41.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 = "custom"
    model = "deepseek-v4-pro"
    model_reasoning_effort = "medium"
    disable_response_storage = true

    [model_providers.custom]
    name = "teio"
    base_url = "https://ai.cdhyzxwl.cn/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)。