Codex 与 Claude Code 安装配置完整教程（Windows/Mac/Linux）

薛定猫AI2026-05-12 11:00

本文整合 Codex 与 Claude Code 两款 AI 编程助手的安装、配置及使用教程，覆盖 Windows、Mac、Linux 三大主流系统，严格遵循官方代码配置，适合各类开发者快速上手使用。

目录：

  1. Codex 安装与配置教程（全系统）

  2. Claude Code 安装与使用教程（全系统）

  3. 常见问题汇总（通用+专属）

一、Codex 安装与配置教程

Codex 是 OpenAI 推出的强大 AI 编程助手，可通过终端、VSCode 插件等方式使用，以下是全系统详细安装配置步骤。

（一）Windows 版本教程

1. 系统要求

  • Windows 10 或 Windows 11

  • Node.js 22+

  • npm 10+

  • 稳定网络连接

2. 安装步骤

前置步骤（必做）

安装 Git Bash，请访问 Git - Downloads 下载对应您电脑系统的版本，之后一直点击"下一步"即可完成安装。

步骤1：安装 Node.js

访问 Node.js 官网 下载并安装最新 LTS 版本。

步骤2：安装 codex

打开命令提示符 (CMD) 或 PowerShell，运行以下命令：

bash 复制代码 
npm install -g @openai/codex
步骤3：验证安装

打开命令提示符 (CMD) 或 PowerShell，运行以下命令，若能显示版本号则安装成功：

bash 复制代码 
codex --version

3. 配置 API

步骤1：获取 Auth Token

访问 xuedingmao.com 站点页面进行以下操作：

  • 点击 **控制台 → API令牌** 页面

  • 点击 **添加令牌**

  • 令牌分组请选择：**codex专属**（务必选择此分组，否则无法使用）

  • 令牌名称随意

  • 额度建议：设置为 **无限额度**

  • 其他选项保持默认

参考截图：令牌创建页面

步骤2：配置文件

重要提示：请将下方的 `sk-xxx` 替换为您在 xuedingmao.com 生成的实际 API 密钥！（重复3次，务必注意）

  1. 进入当前用户的用户目录下的 `.codex` 文件夹中，例如：`C:\Users\testuser\.codex`。（注意：如果看不到该目录，说明您没有打开 Windows 的"显示隐藏的项目"，请先在文件资源管理器中开启。）

  2. 参考截图：显示隐藏目录

  3. 如果没有 `.codex` 文件夹，请手动创建该文件夹，然后在其中创建 `config.toml` 以及 `auth.json` 两个文件。

  4. 参考截图：.codex 目录文件

  5. 填写配置（需将 `sk-xxx` 替换成您自己创建的真实 SK）：

a. `auth.json` 中的配置：

json 复制代码 
{"OPENAI_API_KEY": "sk-xxx"}

b. `config.toml` 中的配置（直接粘贴下面的内容即可）：

`model_reasoning_effort` 可选值为 `high`, `medium`, `low`，分别代表模型思考的努力程度（高、中、低）。

toml 复制代码 
model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://xuedingmao.com/v1"
wire_api = "responses"

4. 启动 codex

重启终端！重启终端！重启终端！（重要操作，否则配置不生效）

然后进入到您的工程目录：

bash 复制代码 
cd your-project-folder

运行以下命令启动：

bash 复制代码 
codex

参考截图：Codex 启动界面

5. VSCode 插件 codex

以上配置完成后，在 VSCode 扩展商店中搜索并安装 `codex` 即可，安装完成后会出现在侧边栏。

参考截图1：VSCode 插件搜索

参考截图2：插件侧边栏显示

（二）Mac 版本教程

1. 系统要求

  • macOS 12 或更高版本

  • Node.js 22+

  • npm 10+

  • 稳定网络连接

2. 安装步骤

步骤1：安装 Node.js（两种方式，推荐方式二）

  • 方式一：直接访问 Node.js 官网 下载并安装最新 LTS 版本。

  • 方式二：使用 Homebrew（推荐）

bash 复制代码 
# 如果尚未安装 Homebrew，请先运行此命令
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node
步骤2：安装 codex

打开终端 (Terminal)，运行（可能需要加 `sudo`）：

bash 复制代码 
npm install -g @openai/codex
步骤3：验证安装

打开终端 (Terminal)，运行以下命令，若能显示版本号则安装成功：

