Skip to main content
Codex 是 OpenAI 的编程 Agent，有三种形态：终端里的 Codex CLI、VS Code 里的 Codex 扩展，以及 Codex App。三者共用 ~/.codex 目录，配置一次即可全部生效。

​
一条命令安装

把 sk-xxx 换成你的 Key，打开终端，粘贴并回车。脚本会验证 Key，列出该 Key 可调用的全部模型供你选择（回车 = 推荐：Astra 套餐 gpt-astra，GPT 套餐 gpt-5.6-sol，Claude 套餐 claude-opus-5），安装 Codex CLI 并写入配置。
脚本先询问语言（1 = 越南语，2 = 英语；用 --lang en 或 --lang vi 跳过）。不传 --key 时脚本会提示输入。强制指定模型：加 --model gpt-astra 或 --model gpt-5.6-sol。
运行前可先阅读源码：codex.sh、codex.ps1。脚本只在你的电脑上运行，Key 只发送到 gpt.teamsoclo.site 用于验证。

​
脚本做了什么

  1. 验证 Key 并按套餐选择模型；Key 无效则停止，不改动你的电脑。
  2. 备份已有的 config.toml 为 config.toml.bak.<时间>。
  3. 写入 ~/.codex/config.toml：模型 gpt-5.6-sol、TeamSocLo 网关、Responses API。
  4. 把 Key 存入环境变量 TEAMSOCLO_API_KEY（写入 ~/.zshrc / ~/.bashrc，Windows 为用户变量）。Key 不在配置文件里，分享 config.toml 也不会泄露。
  5. 用 npm install -g @openai/codex 安装或升级 Codex CLI。
随时可重复运行以更换 Key 或套餐，旧配置总会先备份。
不想用终端？TeamSocLo Key Tool 是 Windows 和 macOS 应用，粘贴一次密钥即可配置 Codex、Claude Code 等 20 多个工具。

​
安装之后

1

新开终端，运行 codex

旧终端尚未加载新的环境变量，必须新开一个标签。随便问一句验证。
2

VS Code：安装扩展，完全退出后重开

VS Code → Extensions → 搜索 Codex（OpenAI’s coding agent）→ Install。然后完全退出 VS Code：macOS Cmd + Q，Windows 关闭所有窗口。Reload Window 不够，扩展只在进程启动时读配置。
3

Codex App

运行命令后重新打开 App。macOS 已通过 launchctl 为图形程序设置变量；Windows 的 setx 对之后启动的程序生效。
无需登录 OpenAI。requires_openai_auth = false 让 Codex 直接使用环境变量中的网关 Key。

​
手动配置

若想自己编辑，~/.codex/config.toml（Windows：%USERPROFILE%\.codex\config.toml）内容必须为：
并且环境变量 TEAMSOCLO_API_KEY 中存有你的 Key。
保持 wire_api = "responses"。Codex 使用 Responses API，改成 chat 会失效。
快速打开配置目录：

​
切换模型

GPT Astra 套餐使用 gpt-astra。修改 config.toml 第一行并重启 Codex：
GPT Key 调用 gpt-astra 会提示无可用渠道，反之亦然。模型跟随所购套餐，见 模型与套餐。

​
卸载

想保留 Codex 但恢复原配置，把 config.toml.bak.<时间> 复制回 config.toml 即可。

​
不工作时检查

  • 安装后是否新开了终端或完全退出了 VS Code。
  • echo $TEAMSOCLO_API_KEY（Windows 的 cmd 中用 echo %TEAMSOCLO_API_KEY%）能输出完整 Key。
  • base_url 以 /v1 结尾，wire_api 为 responses。
  • Key 未过期且有额度：在此检查。
  • 仍有问题见 常见问题，其中有 Codex 专章。