客户端配置教程

01

安装客户端

先选择要用的客户端。Codex 优先用微软商店安装 App，商店下不了再用 CLI 修复；Claude Code 只能用终端安装。跟着高亮步骤按顺序做即可。

Codex 有桌面 App。优先直接从微软商店安装；只有商店下载失败时，才走下面的「方式 B」——用 CLI 把商店修好，再回商店下载。

方式 A：微软商店直接安装

Windows：打开 Microsoft Store，搜索 ChatGPT（含 Codex），点「获取 / 安装」。
macOS：下载最新版 .dmg，拖入「应用程序」。

Codex 官方下载页

商店下不了？兜底方案

方式 B：装 Codex CLI，让它修复商店

思路：先用命令行装好 Codex CLI，再用大白话让 CLI 帮你修复商店，修好后回商店正常下载 App。按顺序做完 3 步即可。

1

安装 Node.js（CLI 的运行基础，必装）

先装 Node.js，Codex CLI / Claude Code 才能装上。已装可跳过。下面 Windows 给了两种方式，winget 用不了就用「方式②」官网下载，任何电脑都能装上。

Windows · 方式①：命令安装（winget 是 Windows 自带的安装工具）

winget install OpenJS.NodeJS.LTS

Windows · 方式②：winget 用不了？官网下载双击装（最稳，无需命令）

打开 nodejs.org，下载 LTS 版 .msi 安装包，双击一路点「下一步」即可。此法不依赖 winget、也不依赖商店，任何 Windows 都能用。

前往 nodejs.org 下载 Node.js

macOS

brew install node

macOS 没装 Homebrew？同样可去 nodejs.org 下载 .pkg 双击安装。

装完在终端输入 node -v，能显示版本号（如 v22.x.x）就说明 Node.js 装好了，再继续下一步。

2

安装 Codex CLI

Node.js 装好后，执行这条命令安装 CLI。

npm install -g @openai/codex@latest

装完终端输入 codex 启动、codex --version 查版本。下载慢或报错？展开下方「更多命令 · 排错」，可切换国内源。

3

启动 CLI，让它修复商店并下载 App

终端输入 codex 回车启动，然后像聊天一样直接打字，把下面这句话发给它，等它自动修复商店并重新下载：

在 Codex CLI 里输入这句话

微软商城无法下载 ChatGPT Codex，需要你帮我修复，并尝试重新下载。

修复完成后，回到 Microsoft Store 重新下载 Codex App 即可。

更多命令：winget 不可用 · 更新 CLI · 查版本 · 排错

Windows · winget 不可用 · 纯命令自动装 Node.js（更简单请用上方「方式②」官网下载）

[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $dir="https://nodejs.org/dist/latest-v22.x/"; $html=(Invoke-WebRequest -UseBasicParsing $dir).Content; $file=[regex]::Match($html,'node-v[\d.]+-x64\.msi').Value; $msi=Join-Path $env:TEMP $file; Invoke-WebRequest -UseBasicParsing "$dir$file" -OutFile $msi; Start-Process msiexec.exe -Wait -ArgumentList "/i `"$msi`" /passive"

更新 Codex CLI 到最新版

npm install -g @openai/codex@latest

检查当前版本

codex --version

npm 卡住可切换国内源：npm config set registry https://registry.npmmirror.com。若提示禁止运行 npm.ps1，先执行：Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force。

Claude Code 是命令行工具，没有桌面 App，只能用终端安装。按顺序做完 2 步即可开始使用。

用终端命令安装 Claude Code

1

安装 Node.js（CLI 的运行基础，必装）

先装 Node.js，Codex CLI / Claude Code 才能装上。已装可跳过。下面 Windows 给了两种方式，winget 用不了就用「方式②」官网下载，任何电脑都能装上。

Windows · 方式①：命令安装（winget 是 Windows 自带的安装工具）

winget install OpenJS.NodeJS.LTS

Windows · 方式②：winget 用不了？官网下载双击装（最稳，无需命令）

打开 nodejs.org，下载 LTS 版 .msi 安装包，双击一路点「下一步」即可。此法不依赖 winget、也不依赖商店，任何 Windows 都能用。

前往 nodejs.org 下载 Node.js

macOS

brew install node

macOS 没装 Homebrew？同样可去 nodejs.org 下载 .pkg 双击安装。

装完在终端输入 node -v，能显示版本号（如 v22.x.x）就说明 Node.js 装好了，再继续下一步。

2

安装 Claude Code

Node.js 装好后执行这条命令；完成后在终端输入 claude 即可启动。

npm install -g @anthropic-ai/claude-code@latest

claude --version 可查版本。下载慢或报错？展开下方「更多命令 · 排错」，可切换国内源。

更多命令：winget 不可用 · 更新 · 查版本 · 排错

Windows · winget 不可用 · 纯命令自动装 Node.js（更简单请用上方「方式②」官网下载）

[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $dir="https://nodejs.org/dist/latest-v22.x/"; $html=(Invoke-WebRequest -UseBasicParsing $dir).Content; $file=[regex]::Match($html,'node-v[\d.]+-x64\.msi').Value; $msi=Join-Path $env:TEMP $file; Invoke-WebRequest -UseBasicParsing "$dir$file" -OutFile $msi; Start-Process msiexec.exe -Wait -ArgumentList "/i `"$msi`" /passive"

更新 Claude Code 到最新版

npm install -g @anthropic-ai/claude-code@latest

检查当前版本

claude --version

npm 卡住可切换国内源：npm config set registry https://registry.npmmirror.com。若提示禁止运行 npm.ps1，先执行：Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force。

02

配置密钥（CC-Switch）

安装 CC-Switch，在控制台创建 API Key，然后通过密钥页面的“导入到 CCS”完成客户端配置。

下载 CC-Switch

选择对应系统安装。完成后打开 API Keys 页面，创建密钥并导入。

Windows macOS 创建 API Key

03

彻底退出并重新启动

配置完成后不要只关闭窗口，需要完全结束客户端进程，再重新打开以加载新的密钥配置。

完全退出

从系统托盘或任务管理器结束客户端进程。

重新打开

启动 Codex 或 Claude Code，等待配置加载。

发起测试

发送第一条请求，并在控制台核对用量记录。

客户端配置教程

安装客户端

方式 A：微软商店直接安装

方式 B：装 Codex CLI，让它修复商店

安装 Node.js（CLI 的运行基础，必装）

安装 Codex CLI

启动 CLI，让它修复商店并下载 App

用终端命令安装 Claude Code

安装 Node.js（CLI 的运行基础，必装）

安装 Claude Code

配置密钥（CC-Switch）

下载 CC-Switch

彻底退出并重新启动

需要视频演示？