H
Hi,大家好,我是 Hal

AI 终端工具安装教程

这篇教程会带你快速上手三个主流的 AI 终端工具 —— OpenClawClaude CodeCodex。每个工具只需要几行命令就能装好,跟着步骤来就行,遇到问题直接翻下面的 FAQ。

我自己日常用的是 Claude Code + OpenClaw Skills 的组合,效率非常高。如果你还没选好,不用纠结 —— 它们可以同时装,先都试试再说。

不想自己动手?

🚀
远程安装|本地部署 One-Click
成本即资源 — 部署费用联系淘宝客服|企微客服可转化为等额的 API 调用额度

开始之前

三个工具都依赖 Node.js,先确认你的环境准备好了

检查 Node.js 版本

打开终端,运行以下命令。如果版本号 ≥ 22,你已经可以安装全部三个工具了。

terminal
$ node -v
v22.14.0  # 显示版本号即表示已安装

没有 Node.js?安装方法

根据你的操作系统选择对应的安装方式。

terminal — macOS / Linux
# 1. 安装 nvm
$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 2. 重启终端后安装 Node.js 22
$ nvm install 22

# 3. 设为默认版本
$ nvm alias default 22

# 4. 验证
$ node -v
v22.14.0
PowerShell — Windows
# 方式一:用 fnm(推荐,类似 nvm 的 Windows 版本管理器)
> winget install Schniz.fnm
> fnm install 22
> fnm default 22

# 方式二:直接下载安装包
# 访问 https://nodejs.org 下载 LTS 版本
# 双击安装,一路 Next 即可

# 验证(打开新的 PowerShell 窗口)
> node -v
v22.14.0

三步安装,开箱即用

选择你需要的工具,复制命令到终端执行即可

Hot

OpenClaw

开源 AI 终端助手,支持多模型多渠道接入,GitHub 340k+ Stars,社区生态最活跃的 AI 终端工具

  • 多模型支持 — OpenAI、Anthropic、Gemini 等一键切换
  • 多渠道接入 — 终端、微信、飞书、Telegram 等多平台
  • 插件生态 — 丰富的社区插件和自定义配置
  • 开源免费 — MIT 协议,完全开源可审计
需要 Node.js ≥ 22.14
  1. 1

    安装 OpenClaw

    🍎 macOS / Linux
    terminal
    $ npm install -g openclaw@latest
    ⊞ Windows
    PowerShell
    > npm install -g openclaw@latest
  2. 2

    运行初始化向导

    🍎 macOS / Linux
    terminal
    $ openclaw onboard --install-daemon
    ⊞ Windows
    PowerShell
    > openclaw onboard --install-daemon

    向导会引导你配置 AI 模型和 API Key,Mac 和 Windows 命令相同

  3. 3

    启动 Agent 模式

    🍎 macOS / Linux
    terminal
    $ openclaw agent
    OpenClaw Agent v2026 ready
    ⊞ Windows
    PowerShell
    > openclaw agent
    OpenClaw Agent v2026 ready
Official

Claude Code

Anthropic 官方 CLI,强大的 agentic 编程体验,直接在终端读写代码、执行命令、管理 Git

  • Agentic 编程 — 自主读写文件、执行终端命令、提交代码
  • 深度理解 — 自动分析整个项目上下文和依赖关系
  • Skills 扩展 — 支持自定义 Skill 和 MCP 工具增强能力
  • 多端可用 — CLI、桌面 App、VS Code、JetBrains 全覆盖
需要 Node.js ≥ 18
  1. 1

    安装 Claude Code

    🍎 macOS / Linux
    terminal
    # 推荐方式
    $ curl -fsSL https://claude.ai/install.sh | bash
    
    # 或者用 Homebrew
    $ brew install --cask claude-code
    ⊞ Windows
    PowerShell
    # 用 winget 一键安装
    > winget install Anthropic.ClaudeCode
    
    # 或者从官网下载安装包
    # https://claude.ai/download
  2. 2

    启动并登录

    🍎 macOS / Linux
    terminal
    $ claude
    # 首次运行会提示登录
    # 或配置 API Key
    ⊞ Windows
    PowerShell
    > claude
    # 首次运行会提示登录
    # 或配置 API Key

    可以在 console.anthropic.com 获取 API Key

  3. 3

    在项目目录中使用

    🍎 macOS / Linux
    terminal
    $ cd your-project
    $ claude
    Claude Code ready
    ⊞ Windows
    PowerShell
    > cd your-project
    > claude
    Claude Code ready
OpenAI

Codex

OpenAI 官方终端 Agent,基于 GPT 模型,ChatGPT Plus 用户可直接使用无需额外付费

  • ChatGPT 直连 — Plus/Pro/Team 用户免 API Key 直接用
  • 安全沙箱 — 在隔离环境中执行代码,防止误操作
  • 多种模式 — suggest / auto-edit / full-auto 三档可选
  • 原生二进制 — macOS/Linux/Windows 均有独立安装包
需要 Node.js ≥ 22
  1. 1

    安装 Codex

    🍎 macOS / Linux
    terminal
    $ npm install -g @openai/codex
    
    # 或者用 Homebrew
    $ brew install --cask codex
    ⊞ Windows
    PowerShell
    > npm install -g @openai/codex
    
    # 或者下载安装包
    # https://github.com/openai/codex/releases
  2. 2

    登录验证

    🍎 macOS / Linux
    terminal
    $ codex
    # 选择 Sign in with ChatGPT
    # 或设置 OPENAI_API_KEY
    ⊞ Windows
    PowerShell
    > codex
    # 选择 Sign in with ChatGPT
    # 或设置 OPENAI_API_KEY

    ChatGPT Plus/Pro/Team/Enterprise 用户可直接登录,无需 API Key

  3. 3

    开始使用

    🍎 macOS / Linux
    terminal
    $ codex "帮我创建一个 Express 服务器"
    Codex is working...
    ⊞ Windows
    PowerShell
    > codex "帮我创建一个 Express 服务器"
    Codex is working...

