使用智能体

Codex CLI

前提条件

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

第一步：安装

npm install --global @openai/codex@latest
codex --version

第二步：设置 API Key

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

export JOY_TOKEN_API_KEY="sk-xxx"

如需长期使用，请通过 shell 配置或密钥管理工具提供该变量，不要把 API Key 写进 config.toml。

第三步：配置 Provider

把以下顶层配置和 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。

第四步：启动

cd /path/to/your/project
codex

第五步：验证

codex exec "Reply with exactly: pong"

成功响应中会包含 pong。

JoyToken 检查

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

常见错误

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

相关资源