Claude Code系列文章索引

前言

什么是 VibeCoding?

2025 年初,一位OpenAI 创始成员,造了个词:VibeCoding。核心思想是:用自然语言描述意图,让 AI 生成并迭代代码,人类负责审查方向而非编写细节。

这不是「AI 帮你补全代码」,而是编程范式的跃迁——你是架构师,AI 是执行层。

为什么选择Claude Code

命令行 AI Agent 有不少选择,Claude Code 脱颖而出的核心在于:它是目前架构最完整、可编程性最强的开源 CLI Agent。

Windows使用须知

⚠️直接在 cmd.exe 中使用功能受限,推荐在 WSL2 + Ubuntu 环境下使用

🔔Claude Code 目前仅原生支持 WSL(Windows Subsystem for Linux)


快速开始

安装

Windows+WSL

# 首先启用 WSL2(管理员 PowerShell)
wsl --install
wsl --set-default-version 2

# 执行wsl进入linux子系统
wsl

# 在WSL中,安装 Node.js(如果没有Node环境)推荐使用 nvm 安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 20 && nvm use 20

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 运行以下命令验证安装。若有版本号输出,则表示安装成功。
claude --version

MacOS/Linux

# 安装 Node.js(如果没有Node环境)推荐使用 nvm 安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 20 && nvm use 20

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 运行以下命令验证安装。若有版本号输出,则表示安装成功。
claude --version

nvm安装可参考:https://www.cnblogs.com/wangchangzhi/p/15158415.html


启动

使用 Claude 模型

需要科学上网

# 启动claude
claude

# 首次启动,系统会提示你登录,在 Claude Code 界面中输入,然后按照提示完成登录
/login

不使用 Claude 模型

第一步:配置模型参数

编辑 ~/.claude/settings.json ,其中~ 代表用户主目录,按需修改或新增以下配置:

{    
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://coding.xxx.xxx/xxx",
        "ANTHROPIC_MODEL": "glm-5"
    }
}

第二步:绕过Claude账号登录过程

编辑 ~/.claude.json找到 hasCompletedOnboarding 字段,并将该字段的值设置为 true

第三步:验证

进入任意项目根目录下,输入 claude ,显示如下说明配置成功了,

选择 Yes, I trust this folder 代表信任当前目录,可以开始执行任务了。


使用速查

常用 CLI 启动参数

# 查看帮助
claude -h

# 查看版本
claude -v

# 更新claude code
claude update

# 检查claude code运行状态
claude doctor

# 继续最近一次对话
claude -c

# 详细输出模式
claude --verbose

# 跳过权限确认,自动批准所有操作,默认情况下不启用
claude --allow-dangerously-skip-permissions

# 非交互式提问,一次性输出结果后退出
claude -p "问题..."

Claude Code行内前缀

前缀

作用

示例

@

指定读取文件内容到对话中

@src/index.ts 这个文件做了什么?

!

执行shell命令

`!git status`

/

调用内置斜杠命令

/clear

#

添加记忆到 CLAUDE.md(永久上下文)

#这个项目使用 pnpm,不要用 npm

\ + Enter

换行输入

换行不发送,多行内容

Claude Code行内斜杠命令

命令

作用

示例

/init

分析代码库,自动生成 CLAUDE.md 上下文文件

/help

查看帮助

/model

切换模型

/model glm-5

/clear

清空上下文,开始新任务

/compact

总结+压缩历史对话,以节省上下文窗口

/resume

列出、恢复之前的对话

/add-dir

把额外目录加入工作范围

/rewind

代码还原

/context

查看当前上下文使用情况

/config

打开设置面板

/stats

显示Claude Code使用统计数据

/status

查看Claude Code状态,包括版本、型号、帐户、API连接和工具状态

/memory

编辑查看Claude记忆文件

/mcp

管理MCP服务

/skills

列出所有skill

/plugin

管理Claude Code插件

Claude Code行内快捷键

快捷键

作用

备注

Esc

清空当前输入行

双击 Esc

中断 Claude 正在执行的任务,回到对话等待状态
等同于 /remind

Shift + Tab

切换权限模式:普通模式、自动确认模式、计划模式、

自动批准所有操作模式(使用 --allow-dangerously-skip-permissions 启动时)

Ctrl+V

粘贴截图到会话中(需要模型支持:视觉理解

实用插件

cc-switch

Claude Code、Codex、Gemini CLI、OpenCode和OpenClaw的一体化管理器

官方地址:https://github.com/farion1231/cc-switch

cc-switch工作目录:~/.cc-switch/

cc-switch数据存储:本地sql-lite数据库~/.cc-switch/cc-switch.db

Windows环境下安装,cc-switch中的模型配置可以和WSL共用,但是目前在WSL中使用时需要在设置中切换AgentCLI的配置目录,

示例见以下图片:

claude-hud

在Claude Code行内,实时显示Claude Code上下文使用、活动工具、正在运行的代理和待办事项进度

官方地址:https://github.com/jarrodwatts/claude-hud

模型选择