TUTORIAL

接入教程

选择产品和操作系统，按步骤完成安装与 OneKeyAllModels 配置，约 3 分钟。

懒人一键安装
不想看下面的分步教程？一条命令自动安装并配置好 CLI；脚本会提示输入 API 密钥：
选择产品
选择你的操作系统

1Windows PowerShell 一键安装

POWERSHELL
irm https://www.onekeyallmodels.com/install.ps1 | iex

2启动 Codex

POWERSHELL
codex
已装过 Codex？一键升级到最新版　保留 ~/.codex 配置与 API 密钥，无需重新填写
POWERSHELL
irm https://www.onekeyallmodels.com/upgrade.ps1 | iex

走 npm 镜像升级，失败时自动回退官方源。还没装过 Codex？用上面的 install.ps1。

1macOS / Linux / WSL 一键安装

BASH
curl -fsSL https://onekeyallmodels.com/install.sh | sh -s -- codex

2启动 Codex

BASH
codex
已装过 Codex？一键升级到最新版　保留 ~/.codex 配置与 API 密钥，无需重新填写
BASH
npm install -g @openai/codex --registry=https://registry.npmmirror.com

镜像源失败时改用官方源：npm install -g @openai/codex。还没装过 Codex？用上面的 install.sh。

1Windows PowerShell 一键安装

POWERSHELL
irm https://www.onekeyallmodels.com/claude-install.ps1 | iex

自动装好 Git for Windows、Node.js 和 Claude Code，并写入环境变量。无需管理员权限（Git 安装器本身可能仍会弹系统授权框）。

2启动 Claude Code

POWERSHELL
claude
已装过 Claude Code？一键升级到最新版　保留现有环境变量与 API 密钥，无需重新填写
POWERSHELL
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

镜像源失败时改用官方源：npm install -g @anthropic-ai/claude-code。还没装过？用上面的 claude-install.ps1。

1macOS / Linux / WSL 一键安装

BASH
curl -fsSL https://onekeyallmodels.com/claude-install.sh | sh

自动装好 Node.js 和 Claude Code，并把环境变量写进 shell 配置文件。已有密钥可免交互：curl -fsSL https://onekeyallmodels.com/claude-install.sh | sh -s -- --api-key sk-xxx

2启动 Claude Code

BASH
claude
已装过 Claude Code？一键升级到最新版　保留现有环境变量与 API 密钥，无需重新填写
BASH
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

镜像源失败时改用官方源：npm install -g @anthropic-ai/claude-code。还没装过？用上面的 claude-install.sh。

需要翻墙
Grok 官方安装包托管在 x.ai，国内网络通常无法直接下载。请先开启代理 / VPN，再执行下面的命令。

1Windows PowerShell 一键安装

POWERSHELL
irm https://www.onekeyallmodels.com/grok-install.ps1 | iex

通过官方地址安装 Grok CLI，并把 OneKeyAllModels 配置写入 %USERPROFILE%\.grok\config.toml。脚本会提示输入 API 密钥。

2启动 Grok

POWERSHELL
grok -m third-grok
已装过 Grok？一键升级到最新版　保留 ~/.grok 配置与 API 密钥，无需重新填写
升级同样要从 x.ai 拉包，请先开启代理 / VPN。
POWERSHELL
grok update

官方自带升级，不会改 %USERPROFILE%\.grok\config.toml。还没装过？用上面的 grok-install.ps1。

需要翻墙
Grok 官方安装包托管在 x.ai，国内网络通常无法直接下载。请先开启代理 / VPN，再执行下面的命令。

1macOS / Linux / WSL 一键安装

BASH
curl -fsSL https://onekeyallmodels.com/grok-install.sh | sh

通过官方地址安装 Grok CLI，并把配置写入 ~/.grok/config.toml。已有密钥可免交互：curl -fsSL https://onekeyallmodels.com/grok-install.sh | sh -s -- --api-key sk-xxx

2启动 Grok

BASH
grok -m third-grok
已装过 Grok？一键升级到最新版　保留 ~/.grok 配置与 API 密钥，无需重新填写
升级同样要从 x.ai 拉包，请先开启代理 / VPN。
BASH
grok update

官方自带升级，不会改 ~/.grok/config.toml。还没装过？用上面的 grok-install.sh。

