2.1 前置条件#

• Node.js 18 或更高版本
• 一个 Anthropic API Key（在 console.anthropic.com 获取）

2.2 全局安装#

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

安装完成后验证：

1
claude --version

2.3 配置 API Key#

将 API Key 设置为环境变量：

1
# macOS / Linux — 添加到 ~/.bashrc 或 ~/.zshrc
2
export ANTHROPIC_API_KEY="sk-ant-xxx"
3

4
# Windows PowerShell
5
$env:ANTHROPIC_API_KEY="sk-ant-xxx"

或者使用 Claude Code 自带的登录方式：

1
claude login

这会打开浏览器引导你完成 OAuth 认证，无需手动处理 API Key。

2.4 更新#

1
npm update -g @anthropic-ai/claude-code

3.1 启动#

在项目目录下运行：

1
claude

你会看到一个交互式终端界面，可以直接用自然语言与 Claude 交流。

3.2 常用指令#

1
# 初始化项目配置文件（生成 CLAUDE.md）
2
claude init
3

4
# 查看当前配置
5
claude config
6

7
# 更新到最新版本
8
claude update

3.3 典型工作流#

代码审查

1
> 审查当前分支的改动，重点关注安全问题

Claude 会读取 git diff，分析代码变更，指出潜在的安全隐患。

Bug 修复

1
> 用户反馈登录后页面白屏，帮我排查原因

Claude 会搜索相关文件、检查组件逻辑，定位问题并直接修复。

功能开发

1
> 在 API 中添加一个获取用户收藏列表的接口，包含分页

Claude 会分析现有路由结构，生成路由定义、控制器逻辑和数据库查询。

4.1 CLAUDE.md 文件#

在项目根目录创建 CLAUDE.md，告诉 Claude 关于项目的关键信息：

1
# 项目名称
2

3
## 技术栈
4
- 前端：React 18 + TypeScript + Tailwind
5
- 后端：Go + PostgreSQL
6
- 部署：Docker + K8s
7

8
## 代码规范
9
- 使用 Prettier 格式化，单引号，无分号
10
- 组件命名使用 PascalCase
11
- API 路由使用 kebab-case
12

13
## 注意事项
14
- 不要直接修改生成的代码文件
15
- 测试使用 Vitest，不要用 Jest

有了这份文件，Claude 每次启动时都会自动加载，减少反复解释。

4.2 权限控制#

Claude Code 默认对敏感操作（如网络请求、文件写入）会请求确认。你可以通过 /permissions 管理权限级别。

4.3 管道模式#

Claude 也支持管道输入，适合脚本场景：

1
cat error.log | claude "分析这些日志，找出关键错误"

4.4 会话管理#

1
# 恢复上一次会话
2
claude --continue
3

4
# 以特定会话 ID 继续
5
claude --resume <session-id>

6.1 国内网络问题#

如果在国内访问 Anthropic API 遇到网络问题，可以：

• 使用 API 代理地址，设置环境变量 ANTHROPIC_BASE_URL
• 配置 HTTPS 代理：export HTTPS_PROXY=http://127.0.0.1:7890

6.2 成本控制#

Claude Code 每次对话都会消耗 API token。控制成本的建议：

• 在 .claude/settings.json 中设置最大 token 限制
• 使用短会话，任务完成后及时 exit
• 对于简单问题，直接在代码中加注释而不是启动完整会话

6.3 国内镜像加速#

1
# npm 安装时使用国内镜像
2
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com