EasyCode命令到底粘贴到哪里
Windows 的安装和启动命令粘贴到命令提示符（CMD），标注 PowerShell 的配置命令粘贴到 PowerShell；Mac 粘贴到“终端”；Linux 粘贴到终端或 SSH 窗口。不要粘到浏览器地址栏、EasyCode 网页或软件聊天框中。标注“在 Codex 对话框里输入”的内容才是发给 AI 的问题。
node、npm 或 codex 不是内部命令 / command not found
关闭旧终端，重新打开再试。Node.js 的安装要在输入 npm 之前完成。Windows 在命令提示符（CMD）中运行 npm 和 codex；Mac / Linux 参考系统教程中的 PATH 或安装输出。
Windows 提示 npm.ps1 禁止运行脚本
从开始菜单搜索 cmd，打开“命令提示符”，执行 npm install -g @openai/codex，之后输入 codex 启动。
Mac 安装提示 EACCES
打开 Mac 教程 的第 3 步，按“仅遇到 EACCES 时执行”的命令设置用户目录，再重新安装。
提示缺少 EASYCODE_API_KEY
当前软件没拿到密钥。返回系统教程的“设置密钥”一步，在启动 Codex 的同一个终端设置后重试。桌面 / VS Code 用户还需要完全退出软件再打开。
配置文件在哪里？怎么避免 .txt 后缀
Windows 按教程用记事本打开 %USERPROFILE%\.codex\config.toml，另存为时选“所有文件”。文件资源管理器中开启“查看 → 文件扩展名”，确认名称不是 config.toml.txt。Mac / Linux 按教程用 nano 编辑。
一直让我登录官方账户
检查 config.toml 是否保存到正确用户目录，顶部是否有 model_provider = "easycode"，并确认没有重复定义。如果不确定，回到系统教程的“配置文件”步骤逐项核对。
401 / invalid API key / 认证失败
重新复制本站密钥的完整密钥，替换整段示例文字。检查密钥是否启用、是否过期，有没有多加一个 sk- 或带入空格。不要填写登录密码。
403 / 404 / 无可用渠道或模型
确认密钥选择了教程的 Codex-Pro 或可用 Codex-Plus 分组，模型填的是 gpt-6.1-sol，地址为 https://easycodesi.com/v1。工具使用 Responses；多填 /v1 或填错模型名都可能失败。
429 / 额度不足或请求过多
先到 兑换 查看当前余额，再到 API 密钥 检查密钥状态、额度限制和有效期。余额不足时，从“兑换码购买”购买余额码，再回到“兑换”使用。并发或请求频率受限时，先停下连续重试，等待后再发一个简短请求。
5xx / 超时 / 回复到一半中断
保留发生时间和错误文字，检查本站日志，稍后重试一次。反复重试前先确认之前的任务是否已经产生用量。
下载页全是英文，看不懂选哪个
打开 软件下载与安装包选择 对照系统、芯片、文件后缀。GitHub 发布页往下找 Assets；不要把 Source code 当成安装程序。
还是卡住，求助时发什么
提供：电脑系统、你打开的是哪篇教程、做到第几步、错误文字或遮住密钥后的截图。不要发送密码、完整密钥或包含密钥的配置文件。