编码 Agent 集成

Codex CLI

Codex CLI 是什么？

Codex CLI 是运行在终端里的本地编码 Agent。它支持自定义模型提供方，因此团队可以把 Codex 的模型调用交给 JoyToken，统一做 API Key 管理、模型路由、策略检查、钱包额度和用量归因。

JoyToken 暴露 OpenAI 兼容的聊天补全接口：

https://api-dev.joytokens.ai/openai/v1

快速开始

第 1 步：安装 Codex CLI

按 Codex 官方安装说明在你的环境中安装 CLI。

第 2 步：创建 JoyToken API Key

创建一把 Codex 专用 Key，例如 dev-codex-cli。

建议策略：

设置建议
模型从 auto 开始
预算设置较小的每日或每周上限
IP 白名单团队机器、办公室或 VPN 出口
日志保持开启，方便排障

第 3 步：设置 API Key

~/.zshrc
$export JOY_TOKEN_API_KEY="jt_xxx"

刷新 shell：

$source ~/.zshrc

第 4 步：配置 Codex 使用 JoyToken

Codex 读取 ~/.codex/config.toml。添加 JoyToken 提供方：

~/.codex/config.toml
1model_provider = "joytoken"
2model = "auto"
3
4[model_providers.joytoken]
5name = "joytoken"
6base_url = "https://api-dev.joytokens.ai/openai/v1"
7env_key = "JOY_TOKEN_API_KEY"

第 5 步：启动 Codex

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

模型请求会经过 JoyToken。

配置参考

核心配置

配置项说明示例
model_providerCodex 使用的提供方"joytoken"
modelJoyToken 模型 key 或路由模式"auto"
base_urlJoyToken OpenAI 兼容基础 URL"https://api-dev.joytokens.ai/openai/v1"
env_key存放 API Key 的环境变量名"JOY_TOKEN_API_KEY"

模型取值

值行为
autoJoyToken 路由器在策略允许范围内自动选模型
具体模型 key固定到某个 JoyToken 模型，但仍经过策略和钱包检查
API Key 固定模型Key 策略会限制或覆盖请求模型

为什么用 JoyToken 接入 Codex CLI？

API Key 集中管理

为 Codex 创建专用 Key，可独立撤销，并把本地开发 Key 和生产 Key 分开。

预算和策略控制

在编码会话消耗 Credits 前，先应用模型、tier、IP 和预算策略。

用量可见性

通过 JoyToken 日志、用量和账单按 API Key 查看 Codex 用量。需要更清晰归因时，可以按开发者或工作流拆 Key。

模型灵活性

评估质量和成本时先使用 auto。稳定工作流可以再固定具体模型。

故障排查

现象检查
401 UnauthorizedJOY_TOKEN_API_KEY 是否存在且复制完整
403 ForbiddenKey 策略是否允许当前 IP、tier 和模型
402 Payment Required钱包余额、额度或预算是否足够
model not found使用 auto，或使用 JoyToken 模型目录里的模型 key
没有 JoyToken 日志确认 model_provider = "joytoken"，且 base_url 包含 /openai/v1

相关资源