☰
codex-plugin-cc 如何复用你现有的 Codex 配置与 API Key:免重复登录完整指南
2026/11/4 8:22:38 网站建设 项目流程

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。它会检查两件事:

  1. 本机codex二进制是否可用(含 app-server 运行时)
  2. 是否已登录(识别出你当前的鉴权来源)

如果 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询