中国站
帮助中心 > 人工智能 > 大模型服务 > 第三方工具调用 > Codex CLI 配置使用教程

Codex CLI 配置使用教程

1. 安装Windows Terminal

  1. - Windos 里面使用Codex cli 建议使用 Windows Terminal 进行替代终端cmd 启动Codex cli
  2. - Windows Terminal 在使用和多开窗口上更加舒适和方便。
  3. - Windows Terminal 下载地址为:https://github.com/microsoft/terminal/releases/tag/v1.23.20211.0 需要魔法才能打开。
  4. - Windows Terminal 国内免魔法网盘下载地址:https://www.ilanzou.com/s/MzWnpE05

2. 安装 Node.JS 配置环境

(如果已安装过可以跳过) 检查是否安装命令:node -v
1、安装Node.js 需要node20+以上版本 下载软件包进行安装:https://nodejs.org/en/download 一路点下一步到图片的位置注意勾选一下就行啦。

  • 安装好了之后,在终端输入验证安装:node -v 验证安装查看是否安装成功?如果安装成功会显示版本号

特殊情况说明:

  • 1、如果没有安装 node.js 的话会出现以下图片情况报错或者之前有安装过的但是配置环境有问题的
  • 需要重新下载再安装一次!重新打开终端就行。

  • 如果在输入终端启动codex的时候发现里面出现脚本禁止运行脚本报错?

  • codex:无法加载文件C:\Users\Adminis因为在此系统上禁止运行脚本。
  • 解决办法:请在终端运行以下命令来更改执行策略然后重新打开新终端:
  • Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 安装 Codex Cli

  • 在终端输入命令 npm i -g @openai/codex 进行安装
  • 如果遇上安装不上下载失败等情况 或者没有魔法的 大部分是因为网络环境问题,可以尝试使用国内镜像源下载。
  • 在终端输入:npm config set registry https://registry.npmmirror.com 指定镜像源然后再到终端执行
  • npm i -g @openai/codex进行下载
  • 验证安装: codex —version 显示有版本号就代表安装成功了

4. 配置 Codex Cli

先编辑下配置文件(如果没有就新建,存在的话就覆盖)

  • Mac/Linux 的在 ~/.codex/config.toml
  • Windows 的在 C:\users\你的用户名.codex\config.toml
    • 如果不生效,可以尝试在当前工作空间 .codex 文件夹下,创建或者覆盖配置文件 config.toml 和 auth.json 如果目录下已经有 config.toml 文件和 auth.json 文件就直接替换以下内容
      config.toml直接粘贴或者覆盖为以下配置
  1. model = "gpt-5.4"
  2. model_reasoning_effort = "xhigh"
  3. disable_response_storage = true
  4. sandbox_mode = "danger-full-access"
  5. windows_wsl_setup_acknowledged = true
  6. approval_policy = "never"
  7. profile = "auto-max"
  8. file_opener = "vscode"
  9. model_provider = "codex"
  10. web_search = "cached"
  11. suppress_unstable_features_warning = true
  12. [history]
  13. persistence = "save-all"
  14. [tui]
  15. notifications = true
  16. [shell_environment_policy]
  17. inherit = "all"
  18. ignore_default_excludes = false
  19. [sandbox_workspace_write]
  20. network_access = true
  21. [features]
  22. plan_tool = true
  23. apply_patch_freeform = true
  24. view_image_tool = true
  25. unified_exec = false
  26. streamable_shell = false
  27. rmcp_client = true
  28. elevated_windows_sandbox = true
  29. [profiles.auto-max]
  30. approval_policy = "never"
  31. sandbox_mode = "workspace-write"
  32. [profiles.review]
  33. approval_policy = "on-request"
  34. sandbox_mode = "workspace-write"
  35. [notice]
  36. hide_gpt5_1_migration_prompt = true
  37. [model_providers.codex]
  38. name = "codex"
  39. base_url = "http://domainxxx.com/v1"
  40. wire_api = "responses"
  41. requires_openai_auth = true

auth.json 直接粘贴或者覆盖为以下配置

  1. {
  2. "OPENAI_API_KEY": "这里填入在我们后台的你自己生成的KEY为pk_live_mm开头的密钥"
  3. }

然后打开就能自动登录Codex cli了

5.启动 Codex Cli

  • 终端输入:codex —dangerously-bypass-approvals-and-sandbox
  • 或者codex —yolo 这两条命令随便哪条命令都可以
  • 这是免安全审批的Codex的启动命令(就是不需要批准自动执行)