本文面向已安装 Claude Code 的读者，梳理首次连接的两条路径：官方账号直接运行 `claude` 登录，并发一条最小请求验证；第三方网关则先确认服务方地址、凭据种类和可用模型 ID，用 curl 验证连通性，再备份并合并用户级 `~/.claude/settings.json`，通过 `/status` 核对设置来源后发送真实请求。文末附首次连接失败的核心排查表和官方资料。

Codex CLI 中 AGENTS.md 未生效时，先重启会话、检查 AGENTS.override.md 优先级、确认启动目录。仍不行则按四步排查：列出实际采用文件（注意项目空 override 不回退）、识别更近目录覆盖、记录信任状态、修改后新开会话。常见原因包括空覆盖文件、合并超限或文件名拼写错误。

Codex CLI 中 AGENTS.md 未生效时，先重启会话、检查 AGENTS.override.md 优先级、确认启动目录。仍不行则按四步排查：列出实际采用文件（注意项目空 override 不回退）、识别更近目录覆盖、记录信任状态、修改后新开会话。常见原因包括空覆盖文件、合并超限或文件名拼写错误。

提前准备和检查Node.js环境，是npm安装AI编程工具顺利成功的关键。先确认目标工具是否依赖Node.js及版本要求（如Pi需>=22.19.0）；从官网安装LTS后，在与运行工具相同的终端内核对node、npm、npx三个命令版本；命令找不到时，用npm prefix -g查全局目录并检查PATH；安装失败则从registry连接和权限排查，避免用sudo硬绕。最后确保环境、路径符合要求再继

本文详细介绍了Codex CLI中AGENTS.md文件的作用和存放位置的区别： 文件作用：AGENTS.md是持久化的工作约定文件，包含代码规范、测试要求等指导性内容，不同于临时对话或config.toml配置。 三级存放位置： 全局：~/.codex/AGENTS.md（用户级习惯） 仓库根：项目根目录下的AGENTS.md（项目级约定） 子目录：模块/服务目录下的AGENTS.md（模块特定

本文详细介绍了Codex CLI中AGENTS.md文件的作用和存放位置的区别： 文件作用：AGENTS.md是持久化的工作约定文件，包含代码规范、测试要求等指导性内容，不同于临时对话或config.toml配置。 三级存放位置： 全局：~/.codex/AGENTS.md（用户级习惯） 仓库根：项目根目录下的AGENTS.md（项目级约定） 子目录：模块/服务目录下的AGENTS.md（模块特定

当PowerShell修改config.toml后Codex CLI仍用旧值时，需先确认修改层级。Codex配置分用户级（个人习惯）和项目级（仓库约定），后者优先级更高。排查步骤：1) 重新打开文件确认修改未丢失；2) 检查当前会话实际读取的配置文件路径；3) 用/debug-config命令查看配置加载顺序，定位覆盖源。注意环境变量CODEX_HOME会改变用户配置路径，而项目配置需在受信任仓库

当PowerShell修改config.toml后Codex CLI仍用旧值时，需先确认修改层级。Codex配置分用户级（个人习惯）和项目级（仓库约定），后者优先级更高。排查步骤：1) 重新打开文件确认修改未丢失；2) 检查当前会话实际读取的配置文件路径；3) 用/debug-config命令查看配置加载顺序，定位覆盖源。注意环境变量CODEX_HOME会改变用户配置路径，而项目配置需在受信任仓库

摘要 /status是Codex终端交互界面(TUI)中的斜杠命令，不能在系统终端直接使用。正确使用步骤为： 在系统终端通过codex --version验证CLI可执行 在项目目录运行codex进入TUI界面 在消息输入区输入/status查看会话状态 状态摘要包含模型版本、工作目录、权限设置、Token用量和额度限制等信息。若在系统终端误输/status，应切换至TUI界面使用。官方文档提供了

摘要： 安装或升级 Codex CLI 后若在 PowerShell 中遇到命令未找到或版本未更新的问题，需按以下步骤排查： 检查命令解析 使用 Get-Command codex 确认实际执行的入口（可能被 Alias/Function 抢占）。 通过 where.exe codex 列出所有外部候选路径，优先核对安装来源（如 npm 全局目录或独立安装器路径）。 典型场景处理 入口不存在：验证