终端与安装环境

✳

让 AI 帮你完成配置

首次安装或切换到 XXAPI，都可以使用。

打开豆包 ↗

AI 打不开链接时，。

查看短提示词

我想通过 XXAPI 使用 安装环境，请先确认我的电脑系统（Windows / macOS / Linux）。请先阅读教程： https://docs.xxapi.ai/text/environment.txt 先确认我是首次安装还是更换服务商。能操作本机时，请先检查并备份配置，再协助完成；只能聊天时，每次带我做一步，等我反馈再继续。密钥由我在本机填写，完成后验证连接。打不开链接就告诉我，我会提供完整教程。

如果教程里的“打开终端”让你停住了，先看这一页。做完后，你能输入命令、检查软件是否安装，并找到自己的配置文件。

只需要自己的电脑。Claude Code、Codex 和 Grok Build 都有官方原生安装方式；选择这些方式时，可以直接去各自教程。Gemini CLI 的 npm 安装需要 Node.js。

1. 打开你系统里的终端

系统	怎么打开	看到什么
Windows	按 Win + R，输入 powershell 后回车	以 PS 开头的提示符
macOS	按 Command + 空格，搜索“终端”	显示当前用户与文件夹的窗口
Linux	在应用列表打开 Terminal	通常以 $ 结尾的提示符

网页中的 powershell 命令只放进 Windows PowerShell。标有 bash 的命令用于 macOS、Linux 或 WSL，不要混着执行。第一次使用 Windows，直接选 PowerShell 即可，不需要先装 WSL。

✓ 完成标志

终端打开，光标正在等待输入。

2. 先试一条无害的命令

复制下面一行到终端，按回车。

echo XXAPI

终端会在下一行输出 XXAPI。代码框里的反引号和语言名称都不需要输入。

✓ 完成标志

下一行出现 XXAPI，之后又出现新的提示符。

3. 按需要安装 Node.js

要安装 Gemini CLI，或采用 npm 安装其他工具时，先运行下面两行。

node --version
npm --version

两行都有版本号就说明已安装。本套教程建议使用当前 Node.js LTS，版本至少 22.19.0。

Windows / macOS 打开 Node.js 下载页，选择 LTS 安装包，按默认选项完成安装。Windows 保留“加入 PATH”选项，macOS 选择与 Apple 芯片或 Intel 芯片对应的安装包。

Linux 在同一下载页选择 Linux，按官方提供的安装方法操作；不要直接假设系统包管理器里的旧版本已满足要求。

装完重新开终端，再运行上面的版本检查。想查看已经全局安装了哪些工具，可运行下面一行，列表为空也正常。

npm list -g --depth=0

✓ 完成标志

node 和 npm 都能显示版本号，Node.js 版本满足目标工具要求。

4. 按需要安装 Git

需要 Git Bash 时，安装 Git for Windows，安装过程保留默认选项即可。Claude Code 在 Windows 上可直接使用 PowerShell，Git Bash 是可选功能。

安装完成后重新开终端，输入下面一行。

git --version

macOS 如果出现开发者工具安装提示，按提示完成即可。Linux 使用发行版的 Git 安装包。

✓ 完成标志

需要 Git 的工具能够找到 git，并显示版本号。

5. 找到配置文件

每个工具的设置通常放在自己的用户目录下。Windows 的 %USERPROFILE% 与 macOS / Linux 的 ~ 都表示你的用户文件夹。

工具	Windows	macOS / Linux
Claude Code	%USERPROFILE%\.claude\settings.json	~/.claude/settings.json
Codex	%USERPROFILE%\.codex\config.toml	~/.codex/config.toml
Gemini CLI	%USERPROFILE%\.gemini\settings.json	~/.gemini/settings.json
Grok Build	%USERPROFILE%\.grok\config.toml	~/.grok/config.toml

Windows 按 Win + R 粘贴文件夹路径。macOS 在访达按 Command + Shift + G 粘贴路径。Linux 文件管理器按 Ctrl + H 显示点号开头的隐藏目录。

不存在的目录可以自己创建。已有配置先复制一份备份，之后只修改教程指定的字段。

✓ 完成标志

能打开目标工具的配置目录，文件扩展名没有被保存成 .json.txt 或 .toml.txt。

6. 选择工具，继续安装

• Claude Code 适合让 Claude 阅读和修改项目。
• Codex 终端版 适合使用 GPT 编程模型。
• Gemini CLI 使用 Gemini 原生协议。
• Grok Build 也有独立的安装教程。

我习惯用 npm 安装 Claude Code 或 Codex

装好 Node.js 后，可以分别运行所需工具的命令，无需同时安装两个。

npm install -g @anthropic-ai/claude-code@latest
npm install -g @openai/codex@latest

安装完成后先检查版本，接入步骤请回到各自教程。检查版本可分别运行 claude --version 或 codex --version，只需运行自己安装的那个。看到欢迎界面仅能说明程序已经启动。

✓ 完成标志

知道接下来要使用哪一个工具，可以从它的第 1 步开始。

常见问题

Windows 提示无法加载 npm.ps1

先将命令中的 npm 换成 npm.cmd 重试，例如 npm.cmd --version。这样可以直接使用 Windows 的命令文件，不必为了安装一个工具永久放宽系统执行策略。

安装成功后，命令仍然找不到

完全关掉终端再打开。仍失败时，把报错和安装程序最后几行发给豆包或支持人员，并说明系统版本。先不要重复安装多个来源的同一个工具。

文件在 Windows 能找到，WSL 里却没有

WSL 有自己的 Linux 用户目录。在哪个环境运行工具，就修改那个环境的配置。不要把 Windows 路径原样写进 WSL。

官方文档

• Node.js 官方下载
• Git for Windows
• Claude Code 安装
• Codex 安装
• Gemini CLI 安装