命令行工具

CLI 模式概览

Codex 提供了多种命令行模式，适用于不同的使用场景。无论是交互式开发还是自动化脚本，CLI 都能满足需求。

基础命令

# 启动交互式会话
claude

# 查看帮助
claude --help

# 查看版本
claude --version

命令行选项

管道模式

管道模式允许您将其他命令的输出通过管道传递给 Codex：

基本管道使用

# 将命令输出传递给 Codex 进行分析
git diff | claude -p "审查这些代码变更"

# 分析日志文件
cat error.log | claude -p "分析这些错误日志，找出根本原因"

# 处理 JSON 数据
curl https://api.example.com/data | claude -p "将这个 JSON 转换为 TypeScript 类型"

管道模式的高级用法

# 分析多个文件
cat src/*.ts | claude -p "检查这些文件中的安全漏洞"

# 结合 find 和 xargs
find src -name "*.ts" -exec cat {} \; | claude -p "分析代码质量"

# 实时日志分析
tail -f server.log | claude -p "监控日志中的错误"

非交互模式

一次性命令执行

使用 -p 参数直接传入提示词，适合脚本和自动化：

# 一次性执行
claude -p "解释什么是 React Server Components"

# 从文件读取提示词
claude -p "$(cat prompt.txt)"

# 带上下文执行
claude -p "优化这个文件" < src/utils.ts

执行模式

使用 --execute 参数让 Codex 自动执行命令：

# 自动执行模式
claude --execute "安装依赖并启动项目"

# 执行并退出
claude --execute "修复所有 ESLint 错误" --exit

# 限制执行步骤
claude --execute "部署到服务器" --max-steps 10

Shell 集成

Bash 函数集成

在 ~/.zshrc 或 ~/.bashrc 中添加以下函数：

# Codex 便捷函数
cx() {
  claude -p "$*"
}

# 代码审查函数
review() {
  git diff HEAD | claude -p "审查以下代码变更：$*"
}

# 错误分析函数
explain() {
  claude -p "解释以下错误并给出修复建议：$*"
}

# 代码优化函数
optimize() {
  cat "$1" | claude -p "优化这个代码文件"
}

使用示例：

cx "Vite 和 Webpack 有什么区别"
review "检查是否有潜在的安全问题"
explain "TypeError: Cannot read property 'map' of undefined"
optimize src/components/List.tsx

Zsh 插件

创建 Zsh 插件以增强 Codex 的使用体验：

# ~/.oh-my-zsh/custom/plugins/claude-code/claude-code.plugin.zsh
alias c="claude"
alias cr="claude --review"
alias ce="claude --execute"
alias ci="claude --interactive"
alias c.="claude -p '$(git diff)'"

脚本自动化

Shell 脚本中使用

#!/bin/bash
# auto-fix.sh — 自动修复代码问题

echo "分析代码..."
claude --execute "检查并修复 src/ 目录下的所有 TypeScript 类型错误" --exit

if [ $? -eq 0 ]; then
  echo "修复完成，运行测试..."
  npm test
else
  echo "修复失败，请手动检查"
  exit 1
fi

CI/CD 脚本集成

#!/bin/bash
# ci-check.sh — CI 代码检查

# 安装 Codex
npm install -g @anthropic-ai/claude-code

# 执行代码审查
claude --execute "
1. 运行 lint 检查
2. 修复所有可自动修复的问题
3. 运行测试确保修改正确
" --exit --max-steps 20

Node.js 脚本调用

// run-codex.js
const { execSync } = require("child_process");

const prompt = "为这个项目添加 README 文档";
const result = execSync(`claude -p "${prompt}" --exit`, {
  encoding: "utf-8",
  maxBuffer: 10 * 1024 * 1024,
});

console.log(result);

输出格式控制

控制输出详细程度

# 简洁输出
claude -p "列出文件" --quiet

# JSON 格式输出
claude -p "分析项目结构" --format json

# 仅输出代码
claude -p "生成一个 React 组件" --code-only

输出重定向

# 保存输出到文件
claude -p "生成项目文档" > docs.md

# 追加到文件
claude -p "添加 API 文档" >> docs.md

# 管道到其他工具
claude -p "列出所有依赖" | jq '.dependencies'