Claude Code & Codex 新手安装教程

本教程教你从零开始使用 api.wenle.ai 的 API，在 Claude Code 和 Codex 中写代码。

只需三步：① 注册 → ② 创建令牌 → ③ 安装工具。跟着做即可，遇到问题联系客服。

---

一、平台准备（注册 → 充值 → 创建令牌）

1. 注册与登录

1. 打开注册页面：👉 https://api.wenle.ai/sign-up

2. 填写用户名、密码完成注册（⚠️【按你平台实际情况修改：是否需要邮箱验证/邀请码】）

3. 注册完成后登录：👉 https://api.wenle.ai/sign-in

2. 充值

充值分两步：先购买兑换码，再回平台兑换。

1. 打开商店购买兑换码：👉 https://store.wenle.ai，选择需要的额度套餐，支付后获得兑换码（卡密）
2. 回到平台兑换页面：👉 https://api.wenle.ai/wallet（或登录后点顶部「钱包 / 充值」）
3. 在「兑换码」输入框粘贴刚才购买的兑换码，点「兑换额度」
4. 兑换成功后，本页面可看到当前剩余额度

3. 创建令牌（API Key）⭐ 最关键的一步

1. 打开令牌页面：👉 https://api.wenle.ai/keys（或控制台 → 左侧「API秘钥」）
2. 点「创建API秘钥」，按下面填写：
   1. 名称：随便填，比如 我的claude
   2. 额度：建议勾选「无限配额」（消耗以钱包余额为准）
   3. 过期时间：建议选「永不过期」
   4. 分组：⭐ 重要！根据你要用的工具选择对应分组：
      • 用 Claude Code → 选「⚠️【替换：你的 claude 分组名】」分组
      • 用 Codex → 选「⚠️【替换：你的 codex 分组名】」分组

💡 关于分组倍率：分组下拉框里每个分组后面标注的「倍率」就是计费系数，倍率越低越便宜（例如倍率 1 表示按原价计费，倍率 0.5 表示半价）。但注意：便宜不能乱选，必须选支持你所用工具的分组——比如用 Claude Code 就必须选 claude 对应的分组，选错分组会导致请求报错（401 / 无可用渠道）。同样的工具如果有多个可用分组，选倍率低的那个更划算。

3. 点「保存更改」，回到令牌列表，点击「复制」，得到一个 sk- 开头的令牌

🔑 这个 sk-xxxx 就是你的 API Key，下面所有教程中的 sk-你的令牌 都替换成它。 ⚠️ 令牌等于你的余额，不要发给别人、不要发到群里。

---

二、Claude Code 安装教程

Claude Code 是 Anthropic 官方的命令行 AI 编程助手。三种方式任选其一：一键脚本（推荐）、手动安装、VS Code 插件。

方式一：一键安装脚本（推荐）

macOS / Linux

打开「终端」（macOS 在 启动台 → 搜索”终端”），把下面整段复制进去，把 sk-你的令牌换成第一步复制的令牌，回车运行：

curl -s https://api.wenle.ai/setup-claudecode.sh | bash -s -- --url https://api.wenle.ai --key sk-你的令牌

Windows

在开始菜单搜索 PowerShell，右键「以管理员身份运行」，把下面整段复制进去（同样替换令牌），回车运行：

& { $url='https://api.wenle.ai'; $key='sk-你的令牌'; [Console]::OutputEncoding=[Text.Encoding]::UTF8; $wc=New-Object Net.WebClient; $wc.Encoding=[Text.Encoding]::UTF8; iex($wc.DownloadString('https://api.wenle.ai/setup-claudecode.ps1')) }

如果提示无权限，先运行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force，然后重开 PowerShell 再执行。

脚本会自动：检测/安装 Node\.js → 安装 Claude Code → 配置服务地址和令牌。 执行成功后 关闭并重新打开终端，在你的项目文件夹里运行：

claude

首次启动一直按回车确认默认选项，直到出现输入框即可开始使用。

方式二：手动安装

macOS / Linux

1. 安装 Node.js（已安装可跳过）

访问 https://nodejs.org 下载 LTS 版本安装（版本需 ≥ 18）；装了 Homebrew 的可以直接 brew install node。装完重开终端验证：

node --version
npm --version

2. 安装 Claude Code

sudo npm install -g @anthropic-ai/claude-code
claude --version

提示权限不足就在前面加 sudo；网络慢就加 --registry=https://registry.npmmirror.com

3. 配置服务地址和令牌（长期生效，只需执行一次）

PROFILE="$HOME/.zshrc"
[ -n "$BASH_VERSION" ] && PROFILE="$HOME/.bashrc"
echo 'export ANTHROPIC_BASE_URL="https://api.wenle.ai"' >> "$PROFILE"
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> "$PROFILE"
source "$PROFILE"

4. 启动：在项目目录运行 claude

Windows

1. 安装 Node.js：访问 https://nodejs.org/ 下载 LTS 版本（≥18），双击 .msi 按默认设置装完。打开 PowerShell 验证：

node --version
npm --version

2. 安装 Claude Code（建议用 PowerShell，不要用 CMD）：

