Codex 安装使用教程 - LinksAPI

系统要求

Windows 10/11 / macOS 12+ / Linux (Debian/Ubuntu/CentOS/Arch)
Node.js 22+
npm 10+
稳定网络连接

安装 Node.js

前往 Node.js 官网下载 LTS 版本，或使用包管理器：

bash
# macOS (Homebrew) brew install node # Windows (winget) winget install OpenJS.NodeJS.LTS # Ubuntu/Debian curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs

验证安装：

bash
node --version  # 应输出 v22.x.x 或更高 npm --version   # 应输出 10.x.x 或更高

安装 Codex

bash
npm install -g @openai/codex

验证：

bash
codex --version

配置 LinksAPI 接入

在你的用户目录下创建 .codex 文件夹（如果不存在），然后创建两个配置文件：

~/.codex/auth.json

json
{
  "OPENAI_API_KEY": "sk-你的_LinksAPI_令牌"
}

~/.codex/config.toml

toml
model_provider = "linksapi"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.linksapi]
name = "linksapi"
base_url = "https://linksapi.cn/v1"
wire_api = "responses"

API Key 在哪里获取？ 登录 LinksAPI 控制台，进入「API 令牌」页面，创建新令牌后复制 sk- 开头的字符串。

启动 Codex

bash
codex

进入交互界面后即可输入指令，比如：

帮我写一个 Python 脚本，读取 CSV 并按日期排序

VSCode 插件配置（可选）

在 VSCode 扩展市场搜索安装 Codex 插件，然后：

打开命令面板（Ctrl+Shift+P）
搜索 Codex: Settings
把 Base URL 填为 https://linksapi.cn/v1
API Key 填你的 LinksAPI 令牌

常见问题

Q: 提示 401 Unauthorized？

检查 auth.json 里的 API Key 是否正确，注意不要包含多余的空格或引号。

Q: 模型不可用？

当前 LinksAPI 支持 gpt-5、gpt-5-codex、gpt-4.1、gpt-4o 等模型，在模型广场查看完整列表。

Q: 响应很慢？

LinksAPI 走官方上游通道，国内直连优化；如遇延迟可尝试 gpt-5-mini 或 gpt-4.1-mini 等小模型。