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

# Codex VS Code 插件

> 在 VS Code 中复用 Codex CLI 的 4096bytes 配置

Codex VS Code 插件可以复用 Codex CLI 的本机配置。你需要先按 Codex CLI 页面写入 `config.toml` 和 `auth.json`，再安装 Codex 的 VS Code 插件。

如果你已经按 [Codex](/clients/codex) 页面完成配置，可以直接安装插件并重启 VS Code。无需重新创建 API Key。

## 准备工作

* 已完成 [创建账号](/quickstart/create-account)。
* 已完成 [获取 API Key](/quickstart/get-api-key)。
* 已安装 VS Code。
* 已按 [Codex](/clients/codex) 页面完成 Codex CLI 配置。
* 已从控制台打开目标 API Key 的 **使用密钥** 弹窗。

<Warning>
  `auth.json` 中的 API Key 是明文保存的本机凭证。不要把 `~/.codex/auth.json`、截图或终端输出提交到仓库，也不要发到聊天工具里。
</Warning>

## 安装 Codex CLI 配置

先完成 [Codex CLI 配置](/clients/codex)。这一步会把 4096bytes 的接入参数写入 Codex 的本机配置目录。

| 系统            | `config.toml`                      | `auth.json`                      |
| ------------- | ---------------------------------- | -------------------------------- |
| macOS / Linux | `~/.codex/config.toml`             | `~/.codex/auth.json`             |
| Windows       | `%USERPROFILE%\.codex\config.toml` | `%USERPROFILE%\.codex\auth.json` |

`model`、`review_model`、`base_url` 和 API Key 都以控制台显示为准。字段含义见 [Codex](/clients/codex) 页面。

如果你在 WSL 中使用 VS Code Remote - WSL，请把配置写入 WSL 用户目录下的 `~/.codex/`。

## 安装 VS Code 插件

<Steps>
  <Step title="打开 VS Code 扩展面板">
    在 VS Code 中打开 **Extensions** 面板。
  </Step>

  <Step title="安装 Codex 插件">
    搜索 OpenAI 发布的 Codex 插件，并点击 **Install**。
  </Step>

  <Step title="重启 VS Code">
    安装完成后关闭所有 VS Code 窗口，再重新打开项目。
  </Step>

  <Step title="使用 Codex">
    在 VS Code 中打开 Codex 插件入口。插件会读取本机 Codex 配置。
  </Step>
</Steps>

## 验证

打开一个本地项目，在 VS Code 的 Codex 插件里发送一个低风险任务：

```text theme={null}
请用一句话说明当前项目用途，不要修改文件。
```

如果插件可以正常回复，并且没有认证失败或找不到模型的错误，说明配置已生效。

## 常见问题

<AccordionGroup>
  <Accordion title="我已经配置过 Codex CLI，还需要重复配置吗？">
    不需要。Codex VS Code 插件读取同一套 `~/.codex/` 配置。安装插件后重启 VS Code 即可。
  </Accordion>

  <Accordion title="插件仍然使用旧模型或旧地址">
    确认新的配置放在 `config.toml` 文件开头。保存后关闭所有 VS Code 窗口，再重新打开。
  </Accordion>

  <Accordion title="插件报认证失败">
    检查 `auth.json` 是否是合法 JSON。确认 API Key 没有漏字符、换行或多余空格。
  </Accordion>

  <Accordion title="Remote - WSL 配置后不生效">
    如果项目运行在 WSL 环境，配置 WSL 的 `~/.codex/`，不要只改 Windows 的 `%USERPROFILE%\.codex\`。
  </Accordion>
</AccordionGroup>