bash 复制代码 
codex --version

3. 配置 API

步骤1：获取 Auth Token

访问 xuedingmao.com 站点页面进行以下操作：

  • 点击 **控制台 → API令牌** 页面

  • 点击 **添加令牌**

  • 令牌分组请选择：**codex特供**（务必选择此分组，否则无法使用）

  • 令牌名称随意

  • 额度建议：设置为 **无限额度**

  • 其他选项保持默认

参考截图：令牌创建页面

步骤2：配置文件

重要提示：请将下方的 `sk-xxx` 替换为您在 xuedingmao.com 生成的实际 API 密钥！（重复3次，务必注意）

  1. 创建目录和文件，打开终端运行以下命令：
bash 复制代码 
mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
  1. 编辑 `auth.json` 文件：
bash 复制代码 
vi ~/.codex/auth.json

按 `i` 进入插入模式，粘贴以下内容（将 `sk-xxx` 替换为您的密钥），然后按 `ESC` 键，输入 `:wq` 并回车保存退出。

json 复制代码 
{"OPENAI_API_KEY": "sk-xxx"}
  1. 编辑 `config.toml` 文件：
bash 复制代码 
vi ~/.codex/config.toml

按 `i` 进入插入模式，粘贴以下内容，然后按 `ESC` 键，输入 `:wq` 并回车保存退出。

toml 复制代码 
model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://xuedingmao.com/v1"
wire_api = "responses"

4. 启动 codex

重启终端！重启终端！重启终端！（重要操作，否则配置不生效）

然后进入到您的工程目录：

bash 复制代码 
cd your-project-folder

运行以下命令启动：

bash 复制代码 
codex

5. VSCode 插件 codex

以上配置完成后，在 VSCode 扩展商店中搜索并安装 `codex` 即可，安装完成后会出现在侧边栏。

（三）Linux 版本教程

1. 系统要求

  • 主流 Linux 发行版 (Ubuntu 20.04+, Debian 10+, CentOS 7+, etc.)

  • Node.js 22+

  • npm 10+

  • 稳定网络连接

2. 安装步骤

步骤1：安装 Node.js（分发行版）
  • Ubuntu/Debian
bash 复制代码 
sudo apt update
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
  • CentOS/RHEL/Fedora
bash 复制代码 
# 使用 dnf (Fedora) 或 yum (CentOS/RHEL)
sudo dnf install nodejs npm
# 或
sudo yum install nodejs npm
  • Arch Linux
bash 复制代码 
sudo pacman -S nodejs npm
步骤2：安装 codex

打开终端 (Terminal)，运行：

bash 复制代码 
sudo npm install -g @openai/codex
步骤3：验证安装

打开终端 (Terminal)，运行以下命令，若能显示版本号则安装成功：

bash 复制代码 
codex --version

3. 配置 API

步骤1：获取 Auth Token

访问 xuedingmao.com 站点页面进行以下操作：

  • 点击 **控制台 → API令牌** 页面

  • 点击 **添加令牌**

  • 令牌分组请选择：**codex渠道-gpt**（务必选择此分组，否则无法使用）

  • 令牌名称随意

  • 额度建议：设置为 **无限额度**

  • 其他选项保持默认

步骤2：配置文件

重要提示：请将下方的 `sk-xxx` 替换为您在 xuedingmao.com 生成的实际 API 密钥！（重复3次，务必注意）

  1. 创建目录和文件，打开终端运行以下命令：
bash 复制代码 
mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
  1. 编辑 `auth.json` 文件：
bash 复制代码 
vi ~/.codex/auth.json

按 `i` 进入插入模式，粘贴以下内容（将 `sk-xxx` 替换为您的密钥），然后按 `ESC` 键，输入 `:wq` 并回车保存退出。

json 复制代码 
{"OPENAI_API_KEY": "sk-xxx"}
  1. 编辑 `config.toml` 文件：
bash 复制代码 
vi ~/.codex/config.toml

按 `i` 进入插入模式，粘贴以下内容，然后按 `ESC` 键，输入 `:wq` 并回车保存退出。

toml 复制代码 
model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://xuedingmao.com/v1"
wire_api = "responses"

4. 启动 codex

重启终端！重启终端！重启终端！（重要操作，否则配置不生效）

然后进入到您的工程目录：

