使用文档 — ShareZZZ

TUTORIAL

接入教程

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

懒人一键安装
不想看下面的分步教程？一条命令自动安装并配置好 Codex CLI；脚本会提示输入 API 密钥：

选择你的操作系统

1Windows PowerShell 一键安装

POWERSHELL

irm https://www.sharezzz.com/install.ps1 | iex

2启动 Codex

POWERSHELL

codex

1macOS / Linux / WSL 一键安装

BASH

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

2启动 Codex

BASH

codex

手动分步教程　一键脚本失败、或想了解每一步细节时展开

选择产品

选择使用方式

选择操作系统

Codex 简介
OpenAI Codex CLI 是 OpenAI 官方推出的命令行 AI 编程助手，类似于 Claude Code，但使用 OpenAI 的模型（如 GPT-4o、o1、o3 等）。通过 ShareZZZ 接入，无需海外信用卡，小额捐赠即可直接调用。

推荐使用 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 接入 ShareZZZ，直接写入真实地址和密钥，无需配置环境变量、无需重启终端。

创建配置目录

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 = "ShareZZZ"
base_url = "https://api.sharezzz.com"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

model 和 review_model 可按你的套餐和分组改成其它可用模型。若不确定，先使用 gpt-5.5。

写入 auth.json

在 %USERPROFILE%\.codex\auth.json 中写入 ShareZZZ 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 配置）。

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 接入 ShareZZZ，直接写入真实地址和密钥，无需配置环境变量、无需重启终端。

创建配置目录

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 = "ShareZZZ"
base_url = "https://api.sharezzz.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

# 写入 ShareZZZ 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.sharezzz.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

Get-ChildItem Env:ANTHROPIC_*

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.sharezzz.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）。

注册即送免费额度

按量计费 · 捐赠使用 · 随时停止

免费注册 → 查看定价