跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://doc.onetoken.one/llms.txt

Use this file to discover all available pages before exploring further.

​
Windows 版本教程

​
系统要求

  • Windows 10 或 Windows 11
  • Node.js 22+
  • npm 10+
  • 网络连接

​
安装步骤

前置步骤！！！ 安装 Git Bash，请访问 Git - Downloads 下载对应您电脑系统的版本，之后一直点击“下一步”即可完成安装。 1. 安装 Node.js 访问 Node.js 官网 下载并安装最新 LTS 版本。 2. 安装 codex 打开命令提示符 (CMD) 或 PowerShell，运行： 
npm install -g @openai/codex
3. 验证安装 打开命令提示符 (CMD) 或 PowerShell，运行： 
codex --version

​
配置 API

1. 获取 Auth Token 访问 onetoken.one 站点页面进行以下操作：
  • 点击 控制台 → API令牌 页面
  • 点击 添加令牌
  • 令牌分组请选择：codex专属（务必选择此分组，否则无法使用）
  • 令牌名称随意
  • 额度建议：设置为 无限额度
  • 其他选项保持默认
image.png 2. 配置文件
重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！ 重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！ 重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！
  1. 进入当前用户的用户目录下的 .codex 文件夹中，例如：C:\Users\testuser\.codex。 （注意：如果看不到该目录，说明您没有打开 Windows 的“显示隐藏的项目”，请先在文件资源管理器中开启。）
image.png
  1. 如果没有 .codex 文件夹，请手动创建该文件夹，然后在其中创建 config.toml 以及 auth.json 两个文件。
image.png 3. 填写配置 (需要将 sk-xxx 替换成您自己创建的真实 SK)。 a. auth.json 中的配置： 
{"OPENAI_API_KEY": "sk-xxx"}
b. config.toml 中的配置（直接粘贴下面的内容即可）： model_reasoning_effort 可选值为 high, medium, low，分别代表模型思考的努力程度（高、中、低）。 
model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://onetoken.one/v1"
wire_api = "responses"

​
启动 codex

重启终端！重启终端！重启终端！ 然后进入到您的工程目录： 
cd your-project-folder
运行以下命令启动： 
codex
image.png

​
VSCode 插件 codex

以上配置完成后，在 VSCode 扩展商店中搜索并安装 codex 即可。 image.png 安装完成后会出现在侧边栏。

​
image.png

​
Mac 版本教程

​
系统要求

  • macOS 12 或更高版本
  • Node.js 22+
  • npm 10+
  • 网络连接

​
安装步骤

1. 安装 Node.js
  • 方式一：直接访问 Node.js 官网 下载并安装最新 LTS 版本。
  • 方式二：使用 Homebrew（推荐） 
    # 如果尚未安装 Homebrew，请先运行此命令
/bin/bash -c "$(curl -fsSL [https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh](https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))"

# 安装 Node.js
brew install node
2. 安装 codex 打开终端 (Terminal)，运行（可能需要加 sudo）： 
npm install -g @openai/codex
3. 验证安装 打开终端 (Terminal)，运行： 
codex --version

​
配置 API

1. 获取 Auth Token 访问 onetoken.one 站点页面进行以下操作：
  • 点击 控制台 → API令牌 页面
  • 点击 添加令牌
  • 令牌分组请选择：codex特供（务必选择此分组，否则无法使用）
  • 令牌名称随意
  • 额度建议：设置为 无限额度
  • 其他选项保持默认 image.png
2. 配置文件
重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！ 重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！ 重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！
  1. 创建目录和文件： 
    mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
  2. 编辑 auth.json 文件： 
    vi ~/.codex/auth.json
    按 i 进入插入模式，粘贴以下内容（将 sk-xxx 替换为您的密钥），然后按 ESC 键，输入 :wq 并回车保存退出。 
    { "OPENAI_API_KEY": "sk-xxx" }
  3. 编辑 config.toml 文件： 
    vi ~/.codex/config.toml
    按 i 进入插入模式，粘贴以下内容，然后按 ESC 键，输入 :wq 并回车保存退出。 
    model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://onetoken.one/v1"
wire_api = "responses"

​
启动 codex

重启终端！重启终端！重启终端！ 然后进入到您的工程目录： 
cd your-project-folder
运行以下命令启动： 
codex
[图片]

​
VSCode 插件 codex

以上配置完成后，在 VSCode 扩展商店中搜索并安装 codex 即可。 [图片] 安装完成后会出现在侧边栏。 [图片]

​
Linux 版本教程

​
系统要求

  • 主流 Linux 发行版 (Ubuntu 20.04+, Debian 10+, CentOS 7+, etc.)
  • Node.js 22+
  • npm 10+
  • 网络连接

​
安装步骤

1. 安装 Node.js
  • Ubuntu/Debian 
    sudo apt update
curl -fsSL [https://deb.nodesource.com/setup_lts.x](https://deb.nodesource.com/setup_lts.x) | sudo -E bash -
sudo apt-get install -y nodejs
  • CentOS/RHEL/Fedora 
    # 使用 dnf (Fedora) 或 yum (CentOS/RHEL)
sudo dnf install nodejs npm
# 或
sudo yum install nodejs npm
  • Arch Linux 
    sudo pacman -S nodejs npm
2. 安装 codex 打开终端 (Terminal)，运行： 
sudo npm install -g @openai/codex
3. 验证安装 打开终端 (Terminal)，运行： 
codex --version

​
配置 API

1. 获取 Auth Token 访问 onetoken.one 站点页面进行以下操作：
  • 点击 控制台 → API令牌 页面
  • 点击 添加令牌
  • 令牌分组请选择：codex渠道-gpt（务必选择此分组，否则无法使用）
  • 令牌名称随意
  • 额度建议：设置为 无限额度
  • 其他选项保持默认 [图片]
2. 配置文件
重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！ 重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！ 重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！
  1. 创建目录和文件： 
    mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
  2. 编辑 auth.json 文件： 
    vi ~/.codex/auth.json
    按 i 进入插入模式，粘贴以下内容（将 sk-xxx 替换为您的密钥），然后按 ESC 键，输入 :wq 并回车保存退出。 
    { "OPENAI_API_KEY": "sk-xxx" }
  3. 编辑 config.toml 文件： 
    vi ~/.codex/config.toml
    按 i 进入插入模式，粘贴以下内容，然后按 ESC 键，输入 :wq 并回车保存退出。 
    model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://onetoken.one/v1"
wire_api = "responses"

​
启动 codex

重启终端！重启终端！重启终端！ 然后进入到您的工程目录： 
cd your-project-folder
运行以下命令启动： 
codex
image.png

​
VSCode 插件 codex

以上配置完成后，在 VSCode 扩展商店中搜索并安装 codex 即可。 image.png 安装完成后会出现在侧边栏。

​
image.png

​
常见问题

出现错误请按照如下步骤排查：
  1. 确认 API Key 创建是否正确：额度选择无限额度，不要限制模型，分组选择 codex渠道-gpt。
更多 codex 配置及使用详情请参考 codex 官方教程。