Claude Code & Codex 完整安装与使用指南

Husan AI 文档中心 · husanai.com · 客服QQ：25248185

一站式接入 Claude / Codex / OpenAI（ChatGPT / GPT Pro）

支持 Claude Code、Claude API、OpenAI 兼容、企业代理与中转；文档与客服一体服务。

立即前往官网

简介

本指南覆盖 Claude Code 与 Codex 的完整安装、配置与使用流程，支持 Windows / macOS / Linux / WSL2。示例均接入 Husan AI 中转服务（husanai.com）。

文中同时给出 Claude API / Claude Code API、OpenAI 兼容（ChatGPT / GPT Pro） 接入方式与常见网络代理设置，适合个人开发者与企业团队快速落地。你可能也会在社区看到我们被称为 “虎三 / 虎三API / 虎三公益站 / 虎三小破站”，这些都是 Husan AI 的常见别称。

安全提示：请妥善保管 API 密钥，勿提交至 Git 仓库或公共页面。

前置要求

  • Node.js：建议安装 LTS 版本（附带 npm）。
  • 网络：可正常访问 husanai.com。
  • 终端：Windows 建议使用 PowerShell；macOS/Linux 使用 Terminal/Zsh/Bash。

1安装 Node.js

Windows

  • 前往 nodejs.org 下载并安装 LTS。
  • 或使用包管理器（管理员模式 PowerShell）：
choco install nodejs -y
scoop install nodejs
安装完成后运行 node -v 与 npm -v 验证。

macOS

推荐 Homebrew 或 nvm：

# 使用 Homebrew
brew install node

# 或使用 nvm 管理多版本
brew install nvm
mkdir -p ~/.nvm
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && . "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.zshrc
source ~/.zshrc
nvm install --lts
nvm use --lts

Linux / WSL2

# Debian / Ubuntu
sudo apt update
sudo apt install -y nodejs npm

# 或使用 nvm（建议多版本管理）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc   # 或 ~/.zshrc
nvm install --lts
nvm use --lts

2安装 Claude Code

在终端运行以下命令：

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

验证安装：

claude --version

3配置环境变量（接入 Husan AI）

为使 Claude Code 连接至中转服务，设置以下变量：

PowerShell（当前会话）

$env:ANTHROPIC_BASE_URL="https://husanai.com"
$env:ANTHROPIC_AUTH_TOKEN="你的API密钥"

PowerShell（用户级，永久）

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://husanai.com",[System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","你的API密钥",[System.EnvironmentVariableTarget]::User)

macOS / Linux（当前会话）

export ANTHROPIC_BASE_URL="https://husanai.com"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

macOS / Linux（永久写入 shell 配置）

# zsh
echo 'export ANTHROPIC_BASE_URL="https://husanai.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

# bash
echo 'export ANTHROPIC_BASE_URL="https://husanai.com"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
source ~/.bashrc
设置用户级环境变量后，请重新打开终端窗口以生效。

4验证安装与连通性

检查环境变量是否可见

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

网络连通性快速检查

# 仅验证站点可达（查看返回状态头部即可）
curl -sS -D - -o /dev/null https://husanai.com
若有企业代理，请先配置 HTTPS_PROXY/HTTP_PROXY，详见下文“网络与代理”。

5开始使用 Claude Code

全局启动：

claude

在指定项目中启动：

cd /path/to/your/project
claude

6配置 Codex

若你使用支持 OpenAI API 的工具（如 Codex），可按下列配置接入 Husan AI：

~/.codex/config.toml

model_provider = "husanai"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.husanai]
name = "husanai"
base_url = "https://husanai.com/v1"
wire_api = "responses"

~/.codex/auth.json

{
  "OPENAI_API_KEY": "你的API密钥"
}
需使用 Codex 专用分组 API Key（形如 sk-xxxxxxxxxx）。

升级与卸载

升级到最新版本

npm update -g @anthropic-ai/claude-code

卸载

npm uninstall -g @anthropic-ai/claude-code

网络与代理（企业/校园网环境）

若处于代理或受限网络，可在终端设置代理环境变量：

PowerShell

$env:HTTPS_PROXY="http://127.0.0.1:7890"
$env:HTTP_PROXY="http://127.0.0.1:7890"

macOS / Linux

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
确保代理软件与系统证书配置正确，不建议关闭 TLS 校验。

常见问题与排错

1) 安装时提示 “permission denied”

  • Windows 以管理员身份打开 PowerShell。
  • 或将 npm 全局目录改到用户空间：
npm config set prefix %APPDATA%\npm

2) PowerShell 执行策略限制

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

3) 运行 claude 显示 “command not found”

将 npm 全局 bin 目录加入 PATH：

Windows（用户级 PATH）

$bin = "$HOME\AppData\Roaming\npm"
[Environment]::SetEnvironmentVariable("Path", "$($env:Path);$bin", "User")
# 关闭并重新打开 PowerShell

macOS / Linux

# 查看全局 bin 路径
npm bin -g
# 假设输出为 /usr/local/bin 或 $HOME/.npm-global/bin
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

4) 网络错误（ECONNREFUSED / ETIMEDOUT / TLS）

  • 确认可访问：curl -sS -D - -o /dev/null https://husanai.com
  • 如需代理，设置 HTTPS_PROXY/HTTP_PROXY。
  • 检查本机时间是否准确，避免证书验证失败。

5) 环境变量不生效

  • 设置用户级变量后需重启终端或注销重新登录。
  • 用 echo 检查变量是否可见（见“验证安装与连通性”）。

分发规则

⚠️ 分发须知：

  • 单笔实付满 1000 元 即可获得分发资格。
  • 续费金额 500 元起。
  • 如发现私自分发，平台将直接封号处理且不退款。
  • 分发充值比例可联系客服 QQ：25248185 协商。

名词对照与常见别称

以下名词用于帮助搜索与检索，覆盖社区常见叫法与长尾关键词：

  • Claude / Claude Code / Claude API / Claude Code API：Anthropic 生态与本地开发工具链。
  • Claude 中转 / Claude 中转站：通过 Husan AI 等服务进行 API 中转接入。
  • OpenAI / ChatGPT / chatGpt / GPT Pro / Gpt Pro：OpenAI 提供的通用大模型与专业版能力。
  • Codex：支持 OpenAI 兼容 API 的开发工具，文中给出与 Husan AI 的配置示例。
  • 虎三 / 虎三API / 虎三公益站 / 虎三小破站：Husan AI 在社区中的常见称呼与别名。

联系与支持

欢迎反馈改进建议，我们会持续完善文档与示例。

🎉 恭喜你完成安装与配置，祝使用顺利！

前往官网