Claude Code 安装与配置指南
本教程仅适用于 macOS 系统。
一、环境准备
1.1 检查 Node.js 环境
在终端中输入以下命令，检查 Node.js 是否已安装：
npm list -g --depth=0
预期结果：
- 显示已安装的全局包列表
- 或者显示空列表（这也是正常的）
如果提示"命令未找到"：
说明你的系统还没有安装 Node.js，请按照以下步骤操作：
- 访问 Node.js 官方文档或相关安装教程
- 根据教程完成 Node.js 的安装
- 安装完成后，重新执行上述检查命令
- 如果不再提示错误，说明安装成功
二、安装 Claude Code
2.1 执行安装命令
在终端中运行以下命令：
npm i -g @anthropic-ai/claude-code@latest
2.2 处理权限问题
如果遇到 "permission denied" 权限错误，请使用管理员权限安装：
sudo npm i -g @anthropic-ai/claude-code@latest
系统会提示你输入开机密码，输入后即可继续安装。
三、验证安装
3.1 测试安装状态
⚠️ 重要提示： 这一步骤必须执行！首次运行
claude命令后，系统会在用户目录下自动生成配置文件夹，这是后续配置的基础。
在终端中输入：
claude
成功标志：
- 出现交互界面
- 或显示选项让你进行选择
3.2 解决首次运行错误
首次安装时，可能会遇到类似下图的错误提示：
解决方法：
执行以下命令完成初始化配置：
jq '. + {"hasCompletedOnboarding": true}' ~/.claude.json > /tmp/tmp.json && mv /tmp/tmp.json ~/.claude.json
四、配置 Claude Code
4.1 打开配置目录
操作步骤：
- 在 Finder（访达）中按下快捷键：
Command + Shift + G - 按下回车键，进入配置目录
在弹出的对话框中输入以下路径：
~/.claude
4.2 创建配置文件
如果目录中不存在 settings.json 文件，请手动创建一个。
📝 说明：
settings.json是 Claude Code 的主要配置文件，用于设置 API 中转地址、密钥以及其他高级选项（如 hooks、plugins 等）。
4.3 编辑配置内容
将以下内容复制并粘贴到 settings.json 文件中：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的令牌",
"ANTHROPIC_BASE_URL": "https://api.anthropic.com",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-3-5-haiku-latest",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-3-5-opus-latest",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-3-5-sonnet-latest",
"ANTHROPIC_MODEL": "claude-3-5-sonnet-latest"
},
"includeCoAuthoredBy": false
}
4.4 获取 API 令牌
操作步骤：
- 访问 Anthropic 控制台或相关 API 提供商页面（需要先注册）
- 创建一个新的令牌
- 复制生成的令牌
- 替换
settings.json文件中的"你的令牌"部分
五、测试配置
5.1 启动 Claude Code
在终端中输入以下命令：
claude
5.2 验证功能
配置成功的标志：
- 出现对话界面
- 能够正常与 Claude 进行对话
- 收到 Claude 的正常回复
六、Claude Code 常用命令
6.1 基础命令
- 启动 Claude Code
claude
启动交互式对话界面，与 Claude 进行实时对话。
- 使用特定模型
claude --model claude-3-5-sonnet-latest "你的问题"
指定使用特定的 Claude 模型进行对话。
- 读取文件内容
claude --file /path/to/file.txt "分析这个文件"
# 或
claude -f /path/to/file.txt "分析这个文件"
将文件内容发送给 Claude 进行分析或处理。
- 处理多个文件
claude -f file1.py -f file2.py "帮我优化这些代码"
同时处理多个文件。
- 开始新会话
claude --new
# 或
claude -n
创建一个全新的对话会话，清除之前的上下文。
- 查看会话历史
claude --history
查看所有保存的对话会话记录。
- 删除会话历史
claude --clear-history
清除所有保存的会话历史记录。
6.2 实用快捷命令
- 代码审查
claude -f main.py "帮我审查这段代码，找出潜在问题"
- 代码重构
claude -f old_code.js "帮我重构这段代码，提高可读性"
- 生成文档
claude -f app.py "为这个文件生成详细的 API 文档"
- 调试协助
claude -f buggy_code.py "这段代码报错了，帮我找出问题"
- 单元测试生成
claude -f function.py "为这个函数生成完整的单元测试"
6.3 交互模式快捷键
当进入 claude 交互模式后，可以使用以下快捷键：
| 快捷键 | 功能 |
|---|---|
Ctrl + C | 中断当前响应 |
Ctrl + D | 退出 Claude Code |
↑ / ↓ | 浏览命令历史 |
Tab | 自动补全（如果支持） |
6.4 命令组合示例
- 分析项目代码
claude -f src/*.py "分析这个项目的代码结构并给出优化建议"
- 生成并执行代码
claude --code-execution "写一个计算斐波那契数列的 Python 脚本并运行"
- 多文件对比
claude -f version1.js -f version2.js "对比这两个版本的差异"
- 日常开发工作流
# 1. 启动新会话
claude --new
# 2. 分析需求
claude "我需要实现一个用户登录功能，请帮我规划代码结构"
# 3. 生成代码
claude "根据刚才的规划，帮我生成 Python Flask 的登录代码"
# 4. 代码审查
claude -f login.py "审查这段代码的安全性"
# 5. 生成测试
claude -f login.py "为这个登录功能生成单元测试"
使用技巧
💡 提示 1：善用上下文
在交互模式中，Claude 会记住对话上下文，可以进行连续的代码迭代和优化。
💡 提示 2：明确指令
给 Claude 明确、具体的指令能获得更好的结果。例如：
- ✅ '用 Python 写一个冒泡排序，要求添加详细注释'
- ❌ '写个排序'
💡 提示 3：分步骤处理复杂任务
对于复杂的编程任务，可以分成多个步骤，逐步完成：
- 先让 Claude 设计架构
- 再逐个模块生成代码
- 最后进行整合和测试
💡 提示 4：利用文件输入
直接使用 -f 参数读取文件，比复制粘贴代码更高效。
