ClaudeCode编程工具使用
1

本教程不是使用Claude Code 编程工具直接对接Claude Code的AI接口进行 AI 编程，而是通过本地代理服务 Claude Code Router 来实现AI编程。其中编程能力的强弱主要取决于你接入的AI大模型。

1、Claude Code是什么？

Claude Code 是一个代理编码工具，可以读取你的代码库、编辑文件、运行命令，并与你的开发工具集成。可在终端、IDE、桌面应用和浏览器中使用。

Claude Code 是一个由 AI 驱动的编码助手，可帮助你构建功能、修复错误和自动化开发任务。它理解你的整个代码库，可以跨多个文件和工具工作以完成任务。

2、Claude Code可以做什么？

Claude Code是具有一定计算机操作权限的AI工具，可以直接读取或修改你本地的文件。借助这些系统权限可以轻松实现以下功能

  1. 根据你的需求实现你的逻辑和修改你代码中的BUG

  2. 编写测试用例、完善注释和文档、修复依赖错误和解决合并冲突等

  3. 创建Git的提交和拉取请求

  4. 使用cli工具进行自动化构建等

  5. ......

3、为什么需要使用本地代理服务来替换 Anthropic 的官方服务器通信

ClaudeCode 是由 Anthropic 公司开发的AI编程工具。而 Anthropic 公司是位于美国加州旧金山的一个人工智能相关的公司。这就导致了两个我们不能直接使用 ClaudeCode 最致命的问题。

  • 网络环境不通，我们无法直接访问 ClaudeCode 的后台服务通信

  • 费用高昂而且支付麻烦，直接使用 ClaudeCode 费用对于个人来说非常夸张，而且对于国内用户来说支付也非常不方便

首先以上两个问题已经让使用 ClaudeCode 非常麻烦了，而当你解决了以上的困难后还有一个更麻烦的问题就是账号策略不明，你随时可能失去你账号的访问权限。

综合以上原因，直接使用 ClaudeCode 对于大部分人来说并不是一个很好的选择。所以这里就说一下 ClaudeCode 的平替方案，使用 Claude Code Router 服务来代理 Anthropic 的后台。具体的工作原理如下：

  • 在我们本地的终端上运行 ClaudeCode

  • 使用 Claude Code Router 拦截 ClaudeCode 与后台的通信，让 Claude Code 以为它还在和 Anthropic 的后台进行通信

  • 然后 Claude Code Router 将请求转换格式，发送给你配置好的、兼容 OpenAI API 格式的模型服务（例如 DeepSeek, 硅基流动, Ollama 等）。

  • 收到模型返回的结果后，再转换成 claude-code 能理解的格式传回去。

4、在本地安装并使用Claude Code Router

安装 Claude Code和Claude Code Router 需要 Node 环境，如果没有 Node 环境需要自行准备 Node 环境

4.1 安装Claude Code程序

直接在终端中全局安装 Claude Code

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

4.2 安装Claude Code Router程序

在终端中全局安装 Claude Code Router 和它需要的依赖程序 tiktoken (优先安装)

npm install -g tiktoken
npm install -g @musistudio/claude-code-router

4.3 启用Claude Code Router

注意，这里启动的是Claude Code Router而不是直接启动 Claude Code

进入需要进行编程的目录在进行启动，启动后会在目录下生成一些Claude Code和Claude Code Router相关的文件

cd D:\workspace\project 
ccr code

启动后就可以开始使用AI编程工具了，此时可能输入指令后会提示一些model相关报错。这个可能是代理的模型未配置好，可以打开用户目录下~/.claude-code-router/config.json进行配置。

在这里贴一下我的配置，配置的是deepseek和gemini相关的模型，后续需要用什么模型可以去对应官网开通，也可以去二手交易平台上面找中转的代理商。

{
    "OPENAI_API_KEY": "sk-",
    "OPENAI_BASE_URL": "https://api.deepseek.com",
    "OPENAI_MODEL": "deepseek-chat",
    "log": true,
    "Providers": [
        {
            "name": "deepseek",
            "api_base_url": "https://api.deepseek.com/v1/chat/completions",
            "api_key": "sk-xxxxxxxx",
            "models": [
                "deepseek-reasoner",
                "deepseek-chat"
            ],
            "transformer": {
                "use": [
                    "deepseek"
                ],
                "deepseek-chat": {
                    "use": [
                        "tooluse"
                    ],
                    "max_tokens": 4096
                },
                "deepseek-reasoner": {
                    "max_tokens": 4096
                }
            }
        },
        {
            "name": "gemini",
            "api_base_url": "https://xxx.dpdns.org/v1",
            "api_key": "xxx",
            "models": [
                "gemini-2.5-pro-preview-06-05",
                "gemini-2.5-flash-preview-05-20"
            ],
            "transformer": {
                "use": [
                    "gemini"
                ]
            }
        }
    ],
    "Router": {
        "default": "deepseek,deepseek-chat",
        "background": "deepseek,deepseek-chat",
        "think": "deepseek,deepseek-reasoner",
        "longContext": "gemini,gemini-2.5-pro-preview-06-05"
    }
}

更改完配置后需要重启，可以先执行ccr stop 停止服务，然后在执行ccr start 启动服务

ClaudeCode编程工具使用
https://twocats.cloud/categories/default/claudecodebian-cheng-gong-ju-shi-yong
作者
Administrator
发布于
更新于
许可