Cluade Code使用指南

claude code
杂记
发布日期:   2026-03-08
字数:   1.3k
阅读时间:   5 分钟

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 查看系统状态
8 /resume 选择对话历史
8 /rewind 选择回滚历史,注意是要回滚代码还是会话

Cluade Code进阶技巧

常用命令

  • /btw

分支对话,并不会影响当前上下文

  • /insights

分析claude code最近一个月的使用,给出改进建议

  • /simplify

审查你最近更改的文件以查找代码重用、质量和效率问题，然后修复它们。在实现功能或错误修复后运行它来清理你的工作。它并行生成三个审查代理（代码重用、代码质量、效率），汇总他们的发现，并应用修复。可以设置传入参数以专注于特定问题,例如/simplify focus on memory efficiency。

  • /loop

定时任务,最长7天

使用原则

  1. 禁止使用dangerously模式
    工具是用来使用的,不要把责任下放给工具

  2. 回滚文件使用git来操作,cc只回滚会话

  3. 并行处理是效率倍增的关键

  4. 使用#命令随时写入记忆
    在对话中输入 # 加内容，可以直接写入 CLAUDE.md文件

使用claude code示例

项目背景:创建一个windows下的截图工具

设置StatusLine

  • /.claude/settings.json
{
  "statusLine": {
    "type": "command",
    "command": "bash /#user#/.claude/statusline-command.sh",
    "refreshInterval": 1
  }
}
  • statusline-command.sh状态脚本

statusline-command.sh

statusline

高级功能

hook

skill

SubAgent

agent teams

  • 调整配置
## settings.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

参考资料

Claude Code 完全指南：使用方式、技巧与最佳实践
claude-code-router项目
发起claude-code-router项目原因

claude code
  TOC