手动分步教程　一键脚本失败、或想了解每一步细节时展开
选择产品
选择使用方式
选择操作系统
Codex 简介
OpenAI Codex CLI 是 OpenAI 官方推出的命令行 AI 编程助手，类似于 Claude Code，但使用 OpenAI 的模型（如 GPT-4o、o1、o3 等）。通过 OneKeyAllModels 接入，无需海外信用卡，小额捐赠即可直接调用。
推荐使用 WSL 或 Git Bash
Codex 在 Windows 上推荐使用 WSL（Windows Subsystem for Linux）安装和运行，兼容性最好。如果不想装 WSL，至少使用 Git Bash 来运行 Codex。PowerShell 兼容性较差，可能遇到文件锁定、写入失败（error write file）等问题。

0安装 Git

一键安装会自动安装 Git for Windows，默认使用国内镜像，失败后才使用官方地址；根据安装位置，Windows 可能要求授权。手动安装可前往 git-scm.com，保持默认选项；安装后重启终端验证：

POWERSHELL
git --version

1安装 Node.js 和 Codex

Codex CLI 通过 npm 安装，需要 Node.js 18+。

手动安装 Node.js（备用）
POWERSHELL
# 手动备用方案：WinGet
winget install OpenJS.NodeJS.LTS

# 或前往官网下载
# https://nodejs.org/
POWERSHELL · 验证
node --version
npm --version
安装 Codex CLI
POWERSHELL / BASH
npm install -g @openai/codex --registry=https://registry.npmmirror.com

# 国内镜像失败时再使用官方源
npm install -g @openai/codex --registry=https://registry.npmjs.org
验证安装
POWERSHELL
codex --version

2写入配置文件

Codex CLI 通过 ~/.codex/config.toml 和 ~/.codex/auth.json 接入 OneKeyAllModels，直接写入真实地址和密钥，无需配置环境变量、无需重启终端。

创建配置目录
POWERSHELL
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"
写入 config.toml

在 %USERPROFILE%\.codex\config.toml 中写入：

TOML
model_provider = "OpenAI"
model = "gpt-5.6-luna"
review_model = "gpt-5.6-luna"
model_reasoning_effort = "medium"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OneKeyAllModels"
base_url = "https://api.onekeyallmodels.com"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true
model 和 review_model 可按你的套餐和分组改成其它可用模型。若不确定，先使用 gpt-5.5。
写入 auth.json

在 %USERPROFILE%\.codex\auth.json 中写入 OneKeyAllModels API密钥：

JSON
{
  "OPENAI_API_KEY": "your_api_key_here"
}
auth.json 包含密钥，不要提交到 Git，也不要发给他人。

3启动 Codex

BASH / GIT BASH
# 进入项目目录
cd /c/path/to/your/project

# 启动（推荐在 Git Bash 或 WSL 中运行）
codex
首次运行会进行初始化。若提示登录 OpenAI，选择跳过或直接使用 API Key 模式（已通过 config.toml / auth.json 配置）。
Codex 简介
OpenAI Codex CLI 是 OpenAI 官方推出的命令行 AI 编程助手，类似于 Claude Code，但使用 OpenAI 的模型（如 GPT-4o、o1、o3 等）。通过 OneKeyAllModels 接入，无需海外信用卡，小额捐赠即可直接调用。
macOS 默认 shell 为 zsh（可通过 echo $SHELL 确认）。推荐使用系统「终端」或 iTerm2。

1安装 Node.js 和 Codex

安装 Node.js
BASH
# 自动识别系统架构，从国内镜像下载安装 Node.js LTS 到 ~/.local/node
ARCH="$(uname -m)"; case "$ARCH" in x86_64) ARCH=x64 ;; arm64|aarch64) ARCH=arm64 ;; esac
OS="$(uname -s | tr '[:upper:]' '[:lower:]')"
mkdir -p ~/.local/node
FILE="$(curl -fsSL https://npmmirror.com/mirrors/node/latest-v24.x/SHASUMS256.txt | grep -o "node-v[0-9.]*-$OS-$ARCH.tar.gz" | head -1)"
curl -fsSL "https://npmmirror.com/mirrors/node/latest-v24.x/$FILE" | tar -xz -C ~/.local/node --strip-components=1
echo 'export PATH="$HOME/.local/node/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
安装失败（网络原因）？可前往官网 nodejs.org 手动下载对应平台的 LTS 安装包。
安装 Codex CLI
BASH
npm install -g @openai/codex --registry=https://registry.npmmirror.com

# 国内镜像失败时再使用官方源
npm install -g @openai/codex --registry=https://registry.npmjs.org
验证安装
BASH
codex --version

2写入配置文件

Codex CLI 通过 ~/.codex/config.toml 和 ~/.codex/auth.json 接入 OneKeyAllModels，直接写入真实地址和密钥，无需配置环境变量、无需重启终端。

创建配置目录
BASH
mkdir -p ~/.codex
写入 config.toml
BASH
# 打开配置文件
nano ~/.codex/config.toml

