mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-22 07:18:05 +00:00
113 lines
2.6 KiB
Markdown
113 lines
2.6 KiB
Markdown
# Codex CLI 配置
|
|
|
|
> 默认 AI CLI 路线：用 Codex CLI 作为主要编程代理，把本仓库的配置基线复制到本机 Codex Home。
|
|
|
|
## 定位
|
|
|
|
Codex CLI 是本教程默认推荐的 AI CLI。它适合承担从需求拆解、代码修改、命令执行、测试验证到 Git 提交的主流程。
|
|
|
|
OpenCode CLI 保留为备选方案：当你暂时无法使用 OpenAI / Codex CLI，或只想接入免费模型时，再使用 [OpenCode-CLI配置](./OpenCode-CLI配置.md)。
|
|
|
|
## 前置条件
|
|
|
|
请先完成：
|
|
|
|
1. [网络环境配置](./网络环境配置.md)
|
|
2. [开发环境搭建](./开发环境搭建.md)
|
|
3. [IDE 配置](./IDE配置.md)
|
|
|
|
在终端验证 Codex CLI 是否可用：
|
|
|
|
```bash
|
|
codex --help
|
|
```
|
|
|
|
如果命令不存在，先按你当前系统的 Codex CLI 安装方式完成安装，再回到本页继续。
|
|
|
|
## 登录
|
|
|
|
```bash
|
|
codex login
|
|
```
|
|
|
|
登录完成后，再次运行：
|
|
|
|
```bash
|
|
codex --help
|
|
```
|
|
|
|
能看到命令说明，就说明 CLI 已可用。
|
|
|
|
## 使用仓库配置基线
|
|
|
|
本仓库已经提供 Codex CLI 配置基线：
|
|
|
|
- `assets/config/.codex/config.toml`
|
|
- `assets/config/.codex/AGENTS.md`
|
|
|
|
在仓库根目录执行：
|
|
|
|
```bash
|
|
mkdir -p ~/.codex
|
|
cp -f assets/config/.codex/config.toml ~/.codex/config.toml
|
|
cp -f assets/config/.codex/AGENTS.md ~/.codex/AGENTS.md
|
|
```
|
|
|
|
详细说明见：[Codex 配置基线](../../../config/.codex/README.md)。
|
|
|
|
## 推荐启动方式
|
|
|
|
日常使用：
|
|
|
|
```bash
|
|
codex --search -m gpt-5.5 -c model_reasoning_effort="xhigh"
|
|
```
|
|
|
|
在完全可信的本地仓库中，需要减少确认弹窗时使用：
|
|
|
|
```bash
|
|
codex --search -m gpt-5.5 -c model_reasoning_effort="xhigh" --dangerously-bypass-approvals-and-sandbox
|
|
```
|
|
|
|
高权限模式会放开确认与沙箱限制，只能在你确认可信的目录中使用。
|
|
|
|
## 推荐别名
|
|
|
|
在 `~/.bashrc` 中添加：
|
|
|
|
```bash
|
|
alias c='codex --search -m gpt-5.5 -c model_reasoning_effort="xhigh"'
|
|
alias cy='codex --search -m gpt-5.5 -c model_reasoning_effort="xhigh" --dangerously-bypass-approvals-and-sandbox'
|
|
```
|
|
|
|
生效：
|
|
|
|
```bash
|
|
source ~/.bashrc
|
|
```
|
|
|
|
## 第一次使用
|
|
|
|
进入你的项目目录：
|
|
|
|
```bash
|
|
cd /path/to/project
|
|
codex
|
|
```
|
|
|
|
然后让 Codex 先建立项目上下文：
|
|
|
|
```text
|
|
请阅读当前仓库结构，说明这个项目是什么、关键入口在哪里、下一步最小可执行任务是什么。先给计划，不要直接改文件。
|
|
```
|
|
|
|
确认计划后，再让 Codex 执行。
|
|
|
|
## 下一步
|
|
|
|
→ [开发环境搭建](./开发环境搭建.md) - 回看基础环境
|
|
|
|
→ [IDE 配置](./IDE配置.md) - 配置编辑器
|
|
|
|
→ [OpenCode-CLI配置](./OpenCode-CLI配置.md) - Codex CLI 不可用时的备选方案
|