Codex Console v1.1.1 超详细保姆级教程 - 从零到一完整部署指南（2026 最新版）

1
# 使用 Homebrew（推荐）
2
brew install python@3.11
3

4
# 验证安装
5
python3 --version

1
# Ubuntu/Debian
2
sudo apt update
3
sudo apt install python3.11 python3.11-venv python3-pip
4

5
# CentOS/RHEL
6
sudo yum install python3.11 python3-pip
7

8
# 验证安装
9
python3 --version

1
# 使用 Homebrew
2
brew install git
3

4
# 或使用 Xcode 命令行工具
5
xcode-select --install

1
# Ubuntu/Debian
2
sudo apt install git
3

4
# CentOS/RHEL
5
sudo yum install git
6

7
# 验证
8
git --version

1
# 选择安装目录（Windows 示例：D:\tools\codex-console）
2
cd /tmp  # Linux/Mac
3

4
# 克隆项目
5
git clone https://github.com/dou-jiang/codex-console.git
6

7
# 进入项目目录
8
cd codex-console
9

10
# 查看项目结构
11
ls -la

1
# Python 3.10+ 内置 venv 模块
2
python -m venv .venv
3

4
# 激活虚拟环境
5
# Windows (CMD):
6
.venv\Scripts\activate
7

8
# Windows (PowerShell):
9
.venv\Scripts\Activate.ps1
10

11
# Linux/Mac:
12
source .venv/bin/activate

1
# 方式 1：使用 pip（通用）
2
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
3

4
# 方式 2：使用 uv（更快，推荐）
5
# 先安装 uv
6
pip install uv
7

8
# 使用 uv 安装依赖
9
uv pip install -r requirements.txt

1
pip list | grep -E "(fastapi|uvicorn|playwright)"

1
# 安装浏览器
2
playwright install
3

4
# 安装系统依赖（Linux）
5
playwright install-deps

1
# 复制环境变量模板
2
cp .env.example .env
3

4
# 编辑配置文件（选择你熟悉的编辑器）
5
# Windows: 用记事本打开 .env
6
# Linux/Mac: nano .env 或 vim .env

1
# 方式 1：默认启动（127.0.0.1:8000）
2
python webui.py
3

4
# 方式 2：指定主机和端口（允许外部访问）
5
python webui.py --host 0.0.0.0 --port 8000
6

7
# 方式 3：设置访问密码
8
python webui.py --access-password your_password
9

10
# 方式 4：组合参数（推荐）
11
python webui.py --host 0.0.0.0 --port 8000 --access-password your_password
12

13
# 方式 5：调试模式（开发使用）
14
python webui.py --debug

1
# Ubuntu/Debian
2
curl -fsSL https://get.docker.com -o get-docker.sh
3
sudo sh get-docker.sh
4
sudo systemctl enable docker
5
sudo systemctl start docker
6

7
# 验证安装
8
docker --version
9
docker compose version

1
# 克隆项目
2
git clone https://github.com/dou-jiang/codex-console.git
3
cd codex-console
4

5
# 启动服务
6
docker compose up -d
7

8
# 查看日志
9
docker compose logs -f
10

11
# 停止服务
12
docker compose down