> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geekai.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Codex CLI
Codex CLI 是 OpenAI 官方推出的代理式编码工具，通过终端使用，可帮助您比以往更快地将想法转化为代码。
开始前需要确保终端已经安装过 [Node.js 18 或更高版本](https://nodejs.org/zh-cn/download/)。
安装完成后，打开终端，执行以下命令安装 Claude Code：
```bash theme={null}
npm install -g @openai/codex # Alternatively: `brew install codex`
```
安装完成后，通过 Vi 编辑器打开 Codex 的本地配置文件，配置通过极客智坊模型代理在国内使用 Codex：
```bash theme={null}
vim ~/.codex/config.toml
```
填入以下内容：
```toml theme={null}
# 填写你默认使用的模型，支持填写极客智坊所有对话模型ID
model = "gpt-5.3-codex"
# 填写你默认使用的模型提供商
model_provider = "geekai"
# 模型提供商的配置
[model_providers.geekai]
# 将在Codex用户界面中显示的提供者名称。
name = "GeekAI"
# Base URL，如果你的终端可以访问外网，可以使用海外入口 https://geekai.dev/api/v1
base_url = "https://geekai.co/api/v1"
# API KEY，用于 API 请求认证
env_key = "GEEKAI_API_KEY"
# wire_api 的有效值为 "chat" 和 "responses"。如果省略，默认为 "chat"。
wire_api = "responses"
```
配置 `model` 为 `gpt-5.3-codex` 时，必须保证 `wire_api` 设置为 `responses`，否则会报错，因为 GPT-5.3-Codex 仅支持 Response API。
注意这里的 `env_key` 必须填写为 `GEEKAI_API_KEY`，这是 Codex CLI 约定的环境变量名称，用于读取 API KEY，**不要配置成了 API KEY 的值！！！**
保存配置文件后，需要通过以下命令在环境变量中设置 API KEY 的值：
```bash theme={null}
export GEEKAI_API_KEY=
```
> 直接执行 `export` 只能当前会话生效，如果想要永久生效，可以将上述命令添加到 `~/.bashrc` 或 `~/.zshrc` 文件中，然后执行 `source ~/.bashrc` 或 `source ~/.zshrc` 来使更改生效。
记得将 `` 替换为您的[极客智坊 API 密钥](https://geekai.co/user/api_keys)，如果 Base URL 使用的是海外入口，则需要前往[极客智坊海外版](https://geekai.dev/user/api_keys)获取 API KEY。
对个人开发者而言，API KEY 使用默认均衡配置即可，如果你的项目比较大，或者想要更快地响应速度，可以到 [API Keys](https://geekai.co/user/api_keys) 管理页面通过编辑 KEY 的线路为高可用来实现更快更稳定的响应速度：
如果你对价格比较敏感，同时对接口稳定性要求不高，可以选择将 API KEY 的线路切换为低价渠道。
配置完成后保存文件，即可在终端中输入 `codex` 命令来启动 OpenAI Codex CLI：
```bash theme={null}
codex
```
Codex CLI 不需要做任何配置，当进入正式交互界面后，你就可以直接与 OpenAI Codex 进行对话，获取代码建议或解决编程问题：
