跳到主要内容

Codex

Codex 是 OpenAI 的终端编码智能体。 官方网站：developers.openai.com/codex

1.1 使用方法​

Codex CLI 和 Codex IDE 扩展共享相同的 config.toml 配置层。对于 Luchentech 部署，最安全的设置是定义自定义模型提供商并从环境变量加载 API 密钥。

方式一：用户配置文件（推荐）​

将以下内容添加到 ~/.codex/config.toml：

model = "minimax/minimax-m2.5"
model_provider = "hpcai"

[model_providers.hpcai]
name = "Luchentech Model APIs"
base_url = "https://api.luchentech.com/inference/v1"
env_key = "INFERENCE_API_KEY"
env_key_instructions = "Export INFERENCE_API_KEY before starting Codex"
wire_api = "responses"
request_max_retries = 4
stream_max_retries = 5
stream_idle_timeout_ms = 300000
# supports_websockets = false

然后导出您的 API 密钥并启动 Codex：

export INFERENCE_API_KEY="your-luchentech-key"
codex

方式二：项目配置​

如果您希望设置仅应用于一个仓库，请将相同配置放在 <project>/.codex/config.toml 中。

Codex 仅对受信任的项目加载项目配置。

方式三：命名配置​

在 ~/.codex/config.toml 中添加可复用配置：

[profiles.hpcai]
model = "minimax/minimax-m2.5"
model_provider = "hpcai"

然后使用以下命令启动 Codex：

export INFERENCE_API_KEY="your-luchentech-key"
codex --profile hpcai

1.2 故障排除​

常见问题解决方案
WebSocket 传输错误如果支持 HTTP/SSE 流式传输但不支持 Responses API WebSocket 传输，添加 supports_websockets = false
项目配置被忽略信任该项目，或将提供商配置移至 ~/.codex/config.toml

1.3 参考​