macOS × Claude Code - 完整安装与配置教程
一、目录导航
二、前置准备
1. 系统要求
- macOS 12.0+ (Monterey 或更高版本)
2. 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3. 获取 API Key
- 访问 Anthropic Console
- 登录账号
- 进入 API Keys 页面
- 点击"Create Key"
- 复制并保存（只显示一次）
三、安装 Claude Code
1. 通过 npm 安装
npm install -g @anthropic-ai/claude-code
2. 配置 API Key
export ANTHROPIC_API_KEY="your-api-key-here"
3. 验证安装
claude --version
四、配置文件
1. 配置位置
~/.claude/settings.json
2. 常用配置项
{
"theme": "dark",
"fontSize": 14,
"autoSave": true,
"historyLimit": 100,
"model": "claude-sonnet-4-20250514"
}
3. 注意事项
- API Key 不要提交到版本控制
- 定期更换 API Key
- 不要在公共场合暴露 Token
五、使用技巧
1. 常用命令
# 启动交互模式
claude
# 执行单个命令
claude "写一个 Hello World"
# 指定文件
claude -f README.md "总结一下这个文件"
# 使用不同模型
claude --model claude-opus-4-20250514 "复杂任务"
2. 高效技巧
- 使用别名：在
~/.zshrc中添加alias c='claude' - 批量处理：使用
claude -f *.md "总结所有 markdown 文件" - 管道输入：
cat file.txt | claude "分析内容" - 保存对话：使用
claude --save保存会话
3. 故障排除
| 问题 | 解决方法 |
|---|---|
| API Key 无效 | 检查 ANTHROPIC_API_KEY 环境变量 |
| 命令未找到 | 检查 npm 全局安装路径 |
| 权限错误 | 使用 sudo npm install -g |
| 网络超时 | 检查代理设置 |
六、CC Switch 多账号管理
1. CC Switch 是什么？
CC Switch 是一个 Claude Code 的多账号管理工具，可以快速切换不同的 API Key，适合有多个账号的用户。
2. 下载安装
下载地址： github.com/farion1231/…
3. 隐私与安全授权
下载后首次运行时，macOS 会提示"无法打开"或"开发者无法验证"，请按以下步骤授权：
- 打开系统设置 → 隐私与安全性
- 滚动到"安全性"部分
- 点击"仍要打开"
- 输入管理员密码确认
七、 相关文档
文档版本： 1.0（Markdown 版） 适用于： macOS 12.0+ 最后更新： 2026 年 3 月 12 日
