0 前言

由于众所周知的原因，Claude官方已经禁止国内使用了，所以Claude Code CLI也就无法直接使用了。
所以我们需要使用中转服务调用Claude API，或者换成咱们国产的LLM API，比如Deepseek V3.1, Qwen-Coder, Kimi K2等等。
有点标题党了，不是“最佳实践”勉强算是“基础入门使用教程”吧。

1 安装node.js环境

claude code cli是一个运行在终端的npm软件，所以我们需要安装node.js。
这里推荐大家使用nvm来管理node环境。

1. Windows用户：nvm-windows
   • 在Github Releases里下载安装即可：nvm-windows
2. Linux用户：nvm-sh
   • 使用curl

     curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
     

   • 使用wget

     wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
     

之后重启一下终端或者手动source ~/.bashrc，运行"nvm --version"看下安装成功了没有。
接下来，安装Node.js，建议安装最新的LTS版本：

nvm install lts

然后切换到该版本：

1. Windows用户：

   nvm use [版本号]
   

2. Linux用户：

   nvm alias default lts/*
   

2 安装Claude Code Cli

很简单，执行npm安装命令即可：

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

注意要加-g选项，表示全局安装，否则npm的机制是安装在当前目录作为项目的模块依赖。

3 配置中转API服务

建议使用开源项目，避免重复造轮子：claude-code-router。
Github页面有详细的使用说明，有中文版的README，需要复杂配置的可以进去研究一下，这里本文只介绍一下基础的配置，也基本满足需要了。

首先安装该模块，也是全局安装：

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

这个模块的主要功能是启动一个本地中转路由，默认占用端口3456，常用命令有三个：

1. ccr restart: 重新启动后台中转服务
2. ccr start: 启动中转服务
3. ccr code: 启动中转服务的同时，打开claude code cli

我们可以先运行一下"ccr code"，就可以以中转方式进入claude code cli，正确配置的话如下图所示：

我们看到正确使用了http://127.0.0.1:3456即可。

然后退出来（按两下ctrl+c），配置一下router，建议在网页前端配，很方便。

ccr ui

这个命令执行完一般会自动打开配置网页，没有自动打开的话，手动打开"http://127.0.0.1:3456/ui/"。

点击添加供应商，要用国外模型建议使用OpenRouter，这个可以用国内支付方式充值，除了 OpenAI的o3, o3-pro，其他的大多数都能用，包括claude sonnet 4和gpt-5。国内的可以试试火山引擎、阿里百炼之类的提供API的平台。有不少平台都有送免费的额度，比如阿里百炼、心流之类的，当然长期使用还是得付费的才行。

以OpenRouter为例，选择模板即可自动配置API地址，然后我们再配置一下API密钥和模型即可，模型建议添加：

1. anthropic/claude-sonnet-4
2. anthropic/claude-3.7-sonnet:thinking
3. anthropic/claude-opus-4.1
4. openai/gpt-5
5. openai/gpt-5-mini
6. deepseek/deepseek-chat-v3.1
7. qwen/qwen3-coder
8. moonshotai/kimi-k2-0905

都是代码能力不错的模型，当然claude-opus-4.1是最贵的，慎重考虑使用。

然后我们添加完供应商后，首页右边再选择“路由”里的模型，一般我们设置一下默认的模型即可：

建议使用claude系列模型，人家的Agent一般来说还是针对官方的LLM调整得效果最好。建议sonnet系列，复杂任务考虑opus，opus还是太贵了。
最后别忘了右上角“保存并重启”。

4 配置VSCode插件

插件市场搜索"Claude Code"，下载"Claude Code for VS Code"。

然后我们随便打开个文件，会发现VSCode右上角有Claude Code的图标。

但是现在还有问题，因为点击它运行的命令是"claude"，我们还得手动配中转，很麻烦。
所以我们考虑在终端层面，设置别名，让claude代表"ccr restart && ccr code"即可。

1. Windows 用户(PowerShell)：配置$PROFILE
   • 执行"notepad $PROFILE"
   • 添加：

     function ccr {
         ccr restart;
         ccr code
     }
     

   • 重启PowerShell
2. Linux 用户(bash)：配置~/.bashrc
   • 执行"nano ~/.bashrc"
   • 添加alias claude=‘ccr restart && ccr code’
   • 执行source ~/.bashrc

其他终端同理。
这时候重启VSCode，再点击右上角的claude图标就可以直接以中转方式运行Claude Code Cli了。

5 Claude Code Cli 基础使用入门

运行在终端，有利有弊，但从入门上手的角度来说，肯定不如Cursor方便。
慢慢熟悉起来就行了，基础的用法：

1. 掌握@, !, #等用法
2. MCP
3. 记忆功能
4. 上下文管理，太长了记得/clear清空，或者是压缩/compact
   具体的可以查查其他教程，本文不再赘述。