OpenAI Codex 使用指南

介绍 Codex 在电脑上的安装以及配置访问 Ya Code。

介绍

Codex 是 OpenAi 开发人工智能编程代理（AI Coding Agent），主要分为：

• Codex CLI 终端版本的 Codex，无GUI，主攻编码
• Codex Desktop 带GUI的独立应用程序，全方位助理提升工作效率

Codex Desktop 安装

访问官网安装下载

个别地区访问需要VPN，推荐使用：

赔钱机场立即前往 →

其它配置同 Codex CLI

Codex CLI 安装配置

必要要求

• 安装了 Node.js 18.x 以上的版本
• Windows 用户推荐使用 WSL2
  • 若使用 PowerShell，建议安装 PowerShell 7.x
• 已在 Ya Code 创建访问密钥

检查环境：

node -v

安装 Codex CLI

npm install -g @openai/codex

# 如果无法访问执行下列命令
npm install -g @openai/codex --registry https://registry.npmmirror.com

验证：

codex --help
codex --version

Windows PowerShell 如遇脚本执行策略限制，使用：

codex.cmd

# 或者使用管理员模式运行命令永久更改执行策略
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

WARNING

在 Windows 下安装或运行时发生报错，请使用以管理员方式运行的 cmd 或 PowerShell。

配置 Ya Code

手动配置文件位置：

• macOS / Linux / WSL：~/.codex/config.toml
• Windows：%USERPROFILE%\.codex\config.toml

config.toml:

model_provider = "yacode"
model = "gpt-5.6-terra" # 默认模型，后续可以切换
model_reasoning_effort = "xhigh"
disable_response_storage = true

[model_providers.yacode]
name = "Ya Code"
base_url = "https://yacode.xyz"
wire_api = "responses"
requires_openai_auth = true

访问密钥放在同目录 auth.json：

{
  "OPENAI_API_KEY": "sk-xxx"
}

TIP

如果没有 .codex 文件夹，可以手动创建

常用命令

# 交互模式，通过多轮对话完成复杂任务
codex

# 非交互模式，适用于程序化执行任务
codex exec "任务描述"
codex exec --full-auto "任务描述" # 允许修改工作区

交互模式常用命令：

• @文件名：引用文件
• $skill：使用技能
• /model：切换模型与推理参数
• /plan：切换计划模式
• /approvals：设置批准策略
• /permissions：配置命令权限
• /review：代码审查
• /diff：查看当前差异
• /status：查看模型、沙盒、token 等状态
• /init：生成 AGENTS.md
• /mcp：查看 MCP 工具
• /exit 或 /quit：退出

使用安全

Codex 共有两类安全规则：

• approval_policy：什么时候需要确认
• sandbox_mode：命令能访问哪些资源

config.toml配置：

# 只读模式
sandbox_mode = "read-only"
approval_policy = "never"

# 写入模式（推荐默认设置这个）
sandbox_mode = "workspace-write"
approval_policy = "on-request"

# 写入模式带网络访问
[sandbox_workspace_write]
network_access = true

命令行临时切换模式：

# 只读模式
codex --sandbox read-only --ask-for-approval on-request

# 工作区写入模式
codex --sandbox workspace-write --ask-for-approval on-failure

# 危险模式（不推荐）；此模式下禁用沙盒
# AI执行不会询问用户，如必须使用请确保文件内无恶意提示词注入
codex --sandbox danger-full-access --ask-for-approval never

推荐 toml 中配置推荐设置，有临时需求通过命令行切换

常见问题

command not found

• 重新打开终端。
• 检查 npm 全局路径是否在环境变量中。
  • npm config list 查看全局包安装位置

Windows 乱码

• 使用 WSL2
• 使用 PowerShell 7.x