Codex 与 Claude Code 安装配置完全指南

薛定猫AI2026-06-02 16:53

本教程详细介绍 Codex 与 Claude Code 在 Windows、Mac、Linux 三大主流操作系统上的安装与配置方法，两款工具均通过 xuedingmao.com 站点进行 API 调用配置。

第一部分：Codex 安装与配置教程

Codex 是 OpenAI 推出的 AI 编程工具，可在终端或 VSCode 中使用。

Windows 版本教程

系统要求
  • Windows 10 或 Windows 11
  • Node.js 22+
  • npm 10+
  • 网络连接
安装步骤

⚠️ 前置步骤：安装 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
配置 API

1. 获取 Auth Token

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

  • 点击 控制台 → API令牌 页面
  • 点击 添加令牌
  • 令牌分组请选择：codex专属（务必选择此分组，否则无法使用）
  • 令牌名称随意
  • 额度建议：设置为 无限额度
  • 其他选项保持默认

2. 配置文件

重要提示 ：请将下方的 sk-xxx 替换为您在 xuedingmao.com 生成的实际 API 密钥！

  1. 进入当前用户的用户目录下的 .codex 文件夹中，例如：C:\Users\testuser\.codex

    注意：如果看不到该目录，说明您没有打开 Windows 的"显示隐藏的项目"，请先在文件资源管理器中开启。

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

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

    auth.json 中的配置：

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

    config.toml 中的配置：

    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"

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

启动 codex

⚠️ 重启终端！然后进入到您的工程目录：

bash 复制代码 
cd your-project-folder

运行以下命令启动：

bash 复制代码 
codex
VSCode 插件 codex

以上配置完成后，在 VSCode 扩展商店中搜索并安装 codex 即可。

安装完成后会出现在侧边栏。

Mac 版本教程

系统要求
  • macOS 12 或更高版本
  • Node.js 22+
  • npm 10+
  • 网络连接
安装步骤

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
配置 API

1. 获取 Auth Token

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

  • 点击 控制台 → API令牌 页面
  • 点击 添加令牌
  • 令牌分组请选择：codex专属（务必选择此分组，否则无法使用）
  • 令牌名称随意
  • 额度建议：设置为 无限额度
  • 其他选项保持默认

2. 配置文件

重要提示 ：请将下方的 sk-xxx 替换为您在 xuedingmao.com 生成的实际 API 密钥！

  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"
启动 codex

⚠️ 重启终端！然后进入到您的工程目录：

bash 复制代码 
cd your-project-folder

运行以下命令启动：

bash 复制代码 
codex
VSCode 插件 codex

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

Linux 版本教程

系统要求
  • 主流 Linux 发行版 (Ubuntu 20.04+、Debian 10+、CentOS 7+ 等)
  • Node.js 22+
  • npm 10+
  • 网络连接
安装步骤

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
配置 API

1. 获取 Auth Token

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

  • 点击 控制台 → API令牌 页面
  • 点击 添加令牌
  • 令牌分组请选择：codex专属（务必选择此分组，否则无法使用）
  • 令牌名称随意
  • 额度建议：设置为 无限额度
  • 其他选项保持默认

2. 配置文件

重要提示 ：请将下方的 sk-xxx 替换为您在 xuedingmao.com 生成的实际 API 密钥！

  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"
启动 codex

⚠️ 重启终端！然后进入到您的工程目录：

bash 复制代码 
cd your-project-folder

运行以下命令启动：

bash 复制代码 
codex
VSCode 插件 codex

以上配置完成后，在 VSCode 扩展商店中搜索并安装 codex 即可。

安装完成后会出现在侧边栏。

Codex 常见问题

出现错误请按照如下步骤排查：

  1. 确认 API Key 创建是否正确：额度选择无限额度 ，不要限制模型，分组选择 codex专属
  2. 确认配置文件中的 sk-xxx 已替换为您的实际密钥
  3. 确认 .codex 文件夹已正确创建在用户目录下

更多 codex 配置及使用详情请参考 codex 官方教程。

第二部分：Claude Code 安装使用教程

Claude Code 是一个强大的 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
2. 安装 Claude Code

