跳转到主要内容
使用之前，请先运行以下命令安装或更新： 
npm install -g @openai/codex

​
配置步骤

​
1. 环境变量设置

**打开你的 Shell 配置文件（例如 .zshrc或 ** .bashrc），添加以下环境变量： 
export OPENAI_BASE_URL="https://aihubmix.com/v1"
export OPENAI_API_KEY="sk-***" # 替换为你的 AiHubMix API 密钥
**这里的 OPENAI_API_KEY应该使用 AiHubMix 的 密钥，变量名保持为 **OPENAI_API_KEY是为了兼容 OpenAI 原生客户端。。
不想手动配置环境变量？可使用图形化工具快速设置：通过 CC-Switch 可视化配置。

​
2. 应用配置更改

在终端中执行以下命令，使环境变量生效： 
source ~/.zshrc  # 如果使用 zsh
# 或
source ~/.bashrc  # 如果使用 bash

​
3. 启动 Codex CLI

**定位到你的项目目录，然后运行 **codex命令： 
cd /你的项目路径
codex
图片

​
4. 使用自然语言执行任务

现在你可以通过自然语言向 Codex CLI 输入指令，例如： 
# 示例输入
讲解一下 AnimatedText
图片

​
通过 cc-switch 配置

  1. 运行 CC-Switch，点击「添加供应商」。
install
  1. 在预设列表中选择「AiHubMix」。
install
  1. 在「API Key」栏中填写你的密钥并点击「添加」保存设置。
install
  1. 返回首页，在供应商列表中选择「AiHubMix」，点击「启动」即可使用。
install

​
高级配置

  • 默认模型为 codex-mini-latest，一个专为编码任务微调过的 o4-mini，可以在 ~/.codex/config.json修改
  • 目前仅支持 OpenAI 家的模型，模型列表可在 Responses API 文档 中查看
  • 你可以通过编辑 ~/.codex/instructions.md 文件来自定义系统提示词，定制 AI 助手的行为

​
实用命令参考

​
帮助命令

codex -h

​
完整命令选项

Usage
  $ codex [options] <prompt>

Options
  -h, --help                 显示帮助信息并退出
  -m, --model <model>        指定使用的模型 (默认: codex-mini-latest)
  -i, --image <path>         包含图像输入的文件路径
  -v, --view <rollout>       查看之前保存的会话记录
  -q, --quiet                非交互模式，仅打印助手的最终输出
  -a, --approval-mode <mode> 覆盖审批策略: 'suggest', 'auto-edit', 或 'full-auto'

  --auto-edit                自动批准文件编辑；仍会提示确认命令
  --full-auto                自动批准沙箱环境中的编辑和命令

  --no-project-doc           不自动包含仓库中的 'codex.md' 文件
  --project-doc <file>       包含指定的 Markdown 文件作为上下文
  --full-stdout              不截断命令输出的 stdout/stderr

危险选项
  --dangerously-auto-approve-everything
                             跳过所有确认提示并直接执行命令（无沙箱保护）
                             仅用于临时本地测试环境

实验性选项
  -f, --full-context         以"完整上下文"模式启动，将整个仓库加载到上下文中
                             并在一次操作中应用批量编辑
                             仅兼容 --model 参数

示例
  $ codex "编写并运行一个打印 ASCII 艺术的 Python 程序"
  $ codex -q "修复构建问题"