登录注册
快速开始Codex

快速开始 / 接入 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 升级到最新版本。