Claude Code 安装与使用实录

首次启动还会弹安全提示。通常我会先看当前目录是不是项目目录：如果是，就按默认继续；如果不是，干脆退出重新进，别让 AI 在错的地方乱改文件。

配置文件

Claude Code 支持通过 .claude/config.json 做个性化配置。你可以在项目根目录创建这个文件，内容大概这样：

{
  "model": "claude-3-5-sonnet-20241022",
  "max_tokens": 4000,
  "temperature": 0.7,
  "auto_approve": false,
  "git_integration": true,
  "excluded_files": [
    "node_modules/**",
    ".git/**",
    "*.log",
    "dist/**"
  ],
  "language_preferences": {
    "documentation": "zh-CN",
    "code_comments": "zh-CN"
  }
}

这里能设置模型版本、Token 上限、是否启用 Git 集成，以及要排除的文件。language_preferences 我建议保持中文，生成的注释和文档会更贴近本地团队的习惯，少一点'翻译腔'。

常用斜杠命令

Claude Code 的交互核心还是斜杠命令。输入 / 之后，能直接唤起命令面板，很多动作比聊天式描述更准。

项目管理

绑定工作目录

/add-dir <你的工作目录路径>

这个命令只是把目录挂进工作空间，支持绝对路径和相对路径，不会顺手帮你生成 CLAUDE.md。

执行项目初始化

/init

这个要在 /add-dir 之后用。它会扫描已绑定的目录并生成 CLAUDE.md，里面通常包括项目结构、依赖信息等。对 AI 来说，这一步相当于先把地图递给它，不然它只能靠猜。

查看会话状态

/status

这是只读命令，能看到当前绑定目录、登录账户、模型版本等信息。换环境后先跑一遍，省得后面排查半天才发现压根没连对。

对话管理

清除对话历史

/clear

清空当前会话上下文，适合任务切换的时候用。它不是'优化'，就是把前面的对话忘掉，重新开始。

压缩对话内容

/compact [指令]

当上下文快满时，用它把历史总结压缩掉。比如 /compact "保留尚未解决的问题"，可以尽量把未完成事项留下来。比 /clear 温和一些，适合长任务中途续命。

编辑会话记忆

/memory

它会直接打开并编辑持久记忆文件 CLAUDE.md。如果项目里有一些业务术语、命名习惯或者架构约定没写进去，就在这里补。改完后最好配合 /clear，让新记忆尽快生效。

辅助工具

查看命令列表

/help

列出全部可用斜杠命令，第一次上手时很有用。

令牌与费用统计

/cost

看当前会话的 Token 消耗和费用预估。按量计费的话，这个命令值得时不时看一眼，别等月底才发现上下文堆太多。

查看或修改配置

/config

交互式配置菜单，也可以直接用子命令改参数，比如：

/config set autocompact off

切换 AI 模型版本

/model [model_name]

不带参数会显示当前模型和可选列表；带上参数就能直接切换，比如切到 Sonnet 或 Opus 系列。

环境健康检查

/doctor

它会检查 API 连通性、账户状态、依赖是否安装好。遇到异常时，我一般先跑这个，省得在错误配置上空耗时间。

实战工作流

如果是接手一个新项目，我会按这个顺序来：

1. 进入目录后启动 Claude，先执行 /init，让它把项目结构和依赖先吃进去。
2. 默认模型不够用的时候，再用 /model opus 切到更强一点的版本。
3. 写功能时保持对话不要无限堆，快满了就 /compact；一个模块做完，就 /clear，别把旧上下文带到新任务里。
4. 让 AI 先帮忙看复杂度、冗余和性能瓶颈，再决定要不要改算法或重构代码。

这套流程不花哨，但够稳。项目刚上手时，它能帮你快速摸清脉络；真正写代码的时候，也不会因为上下文混乱把节奏打断。

IDE 集成

除了终端，Claude Code 也能接到 IntelliJ 一类的 IDE 里。用 /ide 触发集成流程后，就能在 IDE 终端中继续用它处理代码。

终端适合做上下文清晰的命令式操作，IDE 则更适合边看代码边改。两边都能用，但我实际更偏向在项目初始化、批量修改和排障时留在终端里，动作更直接。