bash 复制代码 
cd your-project-folder

运行以下命令启动：

bash 复制代码 
codex

参考截图：Codex 启动界面

5. VSCode 插件 codex

以上配置完成后，在 VSCode 扩展商店中搜索并安装 `codex` 即可，安装完成后会出现在侧边栏。

参考截图1：VSCode 插件搜索

参考截图2：插件侧边栏显示

二、Claude Code 安装与使用教程

Claude Code 是 Anthropic 推出的强大 AI 编程助手，可直接在终端中与 AI 协作编程，以下是全系统安装使用步骤。

（一）系统要求

  • Node.js 版本 ≥ 18.0

  • 支持的操作系统：macOS、Linux、Windows (WSL)

  • 稳定网络连接

（二）快速开始

1. 安装 Node.js

提示：如果您已经安装了 Node.js 18.0 或更高版本，可以跳过此步骤。

Ubuntu / Debian 用户
bash 复制代码 
# 安装 Node.js LTS 版本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# 验证安装
node --version
macOS 用户
bash 复制代码 
# 安装 Xcode 命令行工具
sudo xcode-select --install

# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 通过 Homebrew 安装 Node.js
brew install node

# 验证安装
node --version
Windows (WSL) 用户

参考 Ubuntu / Debian 用户安装步骤，在 WSL 终端中执行对应命令即可。

2. 安装 Claude Code

使用 npm 全局安装 Claude Code，打开终端运行以下命令：

bash 复制代码 
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

3. 配置并开始使用

步骤1：获取必要的配置信息

您需要准备两个重要的配置项，具体说明如下：

配置项 说明 获取方式
ANTHROPIC_AUTH_TOKEN API 认证令牌 注册后在 `API令牌` 页面点击 `添加令牌` 获得（以 `sk-` 开头）
ANTHROPIC_BASE_URL API 服务地址 使用 `https://xuedingmao.com`（与主站地址相同）

创建令牌时的建议设置：

  • 名称：随意命名

  • 额度：设为无限额度

  • 分组：选择Claude code专属或者官转克劳德3及以上

  • 其他选项：保持默认设置

步骤2：启动 Claude Code

首先进入您的项目目录，然后根据操作系统设置环境变量，最后启动 Claude Code。

Linux/Unix/macOS 系统（终端）
bash 复制代码 
# 进入项目目录
cd your-project-folder

# 设置环境变量（替换 sk-... 为您的实际令牌）
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_BASE_URL=https://xuedingmao.com
export API_TIMEOUT_MS=300000  # 设置为 300 秒超时

# 启动 Claude Code
claude
Windows 系统（PowerShell）
bash 复制代码 
# 进入项目目录
cd your-project-folder

# 设置环境变量（替换 sk-... 为您的实际令牌）
$env:ANTHROPIC_BASE_URL = "https://xuedingmao.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-..."
$env:API_TIMEOUT_MS = "300000"  # 设置为 300 秒超时

# 启动 Claude Code
claude
Windows 系统（CMD）
bash 复制代码 
# 进入项目目录
cd your-project-folder

# 设置环境变量（替换 sk-... 为您的实际令牌）
set ANTHROPIC_BASE_URL=https://xuedingmao.com
set ANTHROPIC_AUTH_TOKEN=sk-...
set API_TIMEOUT_MS=300000

# 启动 Claude Code
claude
步骤3：初次运行配置

启动后，您将看到以下配置步骤，按提示完成即可：

  1. 选择主题 → 选择您喜欢的主题 + 按 Enter

  2. 安全须知 → 确认安全须知 + 按 Enter

  3. Terminal 配置 → 使用默认配置 + 按 Enter

  4. 工作目录信任 → 信任当前目录 + 按 Enter

恭喜！现在您可以开始与您的 AI 编程搭档一起写代码了！

三、常见问题汇总

（一）Codex 专属问题

Q: 启动 Codex 失败，提示 API 相关错误？

A: 请按以下步骤排查：

  1. 确认 API Key 创建是否正确：额度选择【无限额度】，不要限制模型，分组选择对应系统的专属分组（Windows：codex专属；Mac：codex特供；Linux：codex渠道-gpt）。

  2. 确认 config.toml 中的 base_url 已改为 https://xuedingmao.com/v1。

  3. 确认 auth.json 中的 SK 已替换为实际生成的密钥，且格式正确（无多余符号）。

  4. 重启终端后重新尝试启动。

