Loading... # cc-nim Claude Code NVIDIA NIM 免费代理工具技术分析 # 一、新闻概述 ## 1. 标题 cc-nim：通过 NVIDIA NIM 免费使用 Claude Code CLI 的开源代理工具 ## 2. 发布时间 2026 年 1 月 29 日 ## 3. 来源 GitHub 开源项目 # 二、核心内容 ## 1. 事件摘要 ### A. 主要内容 cc-nim 是一个开源的轻量级代理服务器，能够将 Claude Code CLI 的 Anthropic API 请求转换为 NVIDIA NIM 格式，从而让用户免费使用 Claude Code 功能。该项目还集成了 Telegram Bot，支持通过手机远程控制 Claude Code 执行任务。 ### B. 核心亮点 - 完全免费使用 Claude Code CLI 功能 - 利用 NVIDIA NIM 提供的每分钟 40 次免费 API 请求 - 支持 Telegram Bot 远程控制 - 可扩展架构，支持添加自定义 Provider 和消息平台 - 基于 Python 开发，使用 uv 包管理器 ## 2. 关键信息 ### A. 版本信息 - 项目名称：cc-nim - 开发语言：Python 100% - 许可证：MIT License - Star 数：60 - Fork 数：8 ### B. 重要数据 - NVIDIA NIM 免费 API 限制：40 请求/分钟 - 默认最大 Token 数：81920 - 最大并发 CLI 会话数：10 ### C. 涉及技术 - Claude Code CLI - NVIDIA NIM API - Telegram Bot API - FastAPI/Uvicorn - OpenAI 客户端库 ## 3. 背景介绍 ### A. 前置背景 Claude Code 是 Anthropic 推出的命令行 AI 编程助手，需要付费使用 Anthropic API。NVIDIA NIM（NVIDIA Inference Microservices）提供免费的 AI 模型推理服务，支持多种开源大语言模型。 ### B. 相关上下文 随着 AI 编程工具的普及，开发者对免费或低成本使用这些工具的需求日益增长。cc-nim 项目通过 API 代理的方式，巧妙地将 Claude Code 的请求转发到 NVIDIA NIM，实现了免费使用的目标。 # 三、详细报道 ## 1. 主要内容 ### A. 功能特性 **API 代理功能**： - 将 Anthropic API 请求格式转换为 NVIDIA NIM 格式 - 支持流式响应（Streaming） - 自动处理速率限制 **Telegram Bot 集成**： - 远程发送任务给 Claude Code - 实时显示思考过程（Thinking tokens） - 显示工具调用执行状态 - 支持 /stop 命令取消运行中的任务 **可扩展架构**： - 支持添加自定义 Provider（API 提供商） - 支持添加自定义消息平台（Discord、Slack 等） ### B. 技术改进 项目采用模块化设计，主要目录结构： | 目录 | 功能 | |------|------| | api/ | API 路由和请求处理 | | cli/ | CLI 会话管理 | | config/ | 配置管理 | | messaging/ | 消息平台抽象层 | | providers/ | API Provider 抽象层 | | tests/ | 测试用例 | ### C. 支持的模型 项目支持多种 NVIDIA NIM 上的开源模型： - moonshotai/kimi-k2.5 - z-ai/glm4.7 - minimaxai/minimax-m2.1 - mistralai/devstral-2-123b-instruct-2512 - moonshotai/kimi-k2-thinking（默认） ## 2. 技术细节 ### A. 架构设计 ```mermaid graph TB subgraph 用户端 A[Claude Code CLI] B[Telegram App] end subgraph cc-nim 代理服务器 C[FastAPI Server] D[API Router] E[Provider Layer] F[Messaging Layer] G[CLI Session Manager] end subgraph 外部服务 H[NVIDIA NIM API] I[Telegram Bot API] end A -->|Anthropic API 请求| C B -->|消息| I I -->|Webhook| F C --> D D --> E E -->|转换后的请求| H H -->|响应| E F --> G G -->|执行任务| D F -->|发送结果| I ```  ### B. 请求转换流程 ```mermaid sequenceDiagram participant CC as Claude Code CLI participant Proxy as cc-nim Proxy participant NIM as NVIDIA NIM API CC->>Proxy: Anthropic API 请求 Note over Proxy: 解析请求格式 Note over Proxy: 转换为 NIM 格式 Proxy->>NIM: OpenAI 兼容请求 NIM-->>Proxy: 流式响应 Note over Proxy: 转换响应格式 Proxy-->>CC: Anthropic SSE 格式 ```  ### C. 配置参数 | 参数 | 说明 | 默认值 | |------|------|--------| | NVIDIA_NIM_API_KEY | NVIDIA API 密钥 | 必填 | | MODEL | 使用的模型 | moonshotai/kimi-k2-thinking | | NVIDIA_NIM_BASE_URL | NIM API 端点 | https://integrate.api.nvidia.com/v1 | | CLAUDE_WORKSPACE | Agent 工作目录 | ./agent_workspace | | ALLOWED_DIR | 允许访问的目录 | "" | | MAX_CLI_SESSIONS | 最大并发会话数 | 10 | | TELEGRAM_BOT_TOKEN | Telegram Bot Token | "" | | ALLOWED_TELEGRAM_USER_ID | 允许的用户 ID | "" | | NVIDIA_NIM_RATE_LIMIT | API 请求限制 | 40 | | NVIDIA_NIM_RATE_WINDOW | 限制窗口（秒） | 60 | | NVIDIA_NIM_TEMPERATURE | 模型温度 | 1.0 | | NVIDIA_NIM_MAX_TOKENS | 最大生成 Token | 81920 | ## 3. 数据与事实 ### A. 项目活跃度 - 首次提交：2026 年 1 月 29 日 - 最新提交：2026 年 2 月 1 日 - 提交频率：高度活跃（3 天内多次更新） ### B. 技术栈 - 运行时：Python 3.x - 包管理：uv - Web 框架：FastAPI + Uvicorn - HTTP 客户端：OpenAI Python SDK - 测试框架：pytest # 四、影响分析 ## 1. 行业影响 ### A. 技术趋势 该项目展示了通过 API 代理实现工具互操作的技术模式。随着各大厂商推出兼容 OpenAI API 格式的服务，这种代理转换方案将越来越普遍。 ### B. 生态影响 - 降低了 AI 编程工具的使用门槛 - 促进了开源 AI 模型的应用 - 为开发者提供了更多选择 ## 2. 用户影响 ### A. 目标用户 - 希望免费使用 Claude Code 功能的开发者 - 需要远程控制 AI 编程助手的用户 - 对 AI 工具集成有需求的团队 ### B. 使用场景 - 本地开发环境中使用 Claude Code - 通过 Telegram 远程执行编程任务 - 在服务器上部署 AI 编程助手 ### C. 注意事项 - 依赖 NVIDIA NIM 的免费额度限制 - 需要自行部署和维护代理服务 - 模型能力可能与原版 Claude 有差异 ## 3. 技术趋势 ### A. API 代理模式 这种通过代理转换 API 格式的方式，为工具互操作提供了新思路。未来可能出现更多类似的适配层项目。 ### B. 远程控制集成 Telegram Bot 集成展示了 AI 工具与即时通讯平台结合的可能性，为移动办公场景提供了便利。 # 五、快速开始 ## 1. 环境准备 ### A. 获取 NVIDIA API Key 访问 https://build.nvidia.com/settings/api-keys 获取免费 API 密钥。 ### B. 安装依赖 - 安装 Claude Code：https://github.com/anthropics/claude-code - 安装 uv 包管理器：https://github.com/astral-sh/uv ## 2. 安装配置 ```bash # 克隆项目 git clone https://github.com/Alishahryar1/cc-nim.git cd cc-nim # 复制配置文件 cp .env.example .env ``` 编辑 .env 文件： ``` NVIDIA_NIM_API_KEY=nvapi-your-key-here MODEL=moonshotai/kimi-k2-thinking ``` ## 3. 启动服务 **终端 1 - 启动代理服务器**： ```bash uv run uvicorn server:app --host 0.0.0.0 --port 8082 ``` **终端 2 - 运行 Claude Code**： ```bash ANTHROPIC_BASE_URL=http://localhost:8082 claude ``` ## 4. Telegram Bot 配置（可选） ### A. 创建 Bot 1. 在 Telegram 中联系 @BotFather 2. 发送 /newbot 并按提示操作 3. 获取 HTTP API Token ### B. 配置环境变量 ``` TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ ALLOWED_TELEGRAM_USER_ID=your_telegram_user_id CLAUDE_WORKSPACE=./agent_workspace ALLOWED_DIR=/path/to/your/projects ``` ### C. 使用方法 - 发送 /start 启动 Bot - 发送任意文本开始任务 - 发送 /stop 取消运行中的任务 # 六、扩展开发 ## 1. 添加自定义 Provider 继承 BaseProvider 类实现自定义 API 提供商： ```python from providers.base import BaseProvider, ProviderConfig class MyProvider(BaseProvider): async def complete(self, request): # 实现 API 调用，返回原始 JSON pass async def stream_response(self, request, input_tokens=0): # 生成 Anthropic SSE 格式事件 pass def convert_response(self, response_json, original_request): # 转换为 Anthropic 响应格式 pass ``` ## 2. 添加自定义消息平台 继承 MessagingPlatform 类实现自定义消息平台： ```python from messaging.base import MessagingPlatform from messaging.models import IncomingMessage class MyPlatform(MessagingPlatform): async def start(self): # 初始化连接 pass async def stop(self): # 清理资源 pass async def queue_send_message(self, chat_id, text, **kwargs): # 发送消息 pass async def queue_edit_message(self, chat_id, message_id, text, **kwargs): # 编辑消息 pass def on_message(self, handler): # 注册消息回调 pass ``` # 七、各方反应 ## 1. 社区反馈 项目在短短几天内获得了 60 个 Star 和 8 个 Fork，显示出开发者社区对免费 AI 编程工具的强烈需求。 ## 2. 技术评价 该项目展示了良好的软件工程实践： - 模块化架构设计 - 完善的配置管理 - 可扩展的 Provider 和 Messaging 抽象 - 包含测试用例 # 八、相关链接 ## 1. 项目地址 - GitHub：https://github.com/Alishahryar1/cc-nim ## 2. 相关资源 - NVIDIA NIM：https://build.nvidia.com/explore/discover - Claude Code：https://github.com/anthropics/claude-code - uv 包管理器：https://github.com/astral-sh/uv *** ## 参考资料 1. [cc-nim GitHub Repository](https://github.com/Alishahryar1/cc-nim) 最后修改：2026 年 02 月 01 日 © 允许规范转载 赞 如果觉得我的文章对你有用，请随意赞赏