1. 为什么要在 PyCharm 里跑 OpenAI Codex CLI如果你平时用 PyCharm 写 Python又想让 Codex CLI 帮你批量生成脚本、重构旧代码、补单元测试最别扭的地方就是CLI 在终端里代码在编辑器里来回复制粘贴。很多人第一反应是找插件但第三方插件在 CLI 升级后经常失效而且子进程环境隔离终端能跑通、IDE 里就鉴权失败。我试过把 Codex CLI 直接挂到 PyCharm 的 External Tools 上走原生外部工具这条路不装任何插件直接调用本机全局安装的 codex 命令。好处是没有中间层终端和 IDE 用同一套 CLI 逻辑社区版和专业版都支持代价是结果输出在终端面板不能悬浮插入光标处但可以通过重定向直接写进项目文件。这篇就按“本地校验 → External Tools 配置 → skills.yaml → 验证请求 → 排错”的顺序把可直接复制的参数、环境变量模板和逐步验证动作给全。适合已经在终端用过 Codex CLI、想把它搬进 PyCharm 的 Python 开发者如果你还没装 CLI第 2 节会先带你装好。核心链路其实就一句话PyCharm 外部工具启动子进程 → 执行 codex run → 读取项目根目录 skills.yaml → 带上环境变量里的 Key 和 Base URL 发请求 → 结果输出到 Terminal 或重定向写入文件。90% 的坑都出在“子进程不继承系统环境变量”这一步后面会重点讲。2. 前置准备Node、Codex CLI 与 TaoToken 接入信息在动 PyCharm 之前先把终端这条链路跑通。终端都跑不通进 IDE 只会更难定位。Node 版本要求 v18 LTS 及以上装完用node -v确认。然后全局安装 CLInpm install -g openai/codex装完在 PowerShell 或 CMD 里执行版本检查codex --version如果提示codex 不是内部或外部命令说明 npm 全局路径没进系统 PATH。关掉所有终端窗口重开Windows 下可以用where.exe codex找到可执行文件的真实路径后面 Program 填绝对路径时用得上。接下来是接口地址和 Key。TaoToken 提供统一的 API 入口官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。你需要先去控制台创建一个 API Key入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。模型 ID 和可用列表以接入文档为准 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。拿到 Key 后先在终端验证一次确认 CLI 本身没问题$env:CODEX_API_KEYsk-你的Key $env:CODEX_BASE_URLhttps://taotoken.net/api codex run --model 你的模型ID 输出一个简单的 python hello 函数只有终端能正常返回代码才继续往下配 PyCharm。这一步是后面排错的“对照组”务必记住终端命令长什么样。3. 可复制配置External Tools 参数与 skills.yaml打开 PyCharmWindows/Linux 走File → Settings → Tools → External ToolsMac 走PyCharm → Preferences → Tools → External Tools点右上角新建。按下面这张表填Program 如果识别不到 codex就填where.exe codex查到的完整路径Windows 通常是codex.cmd字段填写值NameCodex-CLI-PythonProgramcodex或 codex.cmd 绝对路径Argumentsrun --model 你的模型ID --skills $ProjectFileDir$/skills.yaml $Prompt$Working directory$ProjectFileDir$Working directory 一定要用$ProjectFileDir$宏否则相对路径读 skills.yaml 会直接报找不到文件。重点在 Environment variables 这一栏必须手动加不要指望系统环境变量CODEX_API_KEYsk-你的Key CODEX_BASE_URLhttps://taotoken.net/api CODEX_TIMEOUT120填完 Apply 保存重启 PyCharm 让配置生效。这里三件套Base URL Key Model ID缺一不可Model ID 写错会直接报 model not found。然后在项目根目录新建skills.yaml用来约束代码风格、强制 PEP8、加异常捕获description: Python后端开发工程师输出简洁健壮可直接运行的代码严格遵循PEP8规范 constraints: - 函数增加类型注解增加必要异常捕获 - 不臆造不存在的第三方库 - 减少冗余文字优先输出代码本体 - 文件读写必须处理文件不存在、编码异常 parameters: temperature: 0.2 max_output_tokens: 1800 top_p: 0.3temperature 建议压在 0.1–0.3随机性低生成更稳。max_output_tokens 太小会导致长脚本被截断后面排错会讲。4. 验证请求从菜单触发到结果落盘配置保存后顶部菜单Tools → External Tools → Codex-CLI-Python会弹出输入框输入你的需求比如“写一个遍历目录统计 py 文件行数的脚本”。执行后 PyCharm 底部 Terminal 面板会输出完整代码。如果想让生成结果直接写进项目文件把 Arguments 改成带重定向的版本run --model 你的模型ID --skills $ProjectFileDir$/skills.yaml $Prompt$ $ProjectFileDir$/gen_code.py跑完项目目录里就多了gen_code.py省去复制粘贴。排错阶段建议加--debug能看到真实请求的 base_url、model 和返回报文run --debug --model 你的模型ID --skills $ProjectFileDir$/skills.yaml $Prompt$验证成功的标志有三个Terminal 面板出现完整代码、没有 401 或超时提示、重定向模式下目标文件内容非空。如果只想先确认模型通不通可以打开模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 发一条消息能正常回复说明 Key 和网络没问题问题就锁定在 PyCharm 侧。长期在 IDE 里做编码和 Agent 任务的话可以了解下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 配合 External Tools 用起来更顺。5. 常见报错排查401、skills.yaml 找不到、输出截断坑 1终端正常PyCharm 里 401 鉴权失败。根因是外部工具子进程不继承系统用户环境变量。解决在 External Tools 的 Environment variables 里手动填CODEX_API_KEY和CODEX_BASE_URL别靠系统全局变量。这是最高频的坑。坑 2报错 cannot open skills.yaml。根因是 Working directory 没设成$ProjectFileDir$程序在 PyCharm 安装目录里找文件。解决固定 Working directoryskills.yaml 放项目根目录。坑 3命令执行无输出也不报错。先确认 Program 能否识别 codex填codex.cmd绝对路径测试项目路径含中文或空格容易出问题尽量用全英文路径网络慢就调大CODEX_TIMEOUT120。坑 4短代码正常长脚本输出截断。根因是超时太短或max_output_tokens太小。解决调大超时同时把 skills.yaml 里的max_output_tokens提到 3000 以上。用网关时部分流式输出会被截断开--debug看完整响应。坑 5报 model not found。根因是模型 ID 写错或该模型未开通。解决核对接入文档里的模型标识不要照搬 OpenAI 官方模型名。坑 6报 local proxy failed 或 OAuth 相关错误。这类多半是环境变量里混入了旧的代理配置或残留的 OAuth 凭据。解决清空外部工具环境变量里与代理、OAuth 无关的项只保留三件套重启 PyCharm 再试。排错标准流程先在系统终端执行相同命令确认是否复现终端正常就说明问题 100% 在 PyCharm 的环境或路径配置开--debug看真实请求检查 Working directory 宏核对环境变量有没有多余空格换行。6. 进阶用法与稳定运行建议绑定快捷键能省不少事Settings → Keymap → External Tools → Codex-CLI-Python设一个顺手的组合键一键唤起输入框。可以建多套外部工具分别绑不同 skills 文件Codex-CLI-Generate做脚本生成、Codex-CLI-Refactor做代码重构、Codex-CLI-UnitTest做单元测试生成。每套的 Arguments 里--skills指向不同的 yaml 即可。方案对比上External Tools 无插件依赖、配置统一、稳定性高缺点是结果在终端、不能直接插入光标处第三方插件界面友好、能一键插入但有版本兼容风险和环境隔离问题容易静默报错。经常用 Codex CLI、已有 skills 配置的选 External Tools 更省心。最后提醒一句生成代码务必人工审核尤其是文件读写和异常处理逻辑。把终端当对照组、把--debug当放大镜绝大多数问题都能快速定位。