快速开始 / 接入 Agent 工具
接入 Codex
Codex 是 OpenAI 推出的 AI 编程助手,通过 Responses API 与模型交互,本站原生支持该格式。Codex CLI、ChatGPT 桌面端和 VS Code 的 Codex 插件共用同一份配置文件,配置一次即可在所有形态中使用。
一键配置
运行下面这行命令,把 Key 换成你自己的,会在 ~/.codex/config.toml 中写好本站的配置,原有的 MCP 服务器、项目信任等设置保持不变(原文件会先备份)。Key 写在本站的提供方配置里,不会改动 ChatGPT 的登录状态。API Key 在控制台的 API Keys 页创建。
在终端中执行:
curl -fsSL https://tokenjoy.org/setup.sh | TOKENJOY_BASE_URL=https://api.tokenjoy.org sh -s -- <你的 API Key> codex gpt-5
创建 Key 时弹出的窗口里可以选择 Codex,命令中已经带上了你的 Key,直接复制即可。默认模型为 gpt-5,之后可以随时切换。
写好的配置带有 model_catalog_url,Codex 会从本站读取模型列表,/model 里能看到并切换本站的全部模型(GPT、Claude、Gemini、DeepSeek 等)。之前配置过的,重新运行一次上面的命令即可更新。
手动配置
1. 安装 Codex
安装 Node.js 18 或更高版本,然后执行:
npm install -g @openai/codex
2. 配置模型提供方
编辑 ~/.codex/config.toml(没有就新建),加入下面的内容。原有的 MCP 服务器、项目信任等配置可以保留。
~/.codex/config.toml
model = "gpt-5" model_provider = "tokenjoy" [model_providers.tokenjoy] name = "TokenJoy" base_url = "https://api.tokenjoy.org/v1" model_catalog_url = "https://api.tokenjoy.org/v1/models" env_key = "TOKENJOY_API_KEY" wire_api = "responses"
model_catalog_url让 Codex 从本站读取模型列表,/model里会列出本站的全部模型。不写这一行的话,Codex 只列出它内置的 GPT 模型。model是默认模型,可以换成 模型列表里的任意模型,之后在/model里随时切换。
然后把 Key 设置为环境变量。API Key 在控制台的 API Keys 页创建。
加到 ~/.zshrc 或 ~/.bashrc 末尾
export TOKENJOY_API_KEY="<你的 API Key>"
3. 开始使用
cd /path/to/my-project codex
进去后输入 /model 可以切换本站的全部模型。如果列表里只有 GPT 模型,检查配置里有没有 model_catalog_url,并执行 npm install -g @openai/codex 把 Codex 升级到最新版本。