Node.js 环境安装教程
Codex、Claude Code 等工具均需要 Node.js 运行环境,请先按照以下步骤完成安装。
1下载 Node.js 安装包
访问 Node.js 官方网站,下载 LTS(长期支持)版本的 Windows 安装包(.msi)。
https://nodejs.org/zh-cn/download
2运行安装程序
双击下载的 .msi 文件,按照安装向导一路点击"下一步"完成安装。安装时勾选"Add to PATH"选项(默认已勾选)。
3验证安装
打开命令提示符(Win+R,输入 cmd),执行以下命令验证安装是否成功:
node -v npm -v
若输出版本号(如 v22.x.x),则说明安装成功。
4(可选)使用 nvm-windows 管理多版本
如果需要管理多个 Node.js 版本,推荐使用 nvm-windows:
https://github.com/coreybutler/nvm-windows/releases
1使用 Homebrew 安装(推荐)
如果已安装 Homebrew,直接运行:
brew install node
如未安装 Homebrew,先执行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"2或使用 nvm 管理多版本(推荐)
# 安装 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash # 重新加载 shell 配置 source ~/.zshrc # 或 source ~/.bashrc # 安装最新 LTS 版本 nvm install --lts nvm use --lts
3验证安装
node -v npm -v
1使用 NodeSource 官方源安装(Ubuntu/Debian)
# 下载并运行安装脚本 curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - # 安装 Node.js sudo apt-get install -y nodejs
2或使用 nvm(推荐,适用所有发行版)
# 安装 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash # 加载 nvm export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # 安装最新 LTS nvm install --lts nvm use --lts
3验证安装
node -v npm -v
若输出版本号则安装成功。建议 Node.js 版本 ≥ 18。
Codex 配置教程
OpenAI Codex CLI 是一款基于终端的 AI 编程助手,通过核桃token可使用满血 GPT 模型。
1安装 Codex CLI
确保已安装 Node.js(≥18),然后全局安装 Codex:
npm install -g @openai/codex
2配置 ~/.codex/config.toml
创建或编辑配置文件,将 API 接入地址指向核桃token:
在 Windows 上,配置文件位于 %USERPROFILE%\.codex\config.toml:
# 创建目录 mkdir $env:USERPROFILE\.codex -Force # 打开记事本编辑配置文件 notepad $env:USERPROFILE\.codex\config.toml
mkdir -p ~/.codex nano ~/.codex/config.toml
3填写配置内容
将以下内容写入 config.toml,将 YOUR_API_KEY 替换为你的核桃token Key:
model = "gpt-5.3-codex" approval_policy = "unless-allow-listed" [providers.openai] name = "OpenAI" base_url = "https://api.hetaoapi.com/v1" env_key = "OPENAI_API_KEY"
4设置环境变量
在 PowerShell 中设置(当前会话):
$env:OPENAI_API_KEY = "YOUR_API_KEY"
或在系统环境变量中永久设置:控制面板 → 系统 → 高级系统设置 → 环境变量
# 添加到 ~/.bashrc 或 ~/.zshrc export OPENAI_API_KEY="YOUR_API_KEY" # 立即生效 source ~/.bashrc
5启动 Codex
codex
成功后将看到 Codex 交互界面,可以开始编程对话了。
可用模型参考
| 模型 ID | 说明 |
|---|---|
gpt-5.3-codex | 最新代码模型,Codex 系列能力天花板(推荐) |
gpt-5.5 | 旗舰模型,综合能力最强 |
gpt-5.4 | 复杂工程任务推荐 |
gpt-5.4-mini | 轻量快速,成本低 |
Claude Code 配置教程
Claude Code 是 Anthropic 推出的 AI 编程智能体,通过核桃token可访问 Claude 全系列模型。
1安装 Claude Code
确保已安装 Node.js(≥18),然后全局安装:
npm install -g @anthropic-ai/claude-code
2配置环境变量
Claude Code 通过环境变量接受自定义 API 地址,需要设置以下变量:
在 PowerShell 中临时设置(当前会话有效):
$env:ANTHROPIC_BASE_URL = "https://api.hetaoapi.com" $env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY" # 启动 Claude Code claude
永久设置(写入 PowerShell Profile):
# 打开 Profile 文件 notepad $PROFILE # 在文件中添加以下内容: $env:ANTHROPIC_BASE_URL = "https://api.hetaoapi.com" $env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
# 添加到 ~/.bashrc echo 'export ANTHROPIC_BASE_URL="https://api.hetaoapi.com"' >> ~/.bashrc echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.bashrc # 立即生效 source ~/.bashrc # 启动 claude
# 添加到 ~/.zshrc(macOS 默认 zsh) echo 'export ANTHROPIC_BASE_URL="https://api.hetaoapi.com"' >> ~/.zshrc echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.zshrc # 立即生效 source ~/.zshrc # 启动 claude
3环境变量说明
| 变量名 | 值 | 说明 |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.hetaoapi.com | 核桃token 接入地址 |
ANTHROPIC_AUTH_TOKEN | YOUR_API_KEY | 你的 API Key |
4跳过登录直接使用
首次启动时 Claude Code 会要求登录,通过设置环境变量可跳过此步骤:
# 直接指定 API Key 启动,跳过登录 ANTHROPIC_BASE_URL=https://api.hetaoapi.com ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY claude
推荐将环境变量写入 shell 配置文件,这样每次打开终端都自动生效。
可用模型参考
| 模型 ID | 说明 |
|---|---|
claude-opus-4-7 | 最新旗舰模型,综合能力最强 |
claude-opus-4-6 | 智能代理与编码旗舰 |
claude-sonnet-4-6 | 平衡性能与速度(推荐日常使用) |
claude-haiku-4-5 | 快速响应,适合简单任务 |
Gemini CLI 配置教程
Gemini CLI 是 Google 推出的终端 AI 助手,通过核桃token可访问 Gemini 全系列模型。
1安装 Gemini CLI
确保已安装 Node.js(≥18),然后全局安装:
npm install -g @google/gemini-cli
2配置环境变量
通过环境变量将 Gemini CLI 接入核桃token:
$env:GOOGLE_GEMINI_BASE_URL = "https://api.hetaoapi.com/v1" $env:GEMINI_API_KEY = "YOUR_API_KEY" # 启动 gemini
永久设置(写入 PowerShell Profile):
notepad $PROFILE # 在文件中添加: $env:GOOGLE_GEMINI_BASE_URL = "https://api.hetaoapi.com/v1" $env:GEMINI_API_KEY = "YOUR_API_KEY"
# 添加到 ~/.bashrc echo 'export GOOGLE_GEMINI_BASE_URL="https://api.hetaoapi.com/v1"' >> ~/.bashrc echo 'export GEMINI_API_KEY="YOUR_API_KEY"' >> ~/.bashrc source ~/.bashrc # 启动 gemini
# 添加到 ~/.zshrc echo 'export GOOGLE_GEMINI_BASE_URL="https://api.hetaoapi.com/v1"' >> ~/.zshrc echo 'export GEMINI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc source ~/.zshrc # 启动 gemini
3环境变量说明
| 变量名 | 值 | 说明 |
|---|---|---|
GOOGLE_GEMINI_BASE_URL | https://api.hetaoapi.com/v1 | 核桃token 接入地址 |
GEMINI_API_KEY | YOUR_API_KEY | 你的 API Key |
设置
GOOGLE_GEMINI_BASE_URL 后,Gemini CLI 会自动跳过 Google 登录验证,直接使用自定义 API 地址。4验证配置
# 单次运行测试 gemini -p "你好,测试一下"
可用模型参考
| 模型 ID | 说明 |
|---|---|
gemini-3.1-pro-preview | 最新预览版,性能最强 |
gemini-3-pro-preview | 旗舰版本 |
gemini-2.5-pro | 稳定版旗舰 |
gemini-2.5-flash | 快速响应,性价比高 |
gemini-3-flash-preview | 最新快速预览版 |
OpenClaw 配置教程
OpenClaw 是新一代 AI Agent 平台,支持多模型、多工具调用。通过核桃token可接入全系列模型。
1安装 OpenClaw
确保已安装 Node.js(≥18),然后全局安装:
npm install -g openclaw
2通过 onboard 命令配置核桃token
使用
openclaw onboard 命令配置 API 接入,支持 Anthropic 和 OpenAI 兼容接口:接入 Anthropic(Claude 系列)
openclaw onboard \ --provider anthropic \ --api-key YOUR_API_KEY \ --custom-base-url https://api.hetaoapi.com
接入 OpenAI(GPT/Codex 系列)
openclaw onboard \ --provider openai \ --api-key YOUR_API_KEY \ --custom-base-url https://api.hetaoapi.com/v1
接入 Gemini 系列
openclaw onboard \ --provider gemini \ --api-key YOUR_API_KEY \ --custom-base-url https://api.hetaoapi.com/v1
3Windows 命令格式
在 Windows PowerShell 中,使用反引号续行:
openclaw onboard ` --provider anthropic ` --api-key YOUR_API_KEY ` --custom-base-url https://api.hetaoapi.com
4启动 OpenClaw
openclaw
配置完成后直接运行
openclaw 即可启动,无需额外参数。参数说明
| 参数 | 说明 |
|---|---|
--provider | 提供商:anthropic / openai / gemini |
--api-key | 你的核桃token Key |
--custom-base-url | API 接入地址(见上方) |
Hermes 配置教程
Hermes 是轻量级 AI 终端助手,支持多 Provider 配置,通过核桃token可访问所有主流模型。
1安装 Hermes
确保已安装 Node.js(≥18),然后全局安装:
npm install -g @anthropic-ai/hermes
请参考 Hermes 官方文档确认正确的包名,以上为示例。
2创建配置文件
Hermes 通过 ~/.hermes/config.yaml 进行配置:
mkdir $env:USERPROFILE\.hermes -Force notepad $env:USERPROFILE\.hermes\config.yaml
mkdir -p ~/.hermes nano ~/.hermes/config.yaml
3配置接入核桃token(Anthropic)
使用 Claude 系列模型时,将 config.yaml 配置为:
provider: anthropic api_key: YOUR_API_KEY base_url: https://api.hetaoapi.com model: claude-sonnet-4-6 # 可选配置 max_tokens: 8192 temperature: 0.7
4配置接入核桃token(OpenAI 兼容)
使用 GPT/Codex 系列模型时:
provider: openai api_key: YOUR_API_KEY base_url: https://api.hetaoapi.com/v1 model: gpt-5.3-codex # 可选配置 max_tokens: 8192 temperature: 0.7
5配置接入核桃token(Gemini)
使用 Gemini 系列模型时:
provider: openai api_key: YOUR_API_KEY base_url: https://api.hetaoapi.com/v1 model: gemini-2.5-pro # 可选配置 max_tokens: 8192 temperature: 0.7
核桃token 对 Gemini 提供 OpenAI 兼容接口,provider 填
openai,base_url 用 https://api.hetaoapi.com/v1。6启动 Hermes
hermes
配置完成后直接运行
hermes 即可,Hermes 会自动读取 config.yaml。配置参数说明
| 参数 | 说明 |
|---|---|
provider | anthropic 或 openai(Gemini 也用 openai) |
api_key | 你的核桃token Key |
base_url | Anthropic: https://api.hetaoapi.comOpenAI/Gemini: https://api.hetaoapi.com/v1 |
model | 模型 ID,如 claude-sonnet-4-6、gpt-5.3-codex |
max_tokens | 最大输出 token 数(可选) |
temperature | 输出随机性(0-1,可选) |