---
title: Codex 使用教程
sidebarTitle: Codex
description: 安装 Codex 终端工具，配置无限星河AI API 地址、密钥和模型，并完成首次编程请求。
---

Codex 是一个在终端中使用的 AI 编程工具，可以读取和修改项目文件。只想聊天的用户不需要安装 Codex。

![Codex 运行界面](/images/tutorials/codex/codex-terminal.jpg)

## 安装 Codex

先安装 [Node.js](https://nodejs.org/)，再打开终端执行：

```bash
npm install -g @openai/codex
```

## 配置 API Key

Windows PowerShell：

```powershell
$env:INFISTAR_API_KEY = "你的_API_Key"
```

macOS 或 Linux：

```bash
export INFISTAR_API_KEY="你的_API_Key"
```

## 配置模型

打开 Codex 配置文件：

- Windows：`%USERPROFILE%\.codex\config.toml`
- macOS / Linux：`~/.codex/config.toml`

填入下面的内容，并替换模型 ID：

```toml
model = "模型广场中的原始模型ID"
model_provider = "infistar"

[model_providers.infistar]
name = "无限星河AI"
base_url = "https://infistar.cc/v1"
env_key = "INFISTAR_API_KEY"
wire_api = "responses"
```

## 开始使用

关闭并重新打开终端，在项目目录运行 `codex`。第一次可以输入：

```text
请只回复“配置成功”，不要读取或修改文件，也不要运行命令。
```

## 遇到问题

- **提示没有 API Key**：在当前终端重新设置 `INFISTAR_API_KEY`。
- **提示 404**：确认 `base_url` 是 `https://infistar.cc/v1`。
- **提示模型不存在**：重新复制模型广场中的原始模型 ID。
- **准备修改文件**：先查看 Codex 给出的操作和 diff，再决定是否允许。