使用智能体

Codex App

前提条件

项目值
Codex App最新版本
配置文件~/.codex/config.toml
Provider idjoytoken
模型名称auto
JoyToken Base URLhttps://api.joytokens.ai/openai/v1
接口协议OpenAI Responses
API Key 环境变量JOY_TOKEN_API_KEY

第一步：设置 API Key

把 sk-xxx 替换成你的 JoyToken API Key：

export JOY_TOKEN_API_KEY="sk-xxx"

Codex 会读取 env_key 指定的环境变量。不要把 API Key 写进 config.toml，并从能够读取该变量的终端启动 App。

第二步：配置 Provider

在 Codex App 中打开 Settings > Configuration > Open config.toml，把以下顶层配置和 Provider 定义加入 ~/.codex/config.toml：

model = "auto"
model_provider = "joytoken"
[model_providers.joytoken]
name = "JoyToken"
base_url = "https://api.joytokens.ai/openai/v1"
env_key = "JOY_TOKEN_API_KEY"
wire_api = "responses"

Provider 和认证配置必须放在用户级配置中。Codex 会忽略项目级 .codex/config.toml 里的 model_provider 和 model_providers。

第三步：启动 Codex App

完全退出正在运行的 Codex App，然后从已设置 JOY_TOKEN_API_KEY 的终端打开项目：

codex app /path/to/your/project

第四步：验证

发送 Reply with exactly: pong。成功响应中会包含 pong。

JoyToken 检查

位置预期结果
日志请求路径是 /openai/v1/responses
认证使用 JOY_TOKEN_API_KEY 进行 Bearer 认证
模型请求的模型是 auto
用量正常记录 token 和 Credits

常见错误

错误处理方式
缺少 JOY_TOKEN_API_KEY从已导出该变量的终端启动 Codex App
Codex 使用了其他 Provider检查 ~/.codex/config.toml 中的 model_provider = "joytoken"
Provider 配置未生效把配置从项目 .codex/config.toml 移到用户级 ~/.codex/config.toml
401 Unauthorized检查 JOY_TOKEN_API_KEY 是否为有效的 JoyToken API Key

相关资源