codex-plugin-cc 如何复用你现有的 Codex 配置与 API Key:免重复登录完整指南
【免费下载链接】codex-plugin-ccUse Codex from Claude Code to review code or delegate tasks.项目地址: https://gitcode.com/GitHub_Trending/co/codex-plugin-cc
codex-plugin-cc是 Claude Code 的官方 Codex 插件,让你直接在 Claude Code 里复用本机已登录的 Codex 配置与 API Key。只要你在同一台电脑上已经用 Codex(无论 ChatGPT 订阅还是 OpenAI API Key),装完插件即可开箱即用,无需重复登录、无需另配一套密钥。
核心结论:这个插件不自带独立的 Codex 运行时,而是直接调用你 PATH 里的
codex命令,因此你现有的登录状态、config.toml配置、自定义端点全部原样生效。
一句话看懂:为什么不用再配一遍?
传统做法是:用 Claude Code 时登录一套,用 Codex 时再登录一套,密钥和模型设置还得各调各的。
而 codex-plugin-cc 的思路是——让 Codex 继续当它自己。插件启动时调用你本机已安装的codex app-server,Codex 自然会去读它自己那套配置和登录态,插件只负责「把任务递过去、把结果取回来」。
这样带来三个直接好处:
- ✅免重复登录:你之前
codex login登录的账号直接可用 - ✅配置零迁移:默认模型、推理强度、沙箱策略都不用改
- ✅密钥零泄漏:插件不接触、不存储你的 API Key,全部走本机 Codex 已有通道
它复用了你现有的哪些 Codex 配置
下表列出插件会「原样继承」的内容,均来自你本机 Codex 的既有状态:
| 复用的内容 | 来源位置 | 说明 |
|---|---|---|
| Codex 可执行文件 | 系统 PATH 里的全局codex | 与你直接跑codex用的是同一个 |
| 登录 / 鉴权状态 | 用户级~/.codex(或CODEX_HOME) | ChatGPT 登录态或 API Key 原样生效 |
| 用户级配置 | ~/.codex/config.toml | 默认模型、推理强度等全局设置 |
| 项目级配置 | 项目根.codex/config.toml | 项目信任后自动加载,可覆盖用户级 |
| 自定义端点 | 配置里的openai_base_url | 指向代理 / 自建网关同样有效 |
提示:项目级
.codex/config.toml只有在该项目被信任时才会被加载,避免误读不受信目录的配置。
复用原理:直接调用你本机的 codex 二进制
1. 不打包独立的 Codex 运行时
插件的底层客户端在需要干活时,会直接以子进程方式拉起codex app-server(见 plugins/codex/scripts/lib/app-server.mjs 里的启动逻辑),而不是内置一份 Codex。
这意味着:插件里没有第二套模型、第二份密钥、第二个登录态。你升级或更换 Codex 版本,插件跟着一起变,不存在版本错位。
2. 读取 ~/.codex 里的登录状态与配置
插件在判断「Codex 是否就绪」时,会解析出你的 Codex 主目录(环境变量CODEX_HOME,否则默认~/.codex),并让 app-server 去读它自己的配置与账号。
所以你只要平时能正常用 Codex,插件就一定能用——它俩读的是同一份东西。
3. 认证方式自动识别
插件启动后会通过account/read+config/read两个请求,识别出你当前的鉴权来源,并在状态里如实标注。它认识这几种:
- ChatGPT 登录:会显示「ChatGPT login active」并附带邮箱,视为已验证
- API Key:识别到
apiKey类型,标记为「已配置(未在线验证)」 - 自定义模型供应商:如 Ollama、LM Studio 等本地/自建供应商,若无需 OpenAI 鉴权,则直接判定可用
换句话说,不管你平时是靠订阅、靠 Key、还是靠本地模型,插件都认得,且不会强迫你换方式。
三种登录方式都能直接用
对应插件声明的最低要求:一个 ChatGPT 订阅(含免费版)或一个 OpenAI API Key,外加 Node.js 18.18+。
- 用ChatGPT 订阅的朋友:登录态直接复用,无需任何额外操作
- 用OpenAI API Key的朋友:你在 Codex 里配好的 Key 原样生效
- 用本地 / 自建端点的朋友:
openai_base_url配置照旧,插件不会改动它
自定义端点:openai_base_url 照样生效
如果你把 OpenAI Provider 指向了代理或自建网关(通过 Codex 配置里的openai_base_url),插件完全沿用这套设置,因为所有请求最终都发给你本机的那个codex。
简单说:你在 Codex 里怎么连,插件就怎么连。想换端点?去改你 Codex 的
config.toml即可,插件这边不用动。
快速验证:用 /codex:setup 检查是否复用成功
装好插件后,最稳妥的确认方式就是跑一次/codex:setup。它会检查两件事:
- 本机
codex二进制是否可用(含 app-server 运行时) - 是否已登录(识别出你当前的鉴权来源)
如果 Codex 还没装,而系统里有 npm,插件会主动询问是否帮你安装(npm install -g @openai/codex),装完再复检。已安装但没登录时,它会提示你用!codex login登录——这一步登录的就是你日常用的那套 Codex 账号或 Key。
一次最小化的首跑体验:
/codex:review --background /codex:status /codex:result跑通即说明你现有的 Codex 配置与密钥已被成功复用。
共享运行时:一个会话只启动一次 Codex
为了减少重复冷启动,插件还支持共享运行时(broker):同一个 Claude 会话内的多次 review / task,会复用同一个已在运行的 app-server 实例(状态写在本地broker.json),而不是每次都新开一个进程。
这属于透明的性能优化,对你而言没有任何额外配置,配置与鉴权依旧全部来自本机 Codex。
常见配置路径速查
| 你想调整的东西 | 去哪里改 |
|---|---|
| 默认模型 / 推理强度 | ~/.codex/config.toml |
| 单个项目的模型覆盖 | 项目根.codex/config.toml(需信任项目) |
| 自定义 API 端点 | Codex 配置中的openai_base_url |
| Codex 主目录 | 环境变量CODEX_HOME,默认~/.codex |
| 插件就绪检查 | /codex:setup命令 |
相关实现集中在 plugins/codex/scripts/lib/ 目录:codex.mjs负责鉴权与状态识别,app-server.mjs负责拉起本机codex app-server,broker-lifecycle.mjs负责共享运行时的生命周期。
小结
codex-plugin-cc 的「复用」不是口号,而是架构层面的零重复:它调用你本机已安装、已登录的 Codex,因此你的 API Key、ChatGPT 登录态、config.toml模型设置、openai_base_url自定义端点全部原样生效。你只需/codex:setup确认一次就绪,就能在 Claude Code 里无缝复用现有 Codex 配置,把重复的登录与配置工作彻底省掉。
【免费下载链接】codex-plugin-ccUse Codex from Claude Code to review code or delegate tasks.项目地址: https://gitcode.com/GitHub_Trending/co/codex-plugin-cc
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考