# 写入以下内容：
model_provider = "OpenAI"
model = "gpt-5.6-luna"
review_model = "gpt-5.6-luna"
model_reasoning_effort = "medium"
disable_response_storage = true
network_access = "enabled"

[model_providers.OpenAI]
name = "OneKeyAllModels"
base_url = "https://api.onekeyallmodels.com"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

# 保存（Ctrl+O → Enter → Ctrl+X）
model 和 review_model 可按你的套餐和分组改成其它可用模型。若不确定，先使用 gpt-5.5。
写入 auth.json
BASH
# 打开配置文件
nano ~/.codex/auth.json

# 写入 OneKeyAllModels API密钥：
{
  "OPENAI_API_KEY": "your_api_key_here"
}
auth.json 包含密钥，不要提交到 Git，也不要发给他人。

3启动 Codex

BASH
# 进入项目目录
cd /path/to/your/project

# 启动
codex
首次运行会进行初始化。若提示登录 OpenAI，选择跳过或使用 API Key 模式（已通过 config.toml / auth.json 配置）。
推荐使用 WSL 或 Git Bash
Claude Code 在 Windows 原生 PowerShell/CMD 下可能遇到文件锁定、路径问题。推荐使用 WSL 或 Git Bash 安装和运行。若必须使用 PowerShell，请以管理员权限运行。
推荐安装 Windows Terminal（微软官方现代终端，多标签 + 更好的中文显示），可从 Microsoft Store 免费获取。

0前置要求：安装 Git

Claude Code 依赖 Git 运行。若启动后看到以下错误，说明需要先安装 Git：

