首页 Free Claude Code 速查表
2026-05-21 2026-05-21 Alishahryar1/free-claude-code
打开 Zread CodeWiki
340px

🤖 快速定位 >>>

把 Claude Code 的 Anthropic API 请求路由到免费或本地模型。核心思路是起一个本地代理，Claude Code 连接到代理，代理再把请求转发到配置的 provider。
  • 适合场景：免费使用 Claude Code、本地模型开发、私有部署
  • fcc-server fcc-claude：（代理） + （启动 Claude Code）
  • 2026-05-21：（基于 GitHub 最新 commit）
  • Alishahryar1/free-claude-code

🚀 起手工作流 >>>

可以把它理解成"给 Claude Code 找一个免费中转站"。先起代理，再连客户端，不需要每次都重配。

安装与启动

# 安装（uv 方式）
uv tool install --force git+https://github.com/Alishahryar1/free-claude-code.git

# 更新版本同样用这条命令
uv tool install --force git+https://github.com/Alishahryar1/free-claude-code.git

# 启动代理服务
fcc-server

# 启动 Claude Code（连接本地代理）
fcc-claude

最小工作流

# 1. 启动代理（默认端口 8082）
fcc-server

# 2. 代理启动后，终端会显示 Admin UI 地址
# INFO:     Admin UI: http://127.0.0.1:8082/admin (local-only)

# 3. 打开 Admin UI 配置 Provider（NVIDIA NIM/Kimi/OpenRouter 等）

# 4. 启动 Claude Code
fcc-claude

🎛️ Admin UI 配置 >>>

通过浏览器可视化配置各 provider 的 API key 和模型选择，是最推荐的配置方式。

访问与导航

  • http://127.0.0.1:8082/admin：（默认端口 8082）
  • PORT=9000 fcc-server
  • 配置路径：底部显示managed config存储位置

Provider 配置

在 Admin UI 的 Providers 页面配置：
Provider配置项模型示例
NVIDIA NIMNVIDIA_NIM_API_KEYnvidia_nim/nvidia/nemotron-3-super-120b-a12b
KimiKIMI_API_KEYkimi/kimi-k2.5
WaferWAFER_API_KEYwafer/DeepSeek-V4-Pro
OpenRouterOPENROUTER_API_KEYopen_router/stepfun/step-3.5-flash:free
DeepSeekDEEPSEEK_API_KEYdeepseek/deepseek-chat
LM StudioLM_STUDIO_BASE_URLlmstudio/<model-id>
OllamaOLLAMA_BASE_URLollama/llama3.1
OpenCode ZenOPENCODE_API_KEYopencode/gpt-5.3-codex
OpenCode GoOPENCODE_API_KEYopencode_go/minimax-m2.7
Z.aiZAI_API_KEYzai/glm-5.1

模型分层配置

每个模型层级可以设置不同 provider：
MODEL_OPUS=nvidia_nim/moonshotai/kimi-k2.5    # Opus 级
MODEL_SONNET=open_router/deepseek/deepseek-r1-0528:free  # Sonnet 级
MODEL_HAIKU=lmstudio/unsloth/GLM-4.7-Flash-GGUF  # Haiku 级
MODEL=zai/glm-5.1                              # 默认 fallback

⚡ CLI 命令 >>>

代理服务和 Claude Code 启动命令。`fcc-claude` 会自动读取当前配置的端口和认证token，不需要手动设置环境变量。

核心命令

fcc-server          # 启动代理服务（默认 8082 端口）
fcc-init            # 可选的高级配置脚手架（推荐用 Admin UI）
fcc-claude          # 启动 Claude Code，连接本地代理
free-claude-code    # fcc-server 的兼容别名

环境变量方式启动

# 直接启动代理（手动环境变量）
ANTHROPIC_BASE_URL=http://localhost:8082 ANTHROPIC_AUTH_TOKEN=freecc fcc-server

# 手动启动 Claude Code（不推荐，用 fcc-claude 更方便）
ANTHROPIC_BASE_URL=http://localhost:8082 ANTHROPIC_AUTH_TOKEN=freecc claude

🔗 客户端连接 >>>

多种方式连接代理：CLI 直接用、VS Code 扩展、JetBrains ACP、或远程通过 Discord/Telegram 机器人控制。

Claude Code CLI

# 推荐方式：fcc-claude 自动读取配置
fcc-claude

VS Code 扩展

在 settings.json 添加：
"claudeCode.environmentVariables": [
  { "name": "ANTHROPIC_BASE_URL", "value": "http://localhost:8082" },
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "freecc" },
  { "name": "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY", "value": "1" },
  { "name": "CLAUDE_CODE_AUTO_COMPACT_WINDOW", "value": "190000" }
]

JetBrains ACP

编辑 acp-agents/installed.json，设置环境变量：
"env": {
  "ANTHROPIC_BASE_URL": "http://localhost:8082",
  "ANTHROPIC_AUTH_TOKEN": "freecc",
  "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
  "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "190000"
}

Model Picker

Claude Code 的模型选择器支持通过 --gateway-model-discovery 发现代理提供的模型。

