跳到主要内容

CodexCLI 安装教程（Linux）

前置：安装 Node.js​

先装 Node.js（建议 22+）：Nodejs Linux

安装 Codex​

第一步：打开终端

第二步：执行安装命令

npm install -g @openai/codex

第三步：验证安装

codex --version

如果看到版本号，说明安装成功了。

配置 Codex（接入Constreet）​

2.1 配置文件在哪里？​

Codex 配置目录：~/.codex/

什么意思？

  • ~ 表示你的用户主目录
  • 完整路径是：/home/你的用户名/.codex/

需要创建两个配置文件：

  • config.toml - 主配置文件
  • auth.json - 认证信息

2.2 创建配置目录​

mkdir -p ~/.codex

2.3 写入主配置文件 config.toml​

cat > ~/.codex/config.toml <<'EOF'model_provider = "Constreet"model = "gpt-5.2-codex"approval_policy = "on-request"[model_providers.Constreet]name = "Constreet"base_url = "https://api.constreet.cc/v1"wire_api = "responses"requires_openai_auth = trueEOF

配置说明：

  • model_provider - 使用的服务提供商（这里是 Constreet）
  • model - 默认使用的模型
  • approval_policy - 执行代码前是否需要确认（on-request 表示需要）
  • base_url - Constreet的服务地址
  • wire_api - 使用 OpenAI 兼容格式

2.4 写入认证文件 auth.json（注意替换 API Key）​

cat > ~/.codex/auth.json <<'EOF'{  "OPENAI_API_KEY": "你的Constreet Key"}EOF

必须替换：把 你的Constreet Key 替换成你从Constreet官网复制的真实 Key

如何替换？

  1. 复制上面整段命令
  2. 把 你的Constreet Key 这几个字替换成你的真实 Key
  3. 然后粘贴到终端执行

2.5 验证配置文件是否创建成功​

ls -la ~/.codex

应该能看到 config.toml 和 auth.json 两个文件。

可选：查看配置文件内容

cat ~/.codex/config.toml

启动并验证​

第一步：进入你的项目目录

cd /path/to/your/project

把 /path/to/your/project 替换成你实际的项目路径。

第二步：启动 Codex

codex

如果配置正确，Codex 会启动并连接到Constreet。

常见问题​

提示找不到 codex 命令​

原因：全局包路径没有加到 PATH 环境变量里。

解决方法：

  1. 检查 Node.js 是否正确安装：node -v
  2. 重启终端
  3. 如果还不行，重新安装 Codex

配置文件写入失败​

原因：可能是权限问题或路径不存在。

解决方法：

  1. 手动创建目录：mkdir -p ~/.codex
  2. 然后再执行配置文件写入命令

API 调用失败​

原因：API Key 不正确，或者Constreet账户余额不足。

解决方法：

  1. 检查 auth.json 文件是否正确：cat ~/.codex/auth.json
  2. 确认 API Key 是否正确（注意不要有多余的空格）
  3. 登录Constreet官网检查账户余额