跳转到主要内容

工具简介

OpenAI Codex CLI 是 OpenAI 推出的命令行编程助手,专为开发者设计的 AI 编程工具。通过配置老张API,您可以获得:

🚀 稳定服务

国内直连,无需代理

💰 灵活计费

支持按量或按次计费

⚡ GPT-5 支持

使用最新 GPT-5 模型

🔧 简单配置

几分钟完成全部设置

环境准备

必要软件

1

安装 Git

访问 Git 官网 下载并安装
Windows 用户:建议默认安装到 C 盘,使用默认设置
macOS 用户:通常已预装,可跳过此步
2

安装 Node.js

访问 Node.js 官网 下载并安装要求 Node.js 22 或更高版本
3

验证安装

打开终端验证安装是否成功:
git --version
node --version
npm --version

安装 Codex CLI

方式一:npm 安装

npm install -g @openai/codex

方式二:源码安装

# 克隆仓库
git clone https://github.com/openai/codex.git
cd codex

# 安装依赖
npm install

# 全局链接
npm link

配置老张API

1. 获取 API 密钥

  1. 访问 老张API控制台
  2. 创建新的令牌
  3. 复制密钥备用

2. 设置环境变量

  • macOS/Linux
  • Windows
编辑 ~/.zshrc~/.bashrc 文件:
# 老张API 配置
export OPENAI_API_KEY="sk-你的老张API密钥"
export OPENAI_BASE_URL="https://api.laozhang.ai/v1"
使配置生效:
source ~/.zshrc

3. 验证配置

# 验证环境变量
echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL

# 启动 Codex
codex

使用指南

基本使用

# 进入项目目录
cd ~/my-project

# 启动 Codex
codex

# 或直接提问
codex "帮我创建一个 Express 服务器"

交互模式

启动后进入交互模式:
> 请帮我优化这个函数的性能
> 为项目添加单元测试
> 解释这段代码的逻辑

常用命令

命令功能
codex启动交互模式
codex "问题"直接提问
codex --model gpt-5指定模型
codex --help查看帮助

模型选择

通过老张API,你可以使用多种模型:
模型模型 ID特点推荐场景
GPT-5gpt-5最新最强复杂编程任务
GPT-4.1gpt-4.1速度快,能力强日常开发
GPT-4.1 Minigpt-4.1-mini轻量高效简单任务
o4-minio4-mini推理增强算法问题

切换模型

# 使用 GPT-5
codex --model gpt-5 "优化这段代码"

# 使用推理模型
codex --model o4-mini "解决这个算法问题"

支持的功能

  • ✅ 代码生成和补全
  • ✅ Bug 修复和调试
  • ✅ 代码重构优化
  • ✅ 文档和注释生成
  • ✅ 测试用例编写
  • ✅ 代码解释
  • ✅ 多语言支持

支持的编程语言

Python, JavaScript/TypeScript, Java, C++, C#, Go, Rust, Swift, Kotlin, Ruby, PHP, HTML/CSS, SQL, Shell Scripts 等所有主流语言。

故障排除

检查以下配置:
  1. 环境变量是否正确设置
  2. API 密钥是否有效
  3. 网络连接是否正常
# 测试连接
curl https://api.laozhang.ai/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"
确保使用的是老张API的密钥:
  1. 访问 老张API控制台
  2. 检查密钥是否有效
  3. 确认账户余额充足
某些模型可能暂时不可用,尝试:
# 使用其他模型
codex --model gpt-4.1 "你的问题"
npm update -g @openai/codex

最佳实践

有效的提示词

✅ 好的提示:
"创建一个 Python 函数,接收 JSON 文件路径,解析并返回按日期排序的数据"
"重构这个类,使用单例模式"
"为这个 API 添加错误处理和重试机制"

❌ 避免模糊:
"写代码"
"修复 bug"

性能优化

  1. 明确需求:清晰描述可减少往返交互
  2. 提供上下文:告诉 AI 项目技术栈和约束
  3. 分步处理:复杂任务拆分为小步骤
  4. 批量处理:相关任务一次性描述

成本控制

  • 按 Token 使用量计费
  • 简单任务使用 gpt-4.1-mini 更经济
  • 查看 定价页面 了解详情

与其他工具对比

工具类型优势适合场景
Codex CLI命令行GPT-5 支持,轻量终端操作
Claude Code命令行Agent 模式强复杂重构
CursorIDE界面友好日常开发
ClineVS Code完整 AgentVS Code 用户

相关资源

需要更多帮助?请访问 老张API官网 获取支持。