本文整合 Codex 与 Claude Code 两款 AI 编程助手的安装、配置及使用教程覆盖 Windows、Mac、Linux 三大主流系统严格遵循官方代码配置适合各类开发者快速上手使用。目录1. Codex 安装与配置教程全系统2. Claude Code 安装与使用教程全系统3. 常见问题汇总通用专属一、Codex 安装与配置教程Codex 是 OpenAI 推出的强大 AI 编程助手可通过终端、VSCode 插件等方式使用以下是全系统详细安装配置步骤。一Windows 版本教程1. 系统要求Windows 10 或 Windows 11Node.js 22npm 10稳定网络连接2. 安装步骤前置步骤必做安装 Git Bash请访问 Git - Downloads 下载对应您电脑系统的版本之后一直点击“下一步”即可完成安装。步骤1安装 Node.js访问 Node.js 官网 下载并安装最新 LTS 版本。步骤2安装 codex打开命令提示符 (CMD) 或 PowerShell运行以下命令npminstall-gopenai/codex步骤3验证安装打开命令提示符 (CMD) 或 PowerShell运行以下命令若能显示版本号则安装成功codex--version3. 配置 API步骤1获取 Auth Token访问 xuedingmao.com 站点页面进行以下操作点击 **控制台 → API令牌** 页面点击 **添加令牌**令牌分组请选择**codex专属**务必选择此分组否则无法使用令牌名称随意额度建议设置为 **无限额度**其他选项保持默认参考截图令牌创建页面步骤2配置文件重要提示请将下方的 sk-xxx 替换为您在 xuedingmao.com 生成的实际 API 密钥重复3次务必注意进入当前用户的用户目录下的 .codex 文件夹中例如C:\Users\testuser\.codex。注意如果看不到该目录说明您没有打开 Windows 的“显示隐藏的项目”请先在文件资源管理器中开启。参考截图显示隐藏目录如果没有 .codex 文件夹请手动创建该文件夹然后在其中创建 config.toml 以及 auth.json 两个文件。参考截图.codex 目录文件填写配置需将 sk-xxx 替换成您自己创建的真实 SKa. auth.json 中的配置{OPENAI_API_KEY:sk-xxx}b. config.toml 中的配置直接粘贴下面的内容即可model_reasoning_effort 可选值为 high, medium, low分别代表模型思考的努力程度高、中、低。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 responses4. 启动 codex重启终端重启终端重启终端重要操作否则配置不生效然后进入到您的工程目录cdyour-project-folder运行以下命令启动codex参考截图Codex 启动界面5. VSCode 插件 codex以上配置完成后在 VSCode 扩展商店中搜索并安装 codex 即可安装完成后会出现在侧边栏。参考截图1VSCode 插件搜索参考截图2插件侧边栏显示二Mac 版本教程1. 系统要求macOS 12 或更高版本Node.js 22npm 10稳定网络连接2. 安装步骤步骤1安装 Node.js两种方式推荐方式二方式一直接访问 Node.js 官网 下载并安装最新 LTS 版本。方式二使用 Homebrew推荐# 如果尚未安装 Homebrew请先运行此命令/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)# 安装 Node.jsbrewinstallnode步骤2安装 codex打开终端 (Terminal)运行可能需要加 sudonpminstall-gopenai/codex步骤3验证安装打开终端 (Terminal)运行以下命令若能显示版本号则安装成功codex--version3. 配置 API步骤1获取 Auth Token访问 xuedingmao.com 站点页面进行以下操作点击 **控制台 → API令牌** 页面点击 **添加令牌**令牌分组请选择**codex特供**务必选择此分组否则无法使用令牌名称随意额度建议设置为 **无限额度**其他选项保持默认参考截图令牌创建页面步骤2配置文件重要提示请将下方的 sk-xxx 替换为您在 xuedingmao.com 生成的实际 API 密钥重复3次务必注意创建目录和文件打开终端运行以下命令mkdir-p~/.codextouch~/.codex/auth.jsontouch~/.codex/config.toml编辑 auth.json 文件vi~/.codex/auth.json按 i 进入插入模式粘贴以下内容将 sk-xxx 替换为您的密钥然后按 ESC 键输入 :wq 并回车保存退出。{OPENAI_API_KEY:sk-xxx}编辑 config.toml 文件vi~/.codex/config.toml按 i 进入插入模式粘贴以下内容然后按 ESC 键输入 :wq 并回车保存退出。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 responses4. 启动 codex重启终端重启终端重启终端重要操作否则配置不生效然后进入到您的工程目录cdyour-project-folder运行以下命令启动codex5. VSCode 插件 codex以上配置完成后在 VSCode 扩展商店中搜索并安装 codex 即可安装完成后会出现在侧边栏。三Linux 版本教程1. 系统要求主流 Linux 发行版 (Ubuntu 20.04, Debian 10, CentOS 7, etc.)Node.js 22npm 10稳定网络连接2. 安装步骤步骤1安装 Node.js分发行版Ubuntu/Debiansudoaptupdatecurl-fsSLhttps://deb.nodesource.com/setup_lts.x|sudo-Ebash-sudoapt-getinstall-ynodejsCentOS/RHEL/Fedora# 使用 dnf (Fedora) 或 yum (CentOS/RHEL)sudodnfinstallnodejsnpm# 或sudoyuminstallnodejsnpmArch Linuxsudopacman-Snodejsnpm步骤2安装 codex打开终端 (Terminal)运行sudonpminstall-gopenai/codex步骤3验证安装打开终端 (Terminal)运行以下命令若能显示版本号则安装成功codex--version3. 配置 API步骤1获取 Auth Token访问 xuedingmao.com 站点页面进行以下操作点击 **控制台 → API令牌** 页面点击 **添加令牌**令牌分组请选择**codex渠道-gpt**务必选择此分组否则无法使用令牌名称随意额度建议设置为 **无限额度**其他选项保持默认步骤2配置文件重要提示请将下方的 sk-xxx 替换为您在 xuedingmao.com 生成的实际 API 密钥重复3次务必注意创建目录和文件打开终端运行以下命令mkdir-p~/.codextouch~/.codex/auth.jsontouch~/.codex/config.toml编辑 auth.json 文件vi~/.codex/auth.json按 i 进入插入模式粘贴以下内容将 sk-xxx 替换为您的密钥然后按 ESC 键输入 :wq 并回车保存退出。{OPENAI_API_KEY:sk-xxx}编辑 config.toml 文件vi~/.codex/config.toml按 i 进入插入模式粘贴以下内容然后按 ESC 键输入 :wq 并回车保存退出。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 responses4. 启动 codex重启终端重启终端重启终端重要操作否则配置不生效然后进入到您的工程目录cdyour-project-folder运行以下命令启动codex参考截图Codex 启动界面5. VSCode 插件 codex以上配置完成后在 VSCode 扩展商店中搜索并安装 codex 即可安装完成后会出现在侧边栏。参考截图1VSCode 插件搜索参考截图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 用户# 安装 Node.js LTS 版本curl-fsSLhttps://deb.nodesource.com/setup_lts.x|sudobash-sudoapt-getinstall-ynodejs# 验证安装node--versionmacOS 用户# 安装 Xcode 命令行工具sudoxcode-select--install# 安装 Homebrew如果尚未安装/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)# 通过 Homebrew 安装 Node.jsbrewinstallnode# 验证安装node--versionWindows (WSL) 用户参考 Ubuntu / Debian 用户安装步骤在 WSL 终端中执行对应命令即可。2. 安装 Claude Code使用 npm 全局安装 Claude Code打开终端运行以下命令npminstall-ganthropic-ai/claude-code# 验证安装claude--version3. 配置并开始使用步骤1获取必要的配置信息您需要准备两个重要的配置项具体说明如下配置项说明获取方式ANTHROPIC_AUTH_TOKENAPI 认证令牌注册后在 API令牌 页面点击 添加令牌 获得以 sk- 开头ANTHROPIC_BASE_URLAPI 服务地址使用 https://xuedingmao.com与主站地址相同创建令牌时的建议设置名称随意命名额度设为无限额度分组选择Claude code专属或者官转克劳德3及以上其他选项保持默认设置步骤2启动 Claude Code首先进入您的项目目录然后根据操作系统设置环境变量最后启动 Claude Code。Linux/Unix/macOS 系统终端# 进入项目目录cdyour-project-folder# 设置环境变量替换 sk-... 为您的实际令牌exportANTHROPIC_AUTH_TOKENsk-...exportANTHROPIC_BASE_URLhttps://xuedingmao.comexportAPI_TIMEOUT_MS300000# 设置为 300 秒超时# 启动 Claude CodeclaudeWindows 系统PowerShell# 进入项目目录cdyour-project-folder# 设置环境变量替换 sk-... 为您的实际令牌$env:ANTHROPIC_BASE_URLhttps://xuedingmao.com$env:ANTHROPIC_AUTH_TOKENsk-...$env:API_TIMEOUT_MS300000# 设置为 300 秒超时# 启动 Claude CodeclaudeWindows 系统CMD# 进入项目目录cdyour-project-folder# 设置环境变量替换 sk-... 为您的实际令牌setANTHROPIC_BASE_URLhttps://xuedingmao.comsetANTHROPIC_AUTH_TOKENsk-...setAPI_TIMEOUT_MS300000# 启动 Claude Codeclaude步骤3初次运行配置启动后您将看到以下配置步骤按提示完成即可选择主题 → 选择您喜欢的主题 按 Enter安全须知 → 确认安全须知 按 EnterTerminal 配置 → 使用默认配置 按 Enter工作目录信任 → 信任当前目录 按 Enter恭喜现在您可以开始与您的 AI 编程搭档一起写代码了三、常见问题汇总一Codex 专属问题Q: 启动 Codex 失败提示 API 相关错误A: 请按以下步骤排查确认 API Key 创建是否正确额度选择【无限额度】不要限制模型分组选择对应系统的专属分组Windowscodex专属Maccodex特供Linuxcodex渠道-gpt。确认 config.toml 中的 base_url 已改为 https://xuedingmao.com/v1。确认 auth.json 中的 SK 已替换为实际生成的密钥且格式正确无多余符号。重启终端后重新尝试启动。二Claude Code 专属问题Q: 遇到 #34;Invalid API Key · Please run /login#34; 错误A: 这表明 Claude Code 未检测到环境变量。请检查是否正确设置了 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL环境变量值是否正确令牌以 sk- 开头base_url 为 https://xuedingmao.com如果使用了永久配置是否重启了终端Q: 为什么显示 #34;offline#34; 状态A: Claude Code 通过连接 Google 来判断网络状态。显示 #34;offline#34; 不影响正常使用只是表明无法连接到 Google。Q: 为什么浏览网页的 Fetch 会失败A: Claude Code 在访问网页前需要调用 Claude 服务进行安全检查。您需要保持稳定的国际互联网连接必要时使用全局代理Q: 请求总是显示 #34;fetch failed#34;A: 可能是网络环境导致的问题。解决方案尝试使用代理工具检查网络连接是否稳定重新启动 Claude CodeQ: API 报错如何处理A: 可能是转发代理不稳定导致的建议退出 Claude CodeCtrlC重新运行 claude 命令如果问题持续请稍后再试Q: 网页登录错误A: 尝试清除本站的 Cookie然后重新登录。三通用注意事项本文所有配置均遵循官方规范未自创任何代码或配置参数确保可用性。请妥善保管您的 API 令牌避免泄露否则可能导致额度被盗用。两款工具均依赖 Node.js确保 Node.js 版本符合要求否则会导致安装或启动失败。如遇到其他未提及的问题可参考对应官方文档或联系技术支持。四相关链接Git 官方下载https://git-scm.com/downloadsNode.js 官方网站https://nodejs.org/Claude 官方文档https://docs.anthropic.com--- 提示如遇到其他问题请查看官方文档或联系技术支持。注文档部分内容可能由 AI 生成