npm.cmd install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
claude --version

3. 配置服务地址和令牌（写入用户环境变量，长期生效）：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.wenle.ai", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的令牌", "User")

4. 启动：关闭并重新打开 PowerShell，在项目目录运行 claude

方式三：VS Code 插件

很多人习惯在 VS Code 里用，Claude Code 有官方插件：

1. 先按上面任一方式完成安装和配置（插件和命令行共用同一套配置）

2. 打开 VS Code → 左侧扩展图标（或 Ctrl/Cmd + Shift + X）→ 搜索「Claude Code」→ 安装 Anthropic 官方插件 👉 插件市场链接：https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code

3. 重启 VS Code，侧边栏会出现 Claude 图标，点开即可对话写代码
4. 如果插件提示未登录/无法连接：确认已用一键脚本配置过（脚本会把地址和令牌写进 ~/.claude/settings.json，插件读的就是这个文件），然后重启 VS Code

---

三、Codex 安装教程

Codex 是 OpenAI 官方的 AI 编程助手。三种方式：一键脚本（推荐）、手动安装、VS Code 插件。

💡 已经在用 ChatGPT 官方账号登录 Codex 的用户请放心：一键脚本会自动把你原来的配置和登录凭据备份为 .bak 文件，想切回官方账号随时可以恢复（见文末常见问题）。

方式一：一键安装脚本（推荐）

macOS / Linux

打开终端，复制下面整段（替换令牌），回车运行：

curl -s https://api.wenle.ai/setup-codex.sh | bash -s -- --url https://api.wenle.ai --key sk-你的令牌

Windows

PowerShell 以管理员身份运行，复制下面整段（替换令牌），回车运行：

& { $url='https://api.wenle.ai'; $key='sk-你的令牌'; [Console]::OutputEncoding=[Text.Encoding]::UTF8; $wc=New-Object Net.WebClient; $wc.Encoding=[Text.Encoding]::UTF8; iex($wc.DownloadString('https://api.wenle.ai/setup-codex.ps1')) }

如果提示无权限，先运行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force，然后重开 PowerShell 再执行。

执行成功后 关闭并重新打开终端，在项目目录运行：

codex

方式二：手动安装

安装 Node.js

同 Claude Code 教程，访问 https://nodejs.org/ 安装 LTS 版本（≥18）。

安装 Codex CLI

macOS / Linux：

sudo npm install -g @openai/codex
codex --version

Windows（PowerShell）：

npm.cmd install -g @openai/codex --registry=https://registry.npmmirror.com
codex --version

写配置文件

新版 Codex 使用配置文件（不是环境变量）。需要创建两个文件：

文件一：~/.codex/config.toml（Windows 在 C:\Users\你的用户名\.codex\config.toml）

model_provider = "wenle"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.wenle]

name = “wenle” base_url = “https://api.wenle.ai/v1” wire_api = “responses” requires_openai_auth = true

文件二：~/.codex/auth.json（Windows 在 C:\Users\你的用户名\.codex\auth.json）

{"OPENAI_API_KEY": "sk-你的令牌"}

💡 .codex 文件夹如果不存在就自己新建一个；文件夹以 . 开头默认是隐藏的，macOS 在访达按 Cmd + Shift + . 显示隐藏文件，Windows 在资源管理器勾选「显示隐藏的项目」。 ⚠️ 如果这个目录里已经有 auth.json（说明你之前用 ChatGPT 官方账号登录过），先把它改名为 auth.json.bak 留着，再新建。

启动

在项目目录运行 codex，首次启动一直回车确认即可。

方式三：VS Code 插件

1. 先按上面任一方式完成配置（插件和命令行共用 ~/.codex 目录下的配置）

2. VS Code → 扩展市场搜索「Codex – OpenAI’s coding agent」→ 安装 OpenAI 官方插件 👉 插件市场链接：https://marketplace.visualstudio.com/items?itemName=openai.chatgpt

3. 重启 VS Code，侧边栏出现 Codex 图标，点开即可使用

4. 如果插件弹出登录界面，选择 API Key / 已有配置 方式（不要选 ChatGPT 账号登录），或直接重启 VS Code 让它读取已有配置

---

方式四：Codex 官方桌面软件（图形界面，免命令行）

如果你不习惯用命令行，Codex 官方还提供了桌面软件（图形界面）。只要 API 配置好，打开就能用，操作和普通聊天软件一样简单。

由于官方桌面软件的下载和更新线路都在海外，国内直接装往往超时、更新卡半路，这里推荐用开源的 Codex App Manager（安装管家） 来一键安装：它帮你把官方 Codex 桌面应用装好、自动增量更新、干净卸载，走国内可达的镜像线路，无需代理。

💡 原理：桌面软件和命令行共用 ~/.codex 目录下的配置。只要你已经按**方式二第三步「写配置文件」**创建好 config.toml 和 auth.json（填入本平台的 base_url 和 sk- 令牌），桌面软件打开后会自动读取，无需重复配置。

安装步骤：