太难了,我不会 😵‍💫

🚀
远程安装|本地部署 One-Click
成本即资源 — 部署费用联系淘宝客服|企微客服可转化为等额的 API 调用额度

常见问题

安装过程中遇到问题?按系统分类查找答案

通用问题
怎么检查 Node.js 版本?
在终端(macOS/Linux)或 PowerShell(Windows)运行 node -v 查看当前版本。如果版本号 ≥ 22,即可安装全部三个工具。
国内网络安装太慢或失败?
设置 npm 镜像源:npm config set registry https://registry.npmmirror.com。如果是 curl 下载慢,可以考虑使用代理或者用 Homebrew / winget 方式安装。
这三个工具可以同时安装吗?
可以,它们互不冲突。唯一注意的是 Node.js 版本 —— 如果你三个都用,建议安装 Node.js 22+,这样全部兼容。
提示 API Key 无效?
Claude Code:确认 Key 来自 console.anthropic.com,且账户有余额。Codex:确认 OPENAI_API_KEY 正确,或用 ChatGPT 账号直接登录。OpenClaw:检查对应模型的 API Key 配置。

如果你不想自己配置 API Key,也可以直接使用我们内容科学的 API 接口服务 —— 开箱即用,支持 OpenAI / Anthropic / Gemini 等多模型。前往淘宝店铺了解详情
Codex 要求 Node 22 但我只有 18?
Codex 对 Node 版本要求较高,不建议降级安装。macOS/Linux 用 nvm install 22,Windows 用 fnm install 22 升级即可。
Skills 工具包和这些工具是什么关系?
Skills 是针对 OpenClaw、Claude Code、Codex 等 AI 终端工具的扩展能力包,可以增强它们的功能(如模型路由、并行调度、自动验证等)。安装好任意一个终端工具后,前往 nrkx.top/skills 用兑换码下载 Skills 即可使用。
macOS / Linux 常见问题
npm install 报权限错误?
不要用 sudo npm install -g,这会导致后续更多权限问题。推荐用 nvm 安装 Node.js,它会自动处理全局安装的权限。
什么是 nvm?一定要用吗?
nvm 是 Node Version Manager,用来管理多个 Node.js 版本。不是必须的,但强烈推荐 —— 它能避免权限问题,方便在不同项目间切换 Node 版本。安装命令见上方教程。
curl 安装报错?
macOS 原生 curl 一般不会有问题。Linux 如果是 Snap 环境的 curl(常见于 Ubuntu),用 apt install curl 安装标准版本。也可以改用 Homebrew 或 npm 方式安装。
安装后命令找不到?
可能是 npm 全局 bin 目录不在 PATH 中。运行 npm config get prefix 查看路径,然后把 对应路径/bin 加到你的 ~/.zshrc~/.bashrc 中,保存后执行 source ~/.zshrc
Windows 常见问题
npm install 报权限错误?
用管理员身份运行 PowerShell(右键 → 以管理员身份运行),或改用 fnm 管理 Node.js 版本,它会自动处理权限问题。
什么是 fnm?一定要用吗?
fnm(Fast Node Manager)是 Windows 上推荐的 Node.js 版本管理器,类似 macOS 上的 nvm。用 winget install Schniz.fnm 安装,然后 fnm install 22 即可。不是必须的,但能帮你方便地切换版本。
安装后命令找不到?
运行 npm config get prefix 查看 npm 全局路径,然后把该路径加到系统环境变量的 Path 中:设置 → 系统 → 高级系统设置 → 环境变量 → 编辑 Path。修改后需要重启 PowerShell 生效。
推荐使用什么终端?
强烈推荐 Windows Terminal + PowerShell,在 Microsoft Store 免费下载。三个工具都完美支持 Windows:Claude Code 有 winget 一键安装,Codex 和 OpenClaw 用 npm 即可。避免使用老版 cmd.exe,兼容性较差。
WSL 和原生 Windows 哪个好?
都可以。如果你熟悉 Linux 命令行,用 WSL 体验更接近 macOS/Linux,安装方式和 Linux 相同。如果不想折腾,原生 Windows + PowerShell 也完全没问题,三个工具都有 Windows 原生支持。
环境变量怎么设置 API Key?
在 PowerShell 中临时设置:$env:ANTHROPIC_API_KEY="sk-ant-xxx"。永久设置:打开系统环境变量面板,新建变量名 ANTHROPIC_API_KEYOPENAI_API_KEY,填入对应的 Key 值,然后重启 PowerShell。

三个工具怎么选?

它们各有所长,下面这张表帮你快速做决定

OpenClaw Claude Code Codex
背后公司 开源社区 Anthropic OpenAI
核心模型 多模型可选 Claude Opus/Sonnet GPT-4.1/o3/o4-mini
Node.js 要求 ≥ 22.14 ≥ 18 ≥ 22
认证方式 多家 API Key Anthropic 账号 / API Key ChatGPT 账号 / API Key
最适合 多平台集成、自定义玩法 日常编程、项目开发 ChatGPT 用户、轻量编程
开源 MIT 完全开源 部分开源 Apache 2.0 开源
Skills 扩展 插件系统 Skills + MCP 生态 有限扩展

装好工具,下一步是什么?

搭配内容科学的 Skills 工具包,让你的 AI 终端能力翻倍

已复制到剪贴板