ACORG docs

主题

安装 Codex 与 Claude Code ​

本页用于快速准备两个常用终端 Agent。更完整的产品说明见 Codex CLI 和 Claude Code。

环境要求 ​

  • 已安装 Node.js 22.x LTS 与 npm
  • 终端可访问 npm registry
  • 已准备 ChatGPT / OpenAI 账号或 Claude / Anthropic 账号

安装 Codex ​

推荐先使用 npm 全局安装:

bash
npm install -g @openai/codex
codex --version

也可以按官方 README 使用安装脚本或 GitHub Release。不同安装方式不要混用,否则升级和 PATH 排查会更麻烦。

安装 Claude Code ​

bash
npm install -g @anthropic-ai/claude-code
claude --version

首次登录 ​

进入任意项目目录后启动:

bash
cd your-project
codex
bash
cd your-project
claude

按提示登录账号或配置 API Key。建议先在一个小项目里试运行,确认能读取文件、生成计划并执行简单命令。

建议验证 ​

bash
node -v
npm -v
codex --version
claude --version

在项目目录中验证:

bash
codex "阅读项目结构并总结构建命令"
claude "阅读项目结构并总结构建命令"

如果命令行工具需要访问外部文档、浏览器或 IDE,再继续配置 IDEA MCP 或 MCP 全流程选择指南。

升级 ​

bash
npm update -g @openai/codex
npm update -g @anthropic-ai/claude-code

升级后重新打开终端并再次运行 --version。如果使用安装脚本或 Release 安装,按对应项目的最新 README 重新安装。

常见问题 ​

command not found ​

检查 npm 全局 bin 目录是否在 PATH 中:

bash
npm config get prefix

Windows 建议重新打开 PowerShell;macOS / Linux 检查 ~/.zshrc 或 ~/.bashrc。

npm 全局安装权限错误 ​

优先使用 nvm / nvm-windows 管理 Node.js,避免直接用管理员权限污染系统 Node。已经出现权限问题时,先确认 npm config get prefix 指向当前用户目录。

两个 CLI 是否必须都安装 ​

不是。只使用 OpenAI 生态时可先装 Codex;主要使用 Claude 时可先装 Claude Code。两者都安装的价值在于复杂任务可以交叉验证。

相关文档 ​

下一步 ​

继续安装 CC Switch。