Free Claude Code 的部署只需四步：安装 Python 3.14 和 uv、克隆仓库并配置 .env、启动代理、设置环境变量连接 Claude Code CLI。本文覆盖 Windows、macOS、Linux 三个平台的完整操作。

Free Claude Code 安装部署教程：5 分钟从零启动 Anthropic 代理

前置条件

你需要：

• Claude Code CLI 已安装
• Python 3.14（项目使用 Python 3.14 新语法特性）
• uv 包管理器

第一步：安装 Python 和 uv

macOS / Linux：

# 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh
# 如果已安装，更新到最新
uv self update
# 安装 Python 3.14
uv python install 3.14

Windows PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv self update
uv python install 3.14

验证安装：

uv --version
uv python list --installed

第二步：克隆仓库并配置

git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code

复制环境变量模板：

# macOS / Linux
cp .env.example .env

# Windows PowerShell
Copy-Item .env.example .env

编辑 .env，选择一个 Provider 配置。最简配置（NVIDIA NIM）：

NVIDIA_NIM_API_KEY="nvapi-你的密钥"
MODEL="nvidia_nim/z-ai/glm4.7"
ANTHROPIC_AUTH_TOKEN="freecc"

ANTHROPIC_AUTH_TOKEN 可以设成任意字符串，Claude Code 会原样发回给代理作为认证凭据。留空表示不校验（仅限本地测试）。

选哪个 Provider？

场景	推荐 Provider	说明
先跑起来试试	NVIDIA NIM	免费 GPU 额度，申请 API Key 即可
有 DeepSeek 账号	DeepSeek	价格低，中文能力强
想用多种免费模型	OpenRouter	有免费模型池，模型选择多
完全不想联网	Ollama / LM Studio	本地跑模型，零成本

更多 Provider 配置细节，参见各 Provider 专文：NVIDIA NIM、OpenRouter / DeepSeek、本地模型。

第三步：启动代理

uv run uvicorn server:app --host 0.0.0.0 --port 8082

看到类似 Uvicorn running on http://0.0.0.0:8082 的输出就说明启动成功。

也可以通过包安装方式运行（启动命令更简洁）：

uv tool install git+https://github.com/Alishahryar1/free-claude-code.git
fcc-init    # 创建 ~/.config/free-claude-code/.env 配置模板
free-claude-code  # 启动代理

fcc-init 会在 ~/.config/free-claude-code/ 创建 .env 模板，编辑后用 free-claude-code 命令直接启动。

第四步：连接 Claude Code CLI

设置两个环境变量，然后正常启动 claude 命令：

Bash / zsh：

ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude

PowerShell：

$env:ANTHROPIC_AUTH_TOKEN="freecc"; $env:ANTHROPIC_BASE_URL="http://localhost:8082"; claude

ANTHROPIC_BASE_URL 指向代理根地址，不要加 /v1 后缀。代理内部已经处理了路径路由。

连接成功后，Claude Code 的对话就会通过代理走你配置的 Provider。你可以正常对话、使用工具、执行代码——一切和直接用 Anthropic API 一样。

验证代理是否正常

代理根地址返回当前配置信息：

curl http://localhost:8082/
# 返回 {"status":"ok","provider":"nvidia_nim","model":"z-ai/glm4.7"}

健康检查：

curl http://localhost:8082/health
# 返回 {"status":"healthy"}

FAQ

Q: 启动报错 uv: command not found 怎么办？ A: uv 安装后需要重新打开终端，或者手动 source 一下：source ~/.bashrc（Linux）或 source ~/.zshrc（macOS）。Windows 用户检查 %USERPROFILE%\.local\bin 是否在 PATH 中。

Q: 端口 8082 被占用了怎么办？ A: 换一个端口：uv run uvicorn server:app --host 0.0.0.0 --port 9090。然后 ANTHROPIC_BASE_URL 也改成对应端口。

Q: 代理启动了但 Claude Code 连不上？ A: 先检查代理是否正常运行（访问 /health），再确认 ANTHROPIC_BASE_URL 没有多余的 /v1 后缀。Windows 用户注意 PowerShell 的环境变量语法和 Bash 不同，不能用 KEY=value command 的写法。