点击进入，购买即可同时使用 Claude Code 和 Codex，两者共用相同的 API Key，无需额外购买
快速导航 — 选择你需要的教程
1 必要安装
在开始配置之前，需要先安装以下两个基础工具。它们是运行 Claude Code 和 Codex 的前置依赖。
1 安装 Git (仅 Windows 需要安装，Linux / macOS 已自带)
Git 是版本控制工具，Claude Code 运行时需要依赖它来管理项目文件。
安装路径建议保持默认（C 盘），修改路径可能导致环境变量找不到 Git 而报错。安装过程中所有选项保持默认，一路点击 "Next" 即可。
2 安装 Node.js
Node.js 是 JavaScript 运行环境，Claude Code 和 Codex 都通过 npm（Node.js 自带的包管理器）来安装。
同样建议默认安装到 C 盘，安装时全部点击"下一步"，不要修改安装路径。安装完成后需要重新打开终端才能生效。
Windows 下载
Mac 下载
安装完成后，打开终端输入 node -v 和 npm -v，如果能看到版本号（如 v24.13.1），说明安装成功。Node 版本需要 ≥ v18。
2 Codex 一键部署安装
适用于 Windows / Linux / Mac 全平台。只需两条命令即可自动完成 Codex 的安装与配置，无需手动编辑任何文件。
在终端中依次执行以下命令
# 第一步：安装配置工具（Windows 不需要加 sudo）
$ sudo npm install -g pumpkinai-config
# 第二步：运行配置命令，按提示输入你的 API Key
$ codex-config
Windows 用户请使用 CMD 或 PowerShell 执行，不需要加 sudo
执行完毕后，终端中的 Codex、VS Code 以及 Cursor 的 Codex 插件均可直接使用，无需额外配置
如果安装过程中出现报错，可以先按照下方的「手动安装 Codex」步骤安装 Codex 本体，然后再执行一次 codex-config 即可完成配置
上面执行成功的话就不需要再看下面的手动安装了，直接跳到 API 配置即可！
3 手动安装 Codex
如果一键部署遇到问题，可以手动安装 Codex CLI。安装完成后再执行 codex-config 完成配置。
Mac / Linux
打开终端（Terminal），运行以下命令：
$ sudo npm install -g @openai/codex
需要 sudo 权限来全局安装，输入系统密码即可
Windows
打开命令提示符（CMD）或 PowerShell，运行：
> npm install -g @openai/codex
Windows 下不需要加 sudo，直接运行即可
4 验证安装
安装完成后，通过以下命令确认 Codex 是否安装成功。Mac 和 Windows 通用。
验证命令
# 查看 Codex 版本号
$ codex --version
如果终端输出类似 codex-cli 0.50.0 的版本信息，说明安装成功。版本号可能不同，只要能正常显示即可。
卸载 Codex（如需重装或清理）
如果需要卸载 Codex，打开终端执行以下命令：
# 全局卸载 Codex CLI
$ npm uninstall -g @openai/codex
安装过程中遇到报错？可以将错误截图发给免费的国产 AI（如豆包、Kimi 等），让它帮你分析原因，基本能解决 90% 的常见问题。常见问题包括：npm 版本过低、网络超时、权限不足等。
5 API 配置
手动配置 Codex 的 API 连接信息。配置完成后 Codex 会自动登录，无需额外操作。
重要提醒：如果你需要在 VS Code 中使用 Codex 插件，请务必先在终端中完成配置并测试通过，确认没有问题后再去 VS Code 中连接！
第一步：找到配置文件目录
进入当前用户目录下的 .codex 文件夹。不同系统的路径如下：
Windows
C:\Users\你的用户名\.codex
Mac / Linux
~/.codex
看不到 .codex 文件夹？这是因为它是隐藏目录。Windows 用户需要在文件资源管理器中点击「查看」→ 勾选「隐藏的项目」来显示隐藏文件夹。
如果目录中没有 .codex 文件夹，需要手动创建该文件夹，然后在里面新建两个文件：config.toml 和 auth.json
第二步：编辑 config.toml
用记事本或任意文本编辑器打开 config.toml，粘贴以下内容：
model_provider = "codex"
model = "gpt-5.2-codex" # 可改为 "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
[model_providers.codex]
name = "codex"
base_url = "https://vkcoding.com/v1"
wire_api = "responses"
requires_openai_auth = true
关于 gpt-5.3-codex：该模型只能通过修改配置文件来使用，在 Codex 内使用 /model 命令切换时不会显示。修改配置文件后无需手动切换，Codex 启动后会自动使用配置中指定的模型。在网站上查询 Key 时如果显示 5.3-codex 就说明配置成功了。
第三步：编辑 auth.json
用记事本或任意文本编辑器打开 auth.json，粘贴以下内容：
{
"OPENAI_API_KEY": "sk-xxx"
}
请务必将 sk-xxx 替换为你自己的 API 密钥！这是你在网站上获取到的以 sk- 开头的字符串。不替换的话无法正常使用。
Claude Code 一键配置教程【Windows】
最后更新：3月30日
适用于 Windows 系统的 Claude Code 快速配置方案，两条命令搞定全部设置。
系统要求
操作系统
Windows 10（版本 1809 / build 17763）及以上
Node.js 版本
需要 v18 或更高版本
1 安装前置依赖
请先完成上方 「必要安装」 章节中的 Git 和 Node.js 安装。安装完成后继续下面的步骤。
如果你已经安装过 Git 和 Node.js，可以在终端中输入 node -v 确认版本号 ≥ v18，确认后直接进入下一步。
2 一键配置 Claude Code
按下键盘 Win + R，输入 cmd 回车打开命令提示符，然后依次执行以下两条命令：
# 第一步：安装配置工具
> npm install -g pumpkinai-config
# 第二步：运行配置（会提示你输入 API Key）
> claude-config
配置完成后，请关闭当前终端并重新打开一个新的终端窗口，让环境变量生效。
一键配置遇到报错？可以尝试手动配置方式： 查看 Windows 手动配置教程
3 开始使用 Claude Code
重新打开一个 CMD 终端，输入 claude 回车。首次启动会出现一些选项提示，全部按回车选择默认即可。看到以下界面说明配置成功：
Claude Code v2.1.49
Welcome back!
Sonnet 4.6 · API Usage Billing
C:\Users\Administrator
/model to try Opus 4.6
Tip: "how does <filepath> work?"
恭喜！看到上面的界面就说明 Claude Code 已经配置成功，可以开始使用了。输入你的问题或需求，Claude 就会帮你编写代码。
Claude Code 一键配置教程【Mac / Linux】
适用于 macOS 和 Linux 系统，终端中两条命令即可完成全部配置。
系统要求
操作系统
macOS 12+ 或主流 Linux 发行版（Ubuntu 20.04+、Debian 11+ 等）
Node.js 版本
需要 v18 或更高版本
1 安装 Node.js
Mac / Linux 系统自带 Git，无需额外安装。只需安装 Node.js 即可，请参考上方 「必要安装」 章节中的 Mac 下载链接。
也可以使用 Homebrew 安装：brew install node，或使用 nvm 管理多版本。
2 一键配置 Claude Code
打开终端（Terminal），依次执行以下两条命令：
# 第一步：安装配置工具
$ sudo npm install -g pumpkinai-config
# 第二步：运行配置（会提示你输入 API Key）
$ claude-config
配置完成后，请关闭当前终端并重新打开一个新窗口，让环境变量生效。
一键配置遇到报错？可以尝试手动配置方式： 查看 Mac/Linux 手动配置教程
3 开始使用 Claude Code
重新打开终端，输入 claude 回车。首次启动会出现一些选项提示，全部按回车选择默认即可。
看到 Claude Code vX.X.X 和 Welcome back! 的欢迎界面就说明配置成功了。
Claude Code 手动配置教程【Windows】
如果一键配置遇到问题，可以按照以下步骤手动完成 Claude Code 的环境变量配置。
1 安装前置依赖
请先完成上方 「必要安装」 章节中的 Git 和 Node.js 安装。
2 安装 Claude Code CLI
按 Win + R，输入 cmd 回车，执行：
> npm install -g @anthropic-ai/claude-code
3 配置环境变量
在 CMD 中依次执行以下命令，设置 API 地址和密钥：
# 设置 API 代理地址
> setx ANTHROPIC_BASE_URL "https://vkcoding.com"
# 设置你的 API Key（替换 sk-xxx 为你自己的密钥）
> setx ANTHROPIC_API_KEY "sk-xxx"
请务必将 sk-xxx 替换为你自己的 API 密钥！
setx 设置的环境变量需要重新打开终端才能生效。执行完后请关闭当前 CMD，重新打开一个新的。
4 验证并启动
重新打开 CMD，输入 claude 回车，看到欢迎界面即配置成功。
出现 Welcome back! 界面就说明手动配置成功了。
Claude Code 手动配置教程【Mac / Linux】
如果一键配置遇到问题，可以按照以下步骤手动完成 Claude Code 的环境变量配置。
1 安装 Node.js
请先完成上方 「必要安装」 章节中的 Node.js 安装（Mac/Linux 自带 Git，无需额外安装）。
2 安装 Claude Code CLI
打开终端（Terminal），执行：
$ sudo npm install -g @anthropic-ai/claude-code
3 配置环境变量
将以下内容添加到你的 shell 配置文件中（~/.zshrc 或 ~/.bashrc）：
# Claude Code API 配置
export ANTHROPIC_BASE_URL="https://vkcoding.com"
export ANTHROPIC_API_KEY="sk-xxx" # 替换为你的密钥
保存文件后，执行以下命令让配置立即生效：
# zsh 用户
$ source ~/.zshrc
# bash 用户
$ source ~/.bashrc
不确定自己用的是 zsh 还是 bash？在终端输入 echo $SHELL 查看。macOS 默认是 zsh，大部分 Linux 默认是 bash。
4 验证并启动
在终端输入 claude 回车，看到欢迎界面即配置成功。
出现 Welcome back! 界面就说明手动配置成功了。