Cluade Code使用指南

Cluade Code使用指南主要分为3个部分,安装、使用、进阶,这三个部分

安装与配置

Cluade Code现在最新的安装方式主要是通过下载安装包进行,可以参考官网的快速指南,另外一种方式就是通过npm进行管理安装

安装Cluade与安装Cluade Code

安装Cluade

# 安装最新版本
npm install -g @anthropic-ai/claude-code

# 安装指定版本
npm install -g @anthropic-ai/claude-code@2.0.64 

# 检查版本
claude -version

可选:安装Cluade-code-router(ccr)

# 安装最新版本
npm install -g @musistudio/claude-code-router

# 检查版本
ccr version

配置Cluade Code

在配置底层模型时,首先要跳过Anthropic的登录限制,在.claude.json配置中增加hasCompletedOnboarding参数即可

~/.claude.json

{
    "hasCompletedOnboarding": true
}

Cluade Code直接使用Anthropic自家的Opus/Sonnet模型是最好的,但是对我来是还是太贵了,因此使用的是Cluade Code + 国内开源大模型的方式;
有两种配置方案,一种是大模型支持Anthropic协议的调用,一种是使用cluade-code-router将anthropic请求转换成支持openai协议的请求,再来请求大模型;

第一种直接使用Anthropic协议

.claude/settings.json


{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "#you_token#",
    "ANTHROPIC_BASE_URL": "#服务商URL#",
    "ANTHROPIC_MODEL": "ZhipuAI/GLM-5",
    "ANTHROPIC_SMALL_FAST_MODEL":"ZhipuAI/GLM-5",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

其中’ANTHROPIC_AUTH_TOKEN’,'ANTHROPIC_BASE_URL’是必填的,使用ANTHROPIC协议可以在Claude Code中看到使用的模型为Custom model模型;

使用ANTHROPIC协议.png

第二种使用Cluade-Code-Router,简称(ccr)来进行桥接

首先.claude/settings.json文件不能有内容,为空即可

~/.claude-code-router/config.json

{
  "Providers": [
    {
      "name": "modelscope",
      "api_base_url": "#服务商URL#",
      "api_key": "#you_token#",
      "models": [
        "ZhipuAI/GLM-5",
        "moonshotai/Kimi-K2.5",
        "Qwen/Qwen3-Coder-480B-A35B-Instruct"
      ],
      "transformer": {
        "use": [
          "cleancache"
        ]
      }
    }
  ],
  "Router": {
    "default": "modelscope,ZhipuAI/GLM-5",
    "background": "modelscope,Qwen/Qwen3-Coder-480B-A35B-Instruct",
    "think": "modelscope,ZhipuAI/GLM-5",
    "longContext": "modelscope,ZhipuAI/GLM-5"
  }
}

配置一和配置二的URL不一样,拿modelscope来举例,在配置一中为:‘https://api-inference.modelscope.cn’,在配置二中为:‘https://api-inference.modelscope.cn/v1/chat/completions’
区别在于后缀是否有’/v1/chat/completions’,这个也可以看做是openai协议要求;
使用第二种之后看到的模型就是Sonnet,但是实际上调用的是ccr路由的模型

使用openai协议.png

使用

使用部分主要分为ccr使用与claude code使用两个部分,

ccr使用

基础命令

序号	命令	描述
1	ccr code	启动cluade code
2	ccr start	启动,使用ccr code时,包含该命令
3	ccr restart	重启启动,调整配置后一定需要重启
4	ccr model	切换模型

详细高级用法可以参考ccr项目,自定义路由规则、设置预设等

claude code基础用法

claude code模式分为:

‘默认’
修改文件前会先获取授权
‘规划’
只讨论方案,不修改文件
‘自动’
自动修改文件或操作

通过shift + tab的方式来进行修改

三种模式

快捷键

序号	快捷键	描述
1	shift + tab	自动切换模式
2	shift + enter	输入换行
3	ctrl + b	将当前任务置于后台
4	ctrl + d	退出claude code
5	esc + esc	回滚,主要选择回滚会话还是文件,只能回滚cc创建的文件,通过cc调用工具创建的文件无法回滚
6	shift + enter	输入换行
7	ctrl + r	搜索历史
8	ctrl + C	终止操作
9	ctrl + S	暂存提示词
10	ctrl + R	恢复最近的提示词

基础命令

序号	命令	描述
1	/init	初始化项目的claude.md文件
2	/tasks	查看后台执行任务
3	/compact	压缩上下文
4	/clear	清除上下文,类似开启一个新的会话
5	/memory	修改claude.md文件
6	/cost	查看费用,私有模型不适用
7	/status	查看系统状态