使用智能体

Codex CLI

前提条件

项目值
命令codex
配置文件~/.codex/config.toml
Provider idjoytoken
模型名auto
JoyToken Base URL从 环境 选择 JOY_TOKEN_OPENAI_BASE_URL
API Key 环境变量JOY_TOKEN_API_KEY

第 1 步：安装

按 Codex 仓库 的安装说明安装 Codex CLI，然后确认命令可用：

$codex --version

第 2 步：配置 Codex

Codex 可以直接指向 JoyToken 的 OpenAI 兼容接口，不需要本地桥接服务。

把 jt_xxx 替换成你的 JoyToken API Key，然后执行：

配置 Codex CLI
$export JOY_TOKEN_API_KEY="jt_xxx"
$export JOY_TOKEN_OPENAI_BASE_URL="https://api-dev.joytokens.ai/openai/v1"
$mkdir -p ~/.codex
$cat > ~/.codex/config.toml <<EOF
$model_provider = "joytoken"
$model = "auto"
$
$[model_providers.joytoken]
$name = "JoyToken"
$base_url = "$JOY_TOKEN_OPENAI_BASE_URL"
$env_key = "JOY_TOKEN_API_KEY"
$EOF

长期使用时，把 API Key 写入 shell 配置：

$printf '\nexport JOY_TOKEN_API_KEY="%s"\n' "$JOY_TOKEN_API_KEY" >> ~/.zshrc

第 3 步：启动 Codex

进入你的项目目录后运行：

$cd /path/to/your/project
$codex

第 4 步：验证

$codex exec \
>  --skip-git-repo-check \
>  --sandbox read-only \
>  --ask-for-approval never \
>  "Reply with exactly: pong"

成功时，输出包含 pong。

JoyToken 侧检查

位置应看到
Logs请求路径是 /openai/v1/chat/completions
API Key请求归因到 Codex CLI 使用的 Key
Usage本次调用产生 tokens 和 credits
Model请求模型是 auto

常见错误

错误处理方式
401 Unauthorized检查 JOY_TOKEN_API_KEY 是否存在且完整
Codex 仍使用其他 provider检查 ~/.codex/config.toml 的 model_provider = "joytoken"
模型不存在使用 model = "auto" 或 JoyToken 支持的模型
JoyToken 没有日志检查 base_url 是否匹配当前选择的 JoyToken 环境

相关资源