使用 npm 全局安装 Claude Code：

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

# 验证安装
claude --version
3. 配置并开始使用

获取必要的配置信息

您需要准备两个重要的配置项：

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

📝 创建令牌时的建议设置：

  • 名称：随意命名
  • 额度：设为无限额度
  • 分组：选择 Claude code专属 或者 官转克劳德3及以上
  • 其他选项：保持默认设置

启动 Claude Code

在您的项目目录下运行：

Linux/Unix 系统

bash 复制代码 
# 进入项目目录
cd your-project-folder

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

# 启动 Claude Code
claude

Windows PowerShell 系统

powershell 复制代码 
# 进入项目目录
cd your-project-folder

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

# 启动 Claude Code
claude

Windows CMD 系统

cmd 复制代码 
# 进入项目目录
cd your-project-folder

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

# 启动 Claude Code
claude

初次运行配置

启动后，您将看到以下配置步骤：

  1. 选择主题 → 选择您喜欢的主题 + 按 Enter
  2. 安全须知 → 确认安全须知 + 按 Enter
  3. Terminal 配置 → 使用默认配置 + 按 Enter
  4. 工作目录信任 → 信任当前目录 + 按 Enter

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

Claude Code 常见问题解答

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

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

  • 是否正确设置了 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL
  • 环境变量值是否正确（令牌以 sk- 开头）
  • 如果使用了永久配置，是否重启了终端

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

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

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

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

  • 保持稳定的国际互联网连接
  • 必要时使用全局代理

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

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

  1. 退出 Claude Code（Ctrl+C）
  2. 重新运行 claude 命令
  3. 如果问题持续，请稍后再试

Q: API 报错如何处理？

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

  • 退出 Claude Code（Ctrl+C）
  • 重新运行 claude 命令
  • 如果问题持续，请稍后再试

Q: 网页登录错误？

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

注意事项

  • 本站在 xuedingmao.com 直接接入官方 Claude Code 转发服务
  • 仅支持 Claude Code 的 API 流量，不支持其他 API 调用
  • 请妥善保管您的 API 令牌，避免泄露

相关链接

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

相关推荐
SelectDB1 小时前
从 Machine-Readable 到 Agent-Ready：面向智能体的数据库接口演进
大数据·数据库·agent
前沿AI1 小时前
AI营销服一体化方案亮相2026中国汽车经销商大会，助力汽车销售全链路提效
大数据·人工智能·汽车
头盔小妹1 小时前
在本地调用大语言模型
人工智能·语言模型·自然语言处理
圣殿骑士-Khtangc1 小时前
智谱AI完成5亿美元融资 + AutoGLM 2.0发布：对标GPT-5 Agent Mode
人工智能
LLM落地研习社1 小时前
一行命令部署 NIM：Docker 容器化生产级最佳实践
人工智能
十有八七1 小时前
🧩 组件库死亡倒计时？—— AI 编码冲击下的前端基础设施重构
前端·人工智能
bryant_meng1 小时前
【Hugging Face】The GitHub of Open-Source AI Models
人工智能·github·qwen·hugging face·clip
有味道的男人1 小时前
从采集到铺货：AI 对接京东数据完整落地流程
人工智能
风止何安啊1 小时前
我一个前端仔，居然用 Python 搞起了 AI？从零到一，撸了个 AI 聊天框小 demo
前端·人工智能·后端
热门推荐
01GitHub 镜像站点022026 年 AI 编程工具终极横评：Cursor vs Claude Code vs Copilot vs Windsurf03【AI】2026 年具身智能模型和世界模型总结04【踩坑记录 | 第一篇】微软商店无法使用时，如何手动安装 OpenAI Codex？附`.msix`文件系统错误解决方法05Codex 下载安装指南：Windows 和 macOS 官方版下载06裂开！ChatGPT 居然开始要手机号验证，附详细解决方法07CC-Switch & Claude 基于 Linux 服务器安装使用指南08Codex 接入 DeepSeek API 完整配置文档09CC-Switch 下载、安装与使用配置指南【2026.5.29】10几个好用的ip纯净度检测网站