Claude Code 上手指南:从 CLI 操作到个性化配置,一文搞定

8 阅读6分钟

完成 Claude Code 的安装后,很多人第一反应是打开项目直接开写。但磨刀不误砍柴工——花 10 分钟熟悉基本操作、完成几项核心配置,能让后续的每一次使用都更顺畅。本文就带你系统过一遍这些内容。


一、界面和操作

1. CLI 界面与启动方式

Claude Code 是一个 CLI(命令行界面,Command Line Interface) 工具,通过终端命令启动,没有图形界面。

claude

首次运行会出现两个引导步骤:安全提示确认,以及终端展示样式选择(根据你的终端主题选择合适的配色方案即可)。

最佳实践:日常开发时,请在项目根目录下执行 claude 命令启动。Claude Code 会自动感知当前目录的项目上下文,读取 CLAUDE.md.git 等信息,提供更准确的辅助。


2. 命令与交互方式

Claude Code 支持三种输入方式,覆盖不同场景:

斜杠命令(/命令:执行内置功能,无需自然语言描述。

常用命令说明
/help查看所有可用命令
/config打开配置界面
/permissions管理工具权限
/clear清空当前会话上下文
/compact压缩会话历史,节省上下文空间
/init扫描项目并生成 CLAUDE.md
/exit退出 Claude Code

自然语言输入:直接描述需求,Claude Code 会理解并执行,这是最主要的交互方式。

执行 Bash 命令:在输入框中以 ! 开头,可直接执行 Shell 命令,无需退出 Claude Code 切换到终端。

# 在 Claude Code 内直接执行 bash 命令
!ls -la
!git status
!npm run build

这在需要快速查看文件结构、确认 Git 状态或触发构建时非常实用,省去了频繁切换终端窗口的麻烦。


3. 权限模式

Claude Code 对文件读写、命令执行等操作有严格的权限控制,默认采用"操作前询问"策略。当前支持以下几种权限模式:

模式进入方式行为说明
Normal(默认)默认启动每次危险操作前弹出确认提示
Auto-accept EditsShift + Tab 切换自动接受所有文件编辑,无需手动确认
PlanShift + Tab 切换只分析规划,不执行任何写操作
bypassPermissions启动时加参数指定跳过所有权限提示,适合自动化场景

切换方式:

  • Shift + Tab:在 Normal / Auto-accept Edits / Plan 三种模式间循环切换
  • bypassPermissions 模式:只能在启动时通过参数指定,无法在运行中切换
# 启动时跳过所有权限提示(谨慎使用)
claude --dangerously-skip-permissions

⚠️ bypassPermissions 适合在受控环境或自动化流程中使用,日常开发建议保持默认的 Normal 模式,或根据任务切换到 Auto-accept Edits 模式提升效率。


4. 支持的模型与切换

Claude Code 支持多个 Claude 模型,不同模型在能力和成本上各有侧重:

模型适用场景
Claude Opus 4复杂架构设计、大型代码库分析、高难度调试
Claude Sonnet 4.6日常编码主力,性能与成本最佳平衡点(推荐
Claude Haiku快速简单任务,响应速度最快,消耗最少

切换方式:

  • Ctrl + P:在运行中快速呼出模型选择器,即时切换
  • /config:通过配置界面切换并持久化保存
  • 启动时指定:通过命令行参数直接指定模型
# 启动时指定模型
claude --model claude-sonnet-4-6
claude --model claude-opus-4-6

5. 退出、暂停与恢复

退出 Claude Code:

/exit
# 或直接关闭终端窗口

暂停进程(转到后台): 使用 Ctrl + Z 将 Claude Code 挂起到后台,终端恢复可用,进程仍在运行。需要继续时,用 fg 命令将其唤回前台:

Ctrl + Z   # 暂停,进程转入后台
fg         # 恢复,重新拉回前台

会话恢复: Claude Code 会自动保存会话历史。重新启动时,通过以下命令接续上一次对话:

claude -c

6. 清空 / 压缩上下文

随着对话变长,上下文窗口会逐渐被占满,影响 Claude 的理解准确度。切换任务时,建议主动处理上下文:

# 完全清空会话历史(适合切换全新任务)
/clear

# 压缩会话历史(保留关键信息,释放上下文空间,适合继续当前任务)
/compact

二、核心配置

1. 交互语言:设置为简体中文

Claude Code 默认以英文响应。如果你习惯中文沟通,每次都用中文提问但收到英文回答,会产生不必要的摩擦感,也影响阅读效率。将交互语言固定为简体中文,能让整个使用体验更流畅自然。

配置方式有两种:

方式一:直接告诉 Claude Code(推荐新手)

启动后,直接输入:

请将你的回复语言设置为简体中文,并在 settings.json 中保存这个配置,以便后续会话持续生效。

方式二:通过 /config 命令配置

/config

进入配置界面后,找到语言(Language)相关选项,设置为 zh-CN(简体中文)。


2. 通知:任务完成时提醒你

Claude Code 处理复杂任务时往往需要较长时间。如果你在等待期间切换到其他应用,很可能错过 Claude 等待确认或任务已完成的时机,造成不必要的上下文中断。配置通知后,你可以安心处理其他事务,Claude 完成时会主动提醒你。

配置示例(直接告诉 Claude Code):

请帮我配置通知功能:
1. 当 Claude Code 等待用户输入时,发送系统通知
2. 当任务完成时,发送系统通知
并将配置保存到 settings.json。

Claude Code 会自动处理系统通知的相关配置(macOS 使用系统通知中心,Linux 使用 notify-send)。


3. 状态栏:让关键信息一目了然

状态栏是 Claude Code 界面底部的信息区域,可以实时展示当前会话的关键数据。默认状态栏信息较少,合理配置后,你能随时掌握:当前使用的模型(避免忘记切换)、上下文占用百分比(提前预判是否需要 /compact)、本次会话的花费(控制成本)、当前工作目录和 Git 分支(快速定位工作状态)。

配置示例(直接告诉 Claude Code):

请帮我配置状态栏,展示以下信息:
- 当前模型名称
- 上下文占用百分比
- 本次会话花费(cost)
- 当前工作目录
- 当前 Git 分支
并保存配置到 settings.json。

配置完成后,状态栏效果大致如下:

[claude-sonnet-4-6] | ctx: 34% | $0.12 | ~/projects/my-app | feat/login

三、总结

工欲善其事,必先利其器。

Claude Code 是一款功能强大的 AI 编程助手,但真正用顺手需要一点前期投入。花 10 分钟完成本文介绍的界面熟悉和三项核心配置,你会得到:一个说中文的编程伙伴、一个不会打断你就能在后台工作并通知你的助手、一个状态透明让你随时掌握成本与进度的工作环境。

这些配置不是可有可无的"美化",而是让 Claude Code 真正融入你开发工作流的基础设施。