💬 消息平台集成 >>>

Discord 或 Telegram 机器人可以通过自然语言远程控制 Claude Code，适合远程编程场景。

Discord 配置

Telegram 配置

Admin UI 配置

机器人命令

命令作用
/stop取消当前任务
/clear重置会话
/stats显示会话状态
回复任务消息可只停止该分支。

🎤 语音笔记 >>>

通过 Discord/Telegram 发送语音，代理会自动转录并传给 Claude Code 处理。

安装语音支持

# NVIDIA NIM 转录（Riva gRPC）
uv tool install --force "free-claude-code[voice] @ git+https://github.com/Alishahryar1/free-claude-code.git"

# 本地 Whisper（CPU 或 CUDA）
uv tool install --force "free-claude-code[voice_local] @ git+https://github.com/Alishahryar1/free-claude-code.git"

# 两者都装
uv tool install --force "free-claude-code[voice,voice_local] @ git+https://github.com/Alishahryar1/free-claude-code.git"

# CUDA 版本
uv tool install --force "free-claude-code[voice_local] @ git+https://github.com/Alishahryar1/free-claude-code.git" --torch-backend cu130

Admin UI 配置

在 Messaging → Voice 页面：
  • 开启 Voice Notes
  • cpu cuda nvidia_nim
  • 设置 Whisper Model
  • 需要 Hugging Face Token 时填入

📡 Provider 详解 >>>

各 provider 的接入方式、API key 获取地址、模型列表地址。选一个最合适的入手。

NVIDIA NIM

  • 获取 key：build.nvidia.com/settings/api-keys
  • 模型浏览：build.nvidia.com/explore/discover
  • nvidia_nim/nvidia/nemotron-3-super-120b-a12b nvidia_nim/moonshotai/kimi-k2.5：、

Kimi

  • 获取 key：platform.moonshot.ai/console/api-keys
  • 模型浏览：platform.moonshot.ai
  • kimi/kimi-k2.5

OpenRouter

  • 获取 key：openrouter.ai/keys
  • 模型浏览：openrouter.ai/models、免费模型
  • open_router/stepfun/step-3.5-flash:free

DeepSeek

  • 获取 key：platform.deepseek.com/api_keys
  • deepseek/deepseek-chat

LM Studio

Ollama

ollama pull llama3.1
ollama serve
模型 slug：ollama/llama3.1、ollama/llama3.1:8b

OpenCode Zen / Go

  • 获取 key：opencode.ai/auth
  • 两者共用同一个 API key，仅 slug 前缀不同
  • https://opencode.ai/zen/v1
  • https://opencode.ai/zen/go/v1
  • opencode/claude-sonnet-4 opencode_go/minimax-m2.7：、

Z.ai

  • 获取 key：Z.ai/manage-apikey/apikey-list
  • https://api.z.ai/api/coding/paas/v4
  • zai/glm-5.1 zai/glm-5-turbo：、

🏗️ 工作原理 >>>

理解请求链路方便排查问题和选择 provider。
Claude Code → fcc-server (本地 8082) → Provider API
                           ↓
              转换 OpenAI 流式响应
              规范化 tool calls
              处理 thinking blocks
              优化 token 使用

传输类型

  • OpenAI 兼容传输（转成 Anthropic SSE）：NIM、OpenCode Zen、OpenCode Go、Z.ai
  • Anthropic Messages 原生传输：Wafer、OpenRouter、DeepSeek、LM Studio、llama.cpp、Ollama

🧪 高频 Recipes >>>

常见使用场景的最短路径。

1. NVIDIA NIM 最快上手

# 1. 安装
uv tool install --force git+https://github.com/Alishahryar1/free-claude-code.git

# 2. 启动代理
fcc-server

# 3. 打开 http://127.0.0.1:8082/admin
# 4. 在 Providers 页面粘贴 NVIDIA NIM API key
# 5. 默认模型已经配置好：nvidia_nim/nvidia/nemotron-3-super-120b-a12b

# 6. 新开终端启动 Claude Code
fcc-claude

2. 本地模型（Ollama）

ollama pull llama3.1
ollama serve

# Admin UI 设置：
# OLLAMA_BASE_URL=http://localhost:11434
# MODEL=ollama/llama3.1

3. Discord 远程编程

# 配置好 Discord bot 后
fcc-server

# 在 Discord 频道发送消息，bot 会启动 Claude Code 会话
# 使用 /stop 取消任务，/clear 重置

🔧 开发与调试 >>>

从源码运行和开发调试。

从源码运行

git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
uv run uvicorn server:app --host 0.0.0.0 --port 8082

代码检查

uv run ruff format
uv run ruff check
uv run ty check
uv run pytest
推送前需通过全部检查，CI 同样执行这套。

不要混淆：free-claude-code vs MCP

free-claude-codeMCP Server
作用代理 Claude Code 请求到各种 provider给 Claude Code 提供工具能力（数据库、API等）
层级网络请求层工具能力层
关系可以一起用，fcc-server 转发请求，MCP 提供额外工具