本教程详细介绍 Codex 与 Claude Code 在 Windows、Mac、Linux 三大主流操作系统上的安装与配置方法两款工具均通过 xuedingmao.com 站点进行 API 调用配置。第一部分Codex 安装与配置教程Windows 版本教程系统要求Windows 10 或 Windows 11Node.js 22npm 10网络连接安装步骤前置步骤安装 Git Bash请访问 Git - Downloads 下载对应您电脑系统的版本之后一直点击下一步即可完成安装。1. 安装 Node.js访问 Node.js 官网 下载并安装最新 LTS 版本。2. 安装 codex打开命令提示符 (CMD) 或 PowerShell运行npminstall-gopenai/codex3. 验证安装打开命令提示符 (CMD) 或 PowerShell运行codex--version配置 API1. 获取 Auth Token访问 xuedingmao.com 站点页面进行以下操作点击控制台 → API令牌页面点击添加令牌令牌分组请选择codex专属务必选择此分组否则无法使用令牌名称随意额度建议设置为无限额度其他选项保持默认2. 配置文件重要提示请将下方的sk-xxx替换为您在 xuedingmao.com 生成的实际 API 密钥重要提示请将下方的sk-xxx替换为您在 xuedingmao.com 生成的实际 API 密钥重要提示请将下方的sk-xxx替换为您在 xuedingmao.com 生成的实际 API 密钥进入当前用户的用户目录下的.codex文件夹中例如C:\Users\testuser\.codex。注意如果看不到该目录说明您没有打开 Windows 的显示隐藏的项目请先在文件资源管理器中开启。如果没有.codex文件夹请手动创建该文件夹然后在其中创建config.toml以及auth.json两个文件。填写配置需要将sk-xxx替换成您自己创建的真实 SK。a.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 responses启动 codex重启终端重启终端重启终端然后进入到您的工程目录cdyour-project-folder运行以下命令启动codexVSCode 插件 codex以上配置完成后在 VSCode 扩展商店中搜索并安装codex即可。安装完成后会出现在侧边栏。Mac 版本教程系统要求macOS 12 或更高版本Node.js 22npm 10网络连接安装步骤1. 安装 Node.js方式一直接访问 Node.js 官网 下载并安装最新 LTS 版本。方式二使用 Homebrew推荐# 如果尚未安装 Homebrew请先运行此命令/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)# 安装 Node.jsbrewinstallnode2. 安装 codex打开终端 (Terminal)运行可能需要加sudonpminstall-gopenai/codex3. 验证安装打开终端 (Terminal)运行codex--version配置 API1. 获取 Auth Token访问 xuedingmao.com 站点页面进行以下操作点击控制台 → API令牌页面点击添加令牌令牌分组请选择codex专属务必选择此分组否则无法使用令牌名称随意额度建议设置为无限额度其他选项保持默认2. 配置文件重要提示请将下方的sk-xxx替换为您在 xuedingmao.com 生成的实际 API 密钥重要提示请将下方的sk-xxx替换为您在 xuedingmao.com 生成的实际 API 密钥重要提示请将下方的sk-xxx替换为您在 xuedingmao.com 生成的实际 API 密钥创建目录和文件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 responses启动 codex重启终端重启终端重启终端然后进入到您的工程目录cdyour-project-folder运行以下命令启动codexVSCode 插件 codex以上配置完成后在 VSCode 扩展商店中搜索并安装codex即可。安装完成后会出现在侧边栏。Linux 版本教程系统要求主流 Linux 发行版 (Ubuntu 20.04, Debian 10, CentOS 7, etc.)Node.js 22npm 10网络连接安装步骤1. 安装 Node.jsUbuntu/Debiansudoaptupdatecurl-fsSLhttps://deb.nodesource.com/setup_lts.x|sudo-Ebash-sudoapt-getinstall-ynodejsCentOS/RHEL/Fedora# 使用 dnf (Fedora) 或 yum (CentOS/RHEL)sudodnfinstallnodejsnpm# 或sudoyuminstallnodejsnpmArch Linuxsudopacman-Snodejsnpm2. 安装 codex打开终端 (Terminal)运行sudonpminstall-gopenai/codex3. 验证安装打开终端 (Terminal)运行codex--version配置 API1. 获取 Auth Token访问 xuedingmao.com 站点页面进行以下操作点击控制台 → API令牌页面点击添加令牌令牌分组请选择codex渠道-gpt务必选择此分组否则无法使用令牌名称随意额度建议设置为无限额度其他选项保持默认2. 配置文件重要提示请将下方的sk-xxx替换为您在 xuedingmao.com 生成的实际 API 密钥重要提示请将下方的sk-xxx替换为您在 xuedingmao.com 生成的实际 API 密钥重要提示请将下方的sk-xxx替换为您在 xuedingmao.com 生成的实际 API 密钥创建目录和文件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 responses启动 codex重启终端重启终端重启终端然后进入到您的工程目录cdyour-project-folder运行以下命令启动codexVSCode 插件 codex以上配置完成后在 VSCode 扩展商店中搜索并安装codex即可。安装完成后会出现在侧边栏。Codex 常见问题出现错误请按照如下步骤排查确认 API Key 创建是否正确额度选择无限额度不要限制模型分组选择codex渠道-gpt。更多 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 用户# 安装 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--version2. 安装 Claude Code使用 npm 全局安装 Claude Codenpminstall-ganthropic-ai/claude-code# 验证安装claude--version3. 配置并开始使用获取必要的配置信息您需要准备两个重要的配置项配置项说明获取方式ANTHROPIC_AUTH_TOKENAPI 认证令牌注册后在API令牌页面点击添加令牌获得以sk-开头ANTHROPIC_BASE_URLAPI 服务地址使用https://xuedingmao.com与主站地址相同创建令牌时的建议设置名称随意命名额度设为无限额度分组选择Claude code专属或者官转克劳德3及以上其他选项保持默认设置启动 Claude Code在您的项目目录下运行Linux/Unix 系统# 进入项目目录cdyour-project-folder# 设置环境变量exportANTHROPIC_AUTH_TOKENsk-...# 替换为您的实际令牌exportANTHROPIC_BASE_URLhttps://xuedingmao.comexportAPI_TIMEOUT_MS300000# 设置为 300 秒超时# 启动 Claude CodeclaudeWindows PowerShell 系统# 进入项目目录cd your-project-folder# 设置环境变量$env:ANTHROPIC_BASE_URL https://xuedingmao.com$env:ANTHROPIC_AUTH_TOKEN sk-...# 替换为您的实际令牌$env:API_TIMEOUT_MS 300000# 设置为 300 秒超时# 启动 Claude CodeclaudeWindows CMD 系统# 进入项目目录 cd your-project-folder # 设置环境变量 set ANTHROPIC_BASE_URLhttps://xuedingmao.com set ANTHROPIC_AUTH_TOKENsk-... # 替换为您的实际令牌 set API_TIMEOUT_MS300000 # 设置为 300 秒超时 # 启动 Claude Code claude初次运行配置启动后您将看到以下配置步骤选择主题→ 选择您喜欢的主题 按 Enter安全须知→ 确认安全须知 按 EnterTerminal 配置→ 使用默认配置 按 Enter工作目录信任→ 信任当前目录 按 Enter✨恭喜现在您可以开始与您的 AI 编程搭档一起写代码了常见问题解答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:可能是网络环境导致的问题。解决方案尝试使用代理工具Q: API 报错如何处理A:可能是转发代理不稳定导致的建议退出 Claude CodeCtrlC重新运行claude命令如果问题持续请稍后再试Q: 网页登录错误A:尝试清除本站的 Cookie然后重新登录。注意事项本站在 xuedingmao.com 直接接入官方 Claude Code 转发服务仅支持 Claude Code 的 API 流量不支持其他 API 调用请妥善保管您的 API 令牌避免泄露相关链接Claude Code 官方文档Node.js 官方网站提示如遇到其他问题请查看官方文档或联系技术支持。
