跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
一、产品简介

Codex 是 OpenAI 官方推出的终端编程 Agent，专为代码生成、代码审查与复杂工程任务设计。通过 GravitexAI（兼容 OpenAI 接口）你可以：

统一接入

通过单一 API Key 访问 GPT-5.5 / 5.4 / 5.4-Pro 等 GPT 全家族模型

Responses API

内置 wire_api = "responses" 支持，自动适配新一代 GPT 模型

高可用

分布式基础设施，自动故障转移，国内访问稳定

按量计费

无需订阅，按 token 计费，比官方更具性价比

​
二、前置条件

  • 在你的机器上已安装 Codex CLI（请按照 Codex 官方说明安装）
  • 已在 GravitexAI 控制台 创建 API Key（格式 sk-xxxxxxxxxx）
Base URL：https://api.gravitex.ai/v1 —— 必须以 /v1 结尾。

​
三、快速配置

Codex 通过 TOML 配置文件指定模型供应商。环境变量在自定义供应商场景下可能不稳定，推荐直接写入 TOML 配置。

​
1. 编辑 ~/.codex/config.toml

1

打开配置文件

# macOS / Linux
nano ~/.codex/config.toml

# Windows
notepad %USERPROFILE%\.codex\config.toml
2

写入以下配置

model = "gpt-5.5"
model_provider = "openai-custom"
personality = "pragmatic"
model_reasoning_effort = "high"

[model_providers.openai-custom]
name = "GravitexAI"
base_url = "https://api.gravitex.ai/v1"
wire_api = "responses"

# 自定义供应商通常需要显式注入 Key：
[model_providers.openai-custom.http_headers]
Authorization = "Bearer 你的_API_KEY"
Content-Type = "application/json"
3

启动 Codex

cd your-project-folder
codex
Codex 会基于上述配置使用 GravitexAI 提供的 GPT 模型进行回答。

​
四、推荐模型（经 GravitexAI 使用）

Codex 目前主要支持 GPT 家族的模型 ID。以下为 GravitexAI 中最常用的 GPT 模型组合：
模型 ID适用场景特点
gpt-5.5 ⭐复杂推理、工程级代码OpenAI 最新主力，综合能力最强
gpt-5.4通用对话、代码生成面向复杂专业任务的新一代主力
gpt-5.4-pro高复杂度推理 / 重构高性能版本
gpt-5.4-mini性能与成本平衡通用日常开发
gpt-5.4-nano高并发 / 低成本轻量场景
gpt-5.1-codex编程 / 代码补全仅支持 Responses API，需 wire_api = "responses"
Codex 支持 GPT-family 的模型 ID（如 gpt-5.5、gpt-5.4、gpt-5.1-codex）。完整可用列表请参考 GravitexAI 模型广场。

​
五、性格与推理强度

Codex 支持通过两个参数自定义模型行为：personality（性格） 与 model_reasoning_effort（推理强度）。

​
1. Personality（性格）

控制响应的 语气与风格。 
personality = "pragmatic"
选项说明
pragmatic务实，直接实用，最少化解释
concise简明扼要
detailed提供更多解释和背景
analytical结构化，注重逻辑
creative富有表现力，灵活创意
性格设置是一种 软性偏好，并非严格执行。如需精确控制，请使用 System Prompt。

​
2. Reasoning Effort（推理强度）

控制模型在解决问题时的「思考量」，对应 OpenAI Responses API 的 reasoning.effort 参数。 
model_reasoning_effort = "high"
选项说明适用场景
low响应最快简单问答、文案生成
medium平衡速度与质量日常编程任务
high深度推理复杂调试、架构设计、算法
较高的推理强度会增加响应时间和 token 消耗，但显著提升代码编写、调试和复杂逻辑处理的准确性。

​
3. 完整示例配置

model = "gpt-5.5"
model_provider = "openai-custom"
personality = "pragmatic"
model_reasoning_effort = "high"

[model_providers.openai-custom]
name = "GravitexAI"
base_url = "https://api.gravitex.ai/v1"
wire_api = "responses"

[model_providers.openai-custom.http_headers]
Authorization = "Bearer sk-your-gravitex-key"
Content-Type = "application/json"
该配置提供：
  • 清晰、实用的回答风格
  • 针对复杂任务的深度推理
  • 通过 Responses API 获得完整的 GPT-5.5 能力

​
六、常见问题

  1. 在 GravitexAI 控制台 重新检查 Key 是否正确，注意复制时是否引入了多余空格或换行。
  2. 确认 Authorization 头格式为 Bearer sk-xxxxxxxxxx。
  3. 确认账户余额充足。
确认 Base URL 以 /v1 结尾：
base_url = "https://api.gravitex.ai/v1"
常见错误：少写 /v1、多写 /responses、写成 http:// 等。
  1. 核实模型 ID 是否存在于 GravitexAI 模型列表 中。
  2. 注意 Codex 仅支持 GPT 家族模型 ID（不支持 Claude / Gemini）。
  3. 模型名大小写敏感。
gpt-5.1-codex、gpt-5.2-codex 等 Codex 系列模型仅支持 Responses API。请确保你的供应商配置中包含：
[model_providers.openai-custom]
wire_api = "responses"
在自定义供应商场景下，Codex 不一定会自动注入 OPENAI_API_KEY。推荐通过 http_headers 显式写入 Authorization：
[model_providers.openai-custom.http_headers]
Authorization = "Bearer sk-your-key"

​
七、参考链接