（二）Claude Code 专属问题

Q: 遇到 "Invalid API Key · Please run /login" 错误？

A: 这表明 Claude Code 未检测到环境变量。请检查：

  • 是否正确设置了 `ANTHROPIC_AUTH_TOKEN` 和 `ANTHROPIC_BASE_URL`

  • 环境变量值是否正确（令牌以 `sk-` 开头，base_url 为 https://xuedingmao.com）

  • 如果使用了永久配置，是否重启了终端

Q: 为什么显示 "offline" 状态？

A: Claude Code 通过连接 Google 来判断网络状态。显示 "offline" 不影响正常使用，只是表明无法连接到 Google。

Q: 为什么浏览网页的 Fetch 会失败？

A: Claude Code 在访问网页前需要调用 Claude 服务进行安全检查。您需要：

  • 保持稳定的国际互联网连接

  • 必要时使用全局代理

Q: 请求总是显示 "fetch failed"？

A: 可能是网络环境导致的问题。解决方案：

  1. 尝试使用代理工具

  2. 检查网络连接是否稳定，重新启动 Claude Code

Q: API 报错如何处理？

A: 可能是转发代理不稳定导致的，建议：

  • 退出 Claude Code（Ctrl+C）

  • 重新运行 `claude` 命令

  • 如果问题持续，请稍后再试

Q: 网页登录错误？

A: 尝试清除本站的 Cookie，然后重新登录。

（三）通用注意事项

  • 本文所有配置均遵循官方规范，未自创任何代码或配置参数，确保可用性。

  • 请妥善保管您的 API 令牌，避免泄露，否则可能导致额度被盗用。

  • 两款工具均依赖 Node.js，确保 Node.js 版本符合要求，否则会导致安装或启动失败。

  • 如遇到其他未提及的问题，可参考对应官方文档或联系技术支持。

（四）相关链接

💡 提示：如遇到其他问题，请查看官方文档或联系技术支持。

（注：文档部分内容可能由 AI 生成）

相关推荐
TDengine （老段）1 小时前
TDengine 集群拓扑深度解析 — 节点发现、EP 机制与负载均衡
大数据·数据库·人工智能·重构·负载均衡·时序数据库·tdengine
Kiyra1 小时前
异步任务不用 Kafka 也行：用 Redis Stream 搭一套轻量级 Producer/Consumer 框架
数据库·人工智能·redis·分布式·后端·缓存·kafka
城事漫游Molly1 小时前
定量研究设计清单：问卷、实验与变量操作化怎么做？
大数据·人工智能·算法·ai写作·论文笔记
涤生大数据1 小时前
大数据凉了？速看4月的就业数据新鲜出炉！AI时代岗位不会原地消失，而是岗位的标准会被逐步抬高
大数据·人工智能
七夜zippoe1 小时前
基于 JiuwenClaw AgentTeam 集群模式的年会策划实战：从源码部署到多智能体协作落地
人工智能·agent·openjiuwen·jiuwenclaw·agentteam
Soari1 小时前
科研绘图新纪元：深度拆解 3DCellForge，AI 驱动的交互式 3D 细胞建模神器
人工智能·3d·科研绘图·3dcellforg
new【一个】对象1 小时前
Python 包管理器uv
人工智能·windows·python
智塑未来1 小时前
高精度3D室内定位设备如何赋能机器人科研创新
人工智能·安全
captain_AIouo1 小时前
Captain AI全功能矩阵覆盖OZON运营每一个关键节点
大数据·人工智能·经验分享·矩阵·aigc
热门推荐
01GitHub 镜像站点02Codex 接入 DeepSeek API 完整配置文档03【AI】2026 年具身智能模型和世界模型总结04CC-Switch & Claude 基于 Linux 服务器安装使用指南05零基础教你claude code 接入 deepseek V406Windows端Codex接入第三方模型（DeekSeek，BaiLian)07Cursor 接入 DeepSeek‑V4‑Pro 完整指南（2026 实测）08要裂开了！ChatGPT要手机号验证了？注册Codex要求验证电话号码怎么办？2026年登陆Codex要手机号验证的解决办法092026年AI前瞻：量子AI、具身智能与科学发现的新纪元10裂开！ChatGPT 居然开始要手机号验证，附详细解决方法