ERROR
Claude Code on Windows requires git-bash (https://git-scm.com/downloads/win).
If installed but not in PATH, set environment variable:
  CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe

前往 git-scm.com 下载安装，保持默认选项。安装后重启终端验证：

POWERSHELL
git --version
Git 已安装但提示找不到 bash？自动检测路径
POWERSHELL · 管理员
$p = @(
  "$env:ProgramFiles\Git\bin\bash.exe",
  "${env:ProgramFiles(x86)}\Git\bin\bash.exe",
  "$env:LOCALAPPDATA\Programs\Git\bin\bash.exe"
)
$f = $p | Where-Object { Test-Path $_ } | Select-Object -First 1
if ($f) {
    [Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", $f, "Machine")
    "已设置: $f"
} else { "未找到 Git，请先安装" }

1安装 Claude Code

官方推荐，无需 Node.js，后台自动更新：

POWERSHELL
irm https://claude.ai/install.ps1 | iex
POWERSHELL
winget install Anthropic.ClaudeCode
WinGet 不会自动更新，需手动运行 winget upgrade Anthropic.ClaudeCode。
已被官方标记弃用，需要 Node.js 18+。
POWERSHELL
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
验证安装
POWERSHELL
claude --version

2配置环境变量

按 Win+X → 选择「终端管理员」，运行（替换为你的域名和 Key）：

POWERSHELL · 管理员
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.onekeyallmodels.com", [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-YOUR_API_KEY", [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "3000000", [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", [System.EnvironmentVariableTarget]::Machine)
设置完必须关掉这个窗口，重新打开一个 PowerShell。 Machine 级环境变量写进的是注册表，当前窗口是启动时就加载好的旧环境，读不到新值 —— 在原窗口里验证会显示为空，这是正常的，不代表设置失败。
验证（在新开的 PowerShell 窗口里运行）
POWERSHELL · 新窗口
Get-ChildItem Env:ANTHROPIC_*

应当列出 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 两项。若新窗口里仍为空，说明上面的命令没有以管理员身份运行（Machine 级需要管理员权限），请用「终端管理员」重新执行一遍。

3启动 Claude Code

POWERSHELL / BASH
cd C:\path\to\your\project
claude
首次启动会进行初始化。若弹出登录提示，按 Esc 跳过（已通过环境变量配置了 Key）。
macOS 默认 shell 为 zsh（可通过 echo $SHELL 确认）。推荐使用系统「终端」或 iTerm2。

1安装 Claude Code

官方推荐，无需 Node.js，后台自动更新：

BASH
curl -fsSL https://claude.ai/install.sh | sh
BASH
brew install claude-code
已被官方标记弃用，需要 Node.js 18+。
BASH
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
验证安装
BASH
claude --version

2配置环境变量

BASH
# 打开配置文件
nano ~/.zshrc

# 在末尾添加（替换为你的域名和 Key）：
export ANTHROPIC_BASE_URL="https://api.onekeyallmodels.com"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_API_KEY"
export API_TIMEOUT_MS="3000000"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

# 保存后应用：
source ~/.zshrc
验证
BASH
env | grep ANTHROPIC

3启动 Claude Code

BASH
cd /path/to/your/project
claude
首次启动会进行初始化。若弹出登录提示，按 Esc 跳过（已通过环境变量配置了 Key）。
Grok 简介
Grok CLI 是 xAI 官方推出的终端 AI 编程助手。通过 OneKeyAllModels 接入，无需海外信用卡，把密钥写进 ~/.grok/config.toml 即可直接调用。
需要翻墙
Grok 官方安装包托管在 x.ai，国内网络通常无法直接下载。请先开启代理 / VPN，再执行安装命令。

1安装 Grok CLI

使用官方 PowerShell 安装脚本，无需 Node.js：

POWERSHELL
irm https://x.ai/cli/install.ps1 | iex

官方安装器会把 grok 放到 %USERPROFILE%\.grok\bin，并写入用户 PATH。安装完成后请重新打开 PowerShell。

验证安装
POWERSHELL
grok --version

2写入配置文件

Grok CLI 通过 %USERPROFILE%\.grok\config.toml 接入 OneKeyAllModels，直接写入真实地址和密钥，无需配置环境变量。

创建配置目录
POWERSHELL
New-Item -ItemType Directory -Force "$env:USERPROFILE\.grok"
写入 config.toml

在 %USERPROFILE%\.grok\config.toml 中写入（把 api_key 换成你的密钥）：

TOML
[cli]
installer = "internal"
auto_update = true

[auth]
preferred_method = "api_key"

[models]
default = "third-grok"
default_reasoning_effort = "low"
session_summary = "third-grok"

[model.third-grok]
model = "grok-4.6"
name = "Third-party Grok 4.6"
base_url = "https://api.onekeyallmodels.com/v1"
api_key = "替换为你的密钥Key"
api_backend = "chat_completions"
context_window = 500000

[marketplace]
default_skills_installs_purged = true

[ui]
max_thoughts_width = 120
fork_secondary_model = "third-grok"
yolo = false
compact_mode = false
permission_mode = "always-approve"
prompt_suggestions = false
config.toml 包含密钥，不要提交到 Git，也不要发给他人。

3启动 Grok

POWERSHELL
# 进入项目目录
cd C:\path\to\your\project

# 启动
grok -m third-grok
已通过 config.toml 配置 API Key 模式。若仍弹出浏览器登录，选择 API Key 或跳过即可。
Grok 简介
Grok CLI 是 xAI 官方推出的终端 AI 编程助手。通过 OneKeyAllModels 接入，无需海外信用卡，把密钥写进 ~/.grok/config.toml 即可直接调用。
需要翻墙
Grok 官方安装包托管在 x.ai，国内网络通常无法直接下载。请先开启代理 / VPN，再执行安装命令。
macOS 默认 shell 为 zsh（可通过 echo $SHELL 确认）。推荐使用系统「终端」或 iTerm2。

1安装 Grok CLI

使用官方安装脚本，无需 Node.js：

BASH
curl -fsSL https://x.ai/cli/install.sh | bash
验证安装
BASH
grok --version

2写入配置文件

Grok CLI 通过 ~/.grok/config.toml 接入 OneKeyAllModels，直接写入真实地址和密钥，无需配置环境变量。

创建配置目录
BASH
mkdir -p ~/.grok
写入 config.toml
BASH
# 打开配置文件
nano ~/.grok/config.toml

# 写入以下内容（把 api_key 换成你的密钥）：
[cli]
installer = "internal"
auto_update = true

[auth]
preferred_method = "api_key"

[models]
default = "third-grok"
default_reasoning_effort = "low"
session_summary = "third-grok"

[model.third-grok]
model = "grok-4.6"
name = "Third-party Grok 4.6"
base_url = "https://api.onekeyallmodels.com/v1"
api_key = "替换为你的密钥Key"
api_backend = "chat_completions"
context_window = 500000

[marketplace]
default_skills_installs_purged = true

[ui]
max_thoughts_width = 120
fork_secondary_model = "third-grok"
yolo = false
compact_mode = false
permission_mode = "always-approve"
prompt_suggestions = false

# 保存（Ctrl+O → Enter → Ctrl+X）
config.toml 包含密钥，不要提交到 Git，也不要发给他人。

3启动 Grok

BASH
# 进入项目目录
cd /path/to/your/project

# 启动
grok -m third-grok
已通过 config.toml 配置 API Key 模式。若仍弹出浏览器登录，选择 API Key 或跳过即可。
注册即送免费额度
按量计费 · 捐赠使用 · 随时停止
免费注册 → 查看定价