ByteNoteByteNote
Claude Code Proxy - 接入 OpenRouter/Ollama 的轻量 HTTP 代理
字

字节笔记本

2026年5月12日

Claude Code Proxy - 接入 OpenRouter/Ollama 的轻量 HTTP 代理

#Claude Code
API中转
¥120

本文介绍 claude-code-proxy，一个轻量级 HTTP 代理工具，让 Claude Code 能够接入 OpenRouter（200+ 模型）、OpenAI Direct（GPT-5）和 Ollama（本地推理）等 OpenAI 兼容 API 提供商，实现全功能代理访问。

项目简介

claude-code-proxy 是由 nielspeter 开发的开源项目，使用 Go 语言编写。截至目前，该项目在 GitHub 上已获得 34 stars 和 10 forks，采用 MIT 许可证发布。

它可以作为 Claude Code 与第三方 API 之间的桥梁，完全支持 Claude Code 的所有功能，包括工具调用、流式响应、思考块显示等。无论你是想使用 OpenRouter 上的 200+ 模型，还是想通过 Ollama 在本地运行开源模型，都能无缝对接。

核心特性

  • 完整 Claude Code 兼容：完全支持所有 Claude Code 功能，包括工具调用（read、write、edit、glob、grep、bash 等）、扩展思考块、流式响应和 SSE 事件格式
  • 多提供商支持：支持 OpenRouter（200+ 模型）、OpenAI Direct（GPT-5 推理）和 Ollama（本地推理）
  • 自适应模型检测：自动学习每个模型支持的参数，无需硬编码模型列表，可与任何未来模型/提供商兼容
  • 模式化路由：自动检测 Claude 模型并路由到对应的后端模型
  • 零依赖：单一约 10MB 二进制文件，无需运行时环境
  • 守护进程模式：后台运行，可同时服务多个 Claude Code 会话
  • 快速启动：冷启动 < 10ms
  • 配置灵活：支持从 ~/.claude/proxy.env 或 .env 加载配置
  • 透传模式：可选直接代理到 Anthropic API，方便调试

技术栈

  • Go - 核心语言，编译为单一二进制文件
  • OpenAI API 协议 - 与 Claude Code 的通信协议标准
  • SSE（Server-Sent Events） - 流式响应传输

安装指南

前置要求

  • Go 1.21+
  • Claude Code CLI

安装步骤

bash
# 克隆仓库
git clone https://github.com/nielspeter/claude-code-proxy.git
cd claude-code-proxy

# 安装依赖
go mod download

# 编译
go build -o claude-code-proxy cmd/claude-code-proxy/main.go

# 或使用 make
make build

# 系统级安装（推荐）
make install

配置

OpenRouter 配置（推荐）：

bash
mkdir -p ~/.claude
cat > ~/.claude/proxy.env << 'EOF'
OPENAI_BASE_URL=https://openrouter.ai/api/v1
OPENAI_API_KEY=sk-or-v1-your-openrouter-key
ANTHROPIC_DEFAULT_SONNET_MODEL=x-ai/grok-code-fast-1
ANTHROPIC_DEFAULT_HAIKU_MODEL=google/gemini-2.5-flash
EOF

OpenAI Direct 配置：

bash
cat > ~/.claude/proxy.env << 'EOF'
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_API_KEY=sk-proj-your-openai-key
ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5
ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5-mini
EOF

Ollama 本地配置：

bash
cat > ~/.claude/proxy.env << 'EOF'
OPENAI_BASE_URL=http://localhost:11434/v1
ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-r1:70b
ANTHROPIC_DEFAULT_HAIKU_MODEL=llama3.1:8b
EOF

使用指南

使用 ccp 包装器（推荐）

bash
# 使用 ccp 替代 claude 命令
ccp chat
ccp code /path/to/project
ccp --version

ccp 包装器会自动启动代理守护进程、设置 ANTHROPIC_BASE_URL 环境变量，然后调用 claude 命令。

直接使用

bash
# 启动代理
./claude-code-proxy

# 配置 Claude Code 使用代理
export ANTHROPIC_BASE_URL=http://localhost:8082
claude chat

命令参考

bash
./claude-code-proxy          # 启动守护进程
./claude-code-proxy status   # 检查运行状态
./claude-code-proxy stop     # 停止守护进程
./claude-code-proxy version  # 显示版本
./claude-code-proxy -d       # 调试模式（完整日志）
./claude-code-proxy -s       # 简单日志模式

提供商对比

特性OpenRouterOpenAI DirectOllama
成本按量付费按量付费免费
设置简单简单需本地安装
模型数量200+OpenAI 专属开源模型
推理能力✅✅（GPT-5）✅（DeepSeek-R1）
工具调用✅✅依赖模型
隐私云端云端100% 本地
速度快快极快（本地）

项目链接

Claude Code
上一篇

Open Browser Use - Codex Browser Use 的开源替代方案

下一篇

Claude Code Proxy - 接入 OpenRouter/Ollama 的轻量 HTTP 代理

分享: