Claude Code从入门到精通：国内开发者的完整使用手册

Claude Code是2026年最值得深度掌握的AI编程工具之一。它不像Codex那样追求「快」，而是追求「对」。在面对大型代码库、复杂架构、多文件关联的Bug时，Claude Code的分析深度是其他工具目前无法替代的。但很多人装完只会用 claude 命令开始聊天——这其实只用了它10%的能力。这篇文章从安装到精通，讲透Claude Code的完整用法。

一、Claude Code的核心设计哲学

理解Claude Code，先理解它和Codex的根本区别：

一句话总结：Codex是你的「执行助理」，Claude Code是你的「技术顾问」。真正的效率来自两者配合使用。

二、安装与基础配置

2.1 环境准备

# 确认 Node.js >= 18
node --version

# 如果没有，先去 nodejs.org 下载 LTS 版本

2.2 安装 Claude Code

npm install -g @anthropic-ai/claude-code

# 验证
claude --version

2.3 配置API接入

Claude Code需要一个兼容Anthropic协议的API接入地址。通过API聚合服务平台获取接入凭证后：

# 添加到 ~/.zshrc 或 ~/.bashrc
export ANTHROPIC_BASE_URL="你的API接入地址"
export ANTHROPIC_API_KEY="***"

# 使配置生效
source ~/.zshrc

在 api.bblabu.cn 注册后在控制台创建令牌即可获得API接入凭证。同一平台也支持GPT-5.5，这意味着Claude Code可以通过配置调用GPT-5.5模型。

2.4 首次启动测试

claude

# 在对话中输入
> 你好，请分析当前目录的项目结构

如果正常返回分析结果，说明配置成功。

三、核心命令与工作模式

3.1 基本交互

# 启动对话
claude

# 带初始指令启动
claude -p "分析 src/ 目录的代码质量"

# 指定工作目录
claude --cwd ~/projects/my-app

3.2 文件操作

Claude Code能直接读写文件。在对话中你可以：

> 读取 src/utils/auth.ts 文件，分析其中的安全问题
> 修改 src/api/users.ts 的第45-89行，增加输入校验
> 在 src/middleware/ 目录下新建一个 rate-limit.ts 文件

Claude Code会自动执行这些文件操作，你不需要手动切换窗口。

3.3 项目级上下文

Claude Code最强的能力是理解整个项目。你不需要逐文件喂给它——它会自动探索项目结构：

> 分析这个项目的整体架构，列出所有模块及其依赖关系
> 这个项目的数据库访问层有什么问题？请给出优化建议
> 如果要把这个项目从 Express 迁移到 Fastify，涉及哪些改动？

它会自动读取 package.json、遍历目录结构、分析import依赖链，基于完整项目上下文给出答案。

四、实战：用Claude Code做代码审查

场景：审查一个PR的所有改动

# 切到PR分支
git checkout feature/user-auth

# 获取改动
git diff main..feature/user-auth > /tmp/diff.txt

# 用Claude Code审查
claude -p "审查 /tmp/diff.txt 中的所有改动：
1. 安全漏洞（SQL注入、XSS、权限绕过、敏感信息泄露）
2. 性能问题（N+1查询、无索引查询、不必要的循环）
3. 代码规范（命名、注释、错误处理）
4. 给出具体的修改建议和优先级"

Claude Code会逐文件分析diff，给出结构化的审查报告。而且因为Claude 4.7对安全问题特别敏感，它的安全审查建议通常比人工审查更全面。

五、实战：用Claude Code做架构重构

场景：把一个单体Express应用拆分为微服务

> 分析当前项目，判断是否适合微服务化拆分

> 如果可以拆分，建议按照什么边界拆？（给出拆分方案）

> 按照你的方案，先拆分出用户服务（user-service），包括：
  - 数据库表设计
  - API接口定义
  - 与其他服务的通信方式
  - 需要改动的现有代码

Claude Code会：

1. 先遍历整个项目结构，理解所有模块的依赖关系
2. 基于依赖关系给出拆分建议（按业务边界还是按技术层）
3. 生成拆分后的微服务代码骨架（目录结构、核心代码、配置文件）
4. 指出现有代码中哪些地方需要修改才能适配新架构

整个流程下来，你干的是「决策和审查」，Claude Code干的是「分析和生成」。

六、模型切换技巧

Claude Code默认使用Claude模型，但通过API聚合平台，你可以让Claude Code调用GPT-5.5：

# 方法1：切换Base URL指向支持多模型的聚合平台
export ANTHROPIC_BASE_URL="你的API接入地址"
# 在平台中配置默认模型为 gpt-5.5

# 方法2：使用CC-Switch在本地切换模型
# CC-Switch中选择供应商 → 切到GPT-5.5
# Claude Code自动使用新模型

有什么用？日常小修小改用GPT-5.5（速度更快、Token消耗更低），做架构分析和安全审查时切回Claude 4.7。同一个Claude Code工具，按场景选模型。

七、性能优化

7.1 控制Token消耗

Claude Code的长对话会持续消耗Token。几个节省技巧：

# 完成任务后清空上下文
> /clear

# 不要在一个对话里跨项目
# ❌ 先问项目A，再切到项目B继续聊
# ✅ 每个项目/任务开新对话

# 精确提问比泛问省Token
# ❌ "优化这个项目"
# ✅ "优化 src/services/order.ts 中 createOrder 函数的数据库查询"

7.2 控制上下文大小

# 在配置文件中设置 max_tokens
# ~/.claude/config.json
{
  "max_tokens": 16384,
  "model": "claude-4.7"
}

八、Claude Code + 其他工具的组合工作流

最佳实践不是单独用Claude Code，而是和其他工具配合：

• 日常编码：Codex + GPT-5.5（快、省、高频交互流畅）
• 代码审查：Claude Code + Claude 4.7（安全扫描强、分析深）
• 架构设计：Claude Code + Claude 4.7（全局理解、多方案权衡）
• 编辑器辅助：Cursor + 任一模型（Inline补全和Chat结合）

所有工具共用一套API凭证和预算，从同一个平台获取。你可以随时切换模型和工具组合，零额外成本。

九、总结

Claude Code不是Codex的竞品，是Codex的互补品。它不是让你「更快地写代码」，而是让你「更正确地写代码」。在安全审查、架构重构、复杂Bug排查这三个场景，Claude Code目前还没有对手。

入门只花五分钟——装Node.js、装Claude Code、配两行环境变量、输入claude，就开始。但从入门到精通需要理解它的核心哲学：「先理解、再执行」，以及把它和Codex、Cursor等工具搭配使用的工作流。

不管是哪个工具、哪个模型，API接入不是问题。通过聚合服务平台注册、拿Key、填配置，五分钟搞定。剩下的就是把时间花在「用好工具」上，而不是「折腾配置」上。

本文链接：https://www.kkkliao.cn/?id=3936 转载需授权！