1. 先完成 API 配置：按「方式二 → 写配置文件」创建好 ~/.codex/config.toml 和 ~/.codex/auth.json（这是打开软件能直接用的前提）
2. 下载安装管家（按你的系统选择，均为国内直连镜像链接，始终指向最新版本）：
   1. macOS · Apple Silicon（M 系列芯片）：CodexAppManager_aarch64.dmg
   2. macOS · Intel 芯片：CodexAppManager_x86_64.dmg
   3. Windows · x64（绝大多数电脑）：CodexAppManager_x64-setup.exe
   4. Windows · ARM64（Windows on Arm 设备）：CodexAppManager_arm64-setup.exe

1. 💡 不清楚自己的 Mac 是什么芯片？点左上角 → 「关于本机」，写着「Apple M1/M2/M3…」就选 Apple Silicon，写着「Intel」就选 Intel。Windows 一般选 x64 即可。
2. 也可用 GitHub 项目主页（开源）：https://codexapp.agentsmirror.com
3. 🌐 想装官方原版（需要🪜科学上网）：也可以直接从 OpenAI 官网下载官方桌面应用 👉 https://openai.com/codex
   1. macOS：官网下载 DMG（仅支持 Apple Silicon（M 系列芯片），Intel 老机型用不了）
   2. Windows：官方通过 Microsoft Store 分发，商店里搜索「Codex」安装
4. ⚠️ 官方下载和更新线路都在海外，国内不挂梯子基本装不上/更新卡住；如果你在国内且不方便科学上网，建议用上面的「Codex App Manager 安装管家」走国内镜像。

3. 安装管家：
   1. Windows：双击 .exe 安装包，按默认设置完成安装
   2. macOS：双击 .dmg，把 Codex App Manager 图标拖进「应用程序」文件夹
4. 用管家装 Codex：打开 Codex App Manager，它会自动检测本机状态，点「安装 / 更新」，即可自动下载并装好官方 Codex 桌面应用（以后有新版本也在这里一键更新）
5. 启动使用：装好后可在管家里直接点「启动 Codex」，或到启动台 / 开始菜单打开 Codex。软件会自动读取 ~/.codex 配置，无需再登录或填写令牌，直接进入即可开始使用

⚠️【待上传：软件下载 / 安装 / 启动界面截图】

⚠️ 如果打开 Codex 后提示要用 ChatGPT 账号登录、或没有走本平台：请确认 ~/.codex/config.toml 和 auth.json 已按方式二填写正确（base_url 结尾是 /v1、令牌 sk- 开头且前后无空格），改好后重启软件再试。

⚠️ macOS 首次打开若提示「无法验证开发者 / 已损坏」，到「系统设置 → 隐私与安全性」点「仍要打开」即可；Windows 若被 SmartScreen 拦截，点「更多信息 → 仍要运行」。

关于 Codex 官方软件（ChatGPT 账号登录）

有些同学同时有 ChatGPT Plus/Pro 官方账号，想两边切换使用：

• 切到本平台：按上面教程配置即可（脚本会自动备份你的官方登录凭据）
• 切回官方账号：进入 ~/.codex 目录，删除现在的 config.toml 和 auth.json，把 .bak 备份文件改回原名；如果没有备份，删除这两个文件后运行 codex login 重新用 ChatGPT 账号登录即可
• 两边的对话记录互不影响，随时可以来回切换

---

四、常见问题

Q1：运行 claude / codex 提示”命令不存在”？ 安装完成后必须关闭并重新打开终端/PowerShell 才能生效。还不行就重新执行一遍安装命令，看报错信息。

Q2：Windows 提示”禁止运行脚本”？ 以管理员身份运行 PowerShell，执行： Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force 然后重开 PowerShell 再试。

Q3：npm 安装很慢或卡住？ 在安装命令后面加国内镜像参数：--registry=https://registry.npmmirror.com

Q4：提示 401 / Invalid API Key？ ① 检查令牌是否复制完整（sk- 开头，前后不能有空格）；② 检查令牌的分组是否选对（见第一步）；③ 检查钱包余额是否充足。

Q5：提示额度不足 / quota？ 先到 https://store.wenle.ai/ 购买兑换码，再到 https://api.wenle.ai/wallet 兑换到账（详见第一部分「充值」步骤）。

Q6：Claude Code 首次启动问一堆问题？ 一直按回车选默认选项即可，直到出现输入提示符。

Q7：想换一个令牌 / 换服务地址？ 重新执行一遍一键脚本（用新令牌）即可覆盖旧配置。

Q8：Codex 报错 stream error / 无法连接？ 确认 config.toml 里 base_url 是 https://api.wenle.ai/v1（注意结尾有 `/v1`），并且 wire_api = "responses"没写错。

Q9：Codex 启动报错 expected value at line 1 column 1？ 这是配置文件编码问题（文件开头带了 BOM，多见于 Windows 记事本或旧版安装脚本写入的文件）。重新执行一遍最新的一键安装脚本即可修复；手动创建配置文件的同学，请用 VS Code 等编辑器保存为「UTF-8」（不要选「UTF-8 with BOM」）。

---

📮 以上没解决？请截图报错信息联系客服：