Codex 与 Claude Code 全平台安装配置指南（Windows / macOS / Linux）

本文整合Codex与Claude Code两款主流 AI 编程助手的安装与配置流程覆盖 Windows、macOS、Linux 三大系统所有命令均经过验证可直接复制使用。目录一、环境准备二、Codex 安装与配置三、Claude Code 安装与配置四、常见问题排查一、环境准备两款工具均依赖Node.js ≥ 18(Codex 推荐 22)。先完成 Node.js 安装。1.1 Windows推荐两种方式任选其一:方式 A:官方安装包访问 https://nodejs.org/ 下载 LTS 版本,双击安装即可。方式 B:使用 nvm-windows(便于多版本管理)从 nvm-windows releases 下载nvm-setup.exe,安装后:nvm install 22 nvm use 22另外建议安装Git for Windows:https://git-scm.com/downloads,后续部分命令依赖 Git Bash。1.2 macOS# 安装 Xcode 命令行工具xcode-select--install# 安装 Homebrew(已安装可跳过)/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)# 安装 Node.jsbrewinstallnode221.3 LinuxUbuntu / Debian:curl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoapt-getinstall-ynodejsFedora / RHEL / CentOS:curl-fsSLhttps://rpm.nodesource.com/setup_22.x|sudo-Ebash-sudodnfinstall-ynodejsArch Linux:sudopacman-Snodejsnpm1.4 验证安装node--version# 应输出 v22.x.x 或 v18.x.x 以上npm--version二、Codex 安装与配置Codex 是 OpenAI 推出的命令行 AI 编程助手,支持 CLI 与 VSCode 插件两种使用方式。2.1 安装 Codex CLI所有系统通用(Windows 用户在 PowerShell 或 CMD 中执行,Linux/macOS 可能需要sudo):npminstall-gopenai/codex验证:codex--version2.2 获取 API Token登录 xuedingmao.com进入控制台 → API 令牌 → 添加令牌关键设置:令牌分组:选择codex 专属分组(必须,否则无法调用)额度:建议设为无限额度名称:任意复制生成的sk-xxx密钥备用。2.3 配置文件Codex 配置位于用户主目录下的.codex/文件夹,需要两个文件:文件作用auth.json存放 API Keyconfig.toml模型与代理配置Windows 路径C:\Users\你的用户名\.codex\若文件夹不存在,可在 PowerShell 中执行:New-Item-ItemType Directory-Force-Path$env:USERPROFILE\.codexNew-Item-ItemType File-Force-Path$env:USERPROFILE\.codex\auth.jsonNew-Item-ItemType File-Force-Path$env:USERPROFILE\.codex\config.tomlmacOS / Linux 路径mkdir-p~/.codextouch~/.codex/auth.json ~/.codex/config.tomlauth.json 内容将sk-xxx替换为你的真实密钥:{OPENAI_API_KEY:sk-xxx}config.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 responsesmodel_reasoning_effort可选high/medium/low,分别对应高/中/低推理强度。2.4 启动 Codex关闭并重新打开终端(让配置生效),然后:cdyour-project-folder codex2.5 VSCode 插件在 VSCode 扩展商店搜索codex并安装。安装完成后会在左侧栏出现 Codex 图标,与 CLI 共用同一份~/.codex/配置,无需重复设置。三、Claude Code 安装与配置Claude Code 是 Anthropic 官方推出的终端 AI 编程助手。3.1 安装所有系统通用:npminstall-ganthropic-ai/claude-code claude--versionWindows 用户建议在WSL2中使用以获得最佳体验;原生 PowerShell / CMD 也可运行。3.2 获取 API Token同样在 xuedingmao.com 创建令牌:分组:选择Claude Code 专属或官转 Claude 3分组额度:无限额度记录生成的sk-xxx3.3 配置环境变量Claude Code 通过环境变量读取认证信息,有两种配置方式:临时(仅当前终端会话)和永久(写入配置文件)。3.3.1 临时配置Linux / macOS (bash/zsh):exportANTHROPIC_BASE_URLhttps://xuedingmao.comexportANTHROPIC_AUTH_TOKENsk-xxxexportAPI_TIMEOUT_MS300000claudeWindows PowerShell:$env:ANTHROPIC_BASE_URL https://xuedingmao.com$env:ANTHROPIC_AUTH_TOKEN sk-xxx$env:API_TIMEOUT_MS 300000claudeWindows CMD:set ANTHROPIC_BASE_URLhttps://xuedingmao.com set ANTHROPIC_AUTH_TOKENsk-xxx set API_TIMEOUT_MS300000 claude3.3.2 永久配置(推荐)macOS / Linux— 将以下内容追加到~/.zshrc或~/.bashrc:exportANTHROPIC_BASE_URLhttps://xuedingmao.comexportANTHROPIC_AUTH_TOKENsk-xxxexportAPI_TIMEOUT_MS300000然后执行source ~/.zshrc(或重启终端)。Windows PowerShell— 写入用户级环境变量:[Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL,https://xuedingmao.com,User)[Environment]::SetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN,sk-xxx,User)[Environment]::SetEnvironmentVariable(API_TIMEOUT_MS,300000,User)设置后需关闭并重新打开终端窗口。3.4 启动 Claude Codecdyour-project-folder claude首次启动会引导完成:主题选择— 选择喜欢的主题,回车安全须知— 阅读并确认终端配置— 默认即可工作目录信任— 选择信任当前目录进入交互界面后,即可用自然语言描述需求开始协作编程。四、常见问题排查4.1 Codex 相关Q1:启动 Codex 报 API 错误依次检查:auth.json中的sk-xxx是否替换为真实密钥,且 JSON 格式正确(无多余逗号/引号)config.toml中的base_url是否为https://xuedingmao.com/v1令牌分组是否选择了 codex 专属分组已重启终端Q2:配置文件改了但不生效务必关闭并重新打开终端;部分编辑器保存时会生成 BOM 头,建议用 VSCode 保存为 “UTF-8(无 BOM)”。4.2 Claude Code 相关Q1:Invalid API Key · Please run /login环境变量未被读取。检查:echo $ANTHROPIC_AUTH_TOKEN(Windows 用echo %ANTHROPIC_AUTH_TOKEN%)是否能输出密钥是否在设置环境变量的同一个终端窗口启动claude若使用永久配置,是否重启终端Q2:状态栏显示 offlineClaude Code 通过 ping Google 判断网络。该提示不影响功能,可忽略。Q3:fetch failed或 API 超时网络抖动导致,CtrlC退出后重试提高超时:export API_TIMEOUT_MS600000检查代理设置是否影响到xuedingmao.com的访问Q4:WebFetch 抓取网页失败Claude Code 抓取网页前会调用安全检查服务,需要稳定的国际网络。可配置代理后重试。4.3 通用建议保护好你的 API Key:不要提交到 Git 仓库,不要分享到截图/聊天中Node.js 版本:Codex 推荐 Node 22,Claude Code 要求 Node 18;版本过低会出现奇怪的安装/运行错误更新工具:定期执行以下命令获取最新版本npmupdate-gopenai/codexnpmupdate-ganthropic-ai/claude-code参考链接Node.js 官网:https://nodejs.org/Git 下载:https://git-scm.com/downloadsClaude Code 官方文档:https://docs.anthropic.com/claude/docs/claude-codeOpenAI Codex 仓库:https://github.com/openai/codex如遇本文未覆盖的问题,优先查阅官方文档或在评论区交流。