Mac上的AI编程环境完整配置指南

一、基础环境准备

这一部分确保 Node.js、Claude Code 以及命令行工具均能正常运行，也是后续配置的前提。

1. 安装 Node.js

Claude Code 及大部分 MCP 工具依赖 Node.js。推荐借助 Homebrew 安装并保持 LTS 版本：

bash

# 安装 Homebrew（若尚未安装）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js（LTS）

brew install node

# 验证安装

node -v   # 期待 v18.x 及以上

npm -v    # 期待 9.x 及以上

2. 安装 Claude Code

访问 Claude Code 官网了解最新安装方式；以下命令供参考：

bash

# 使用 npm 全局安装（请以官方文档为准）

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

# 验证是否安装成功

claude --version

首次运行 claude 时，终端会引导完成初始化配置。

安装说明

Claude Code 的安装方式会随版本迭代变化，务必以官方文档为准，避免使用过期脚本。

环境检查

确认 Node.js 是否安装成功
检查 npm 全局包目录是否写入 PATH
若终端无法识别 claude，尝试重新打开终端或重启 Shell

3. 常见故障排查

点击展开故障排查指南

权限问题：若出现 EACCES，可使用 brew 前缀或通过 nvm 管理 Node 版本
网络受限：安装命令可搭配代理或国内源，例如 npm config set registry https://registry.npmmirror.com
版本冲突：确认历史版本的 claude、node 均已卸载，以免路径混乱

二、API 中转服务配置（PackyAPI）

PackyAPI 提供稳定的模型访问与计费体系，是 Claude Code 在国内最常用的中转服务之一。

1. 注册账号

点击“使用 Google 继续”
在弹窗中选择账号并授权
授权后自动完成注册并登录

2. 充值说明

登录控制台后进入“钱包管理”页面即可充值。PackyAPI 的比例为 1 元人民币 = 1 美元额度，非常易于估算成本。建议首次充值 10~20 元完成联调。

注意账号安全

妥善保管登录凭证并尽量开启二次验证，避免账号被盗用。

3. 创建 API 令牌

3.1 进入令牌管理

登录 PackyAPI 控制台
左侧菜单选择“令牌管理”
点击“添加令牌”

3.2 填写令牌信息

令牌名称：便于识别的命名，如“Claude-Code-开发环境”
令牌分组：⚠️ 必须选择与服务匹配的分组
过期时间：可选，生产环境建议设置
额度设置：限制最大调用额度，防止超支
访问限制：可限定可用模型列表

3.3 保存令牌

提交后系统只展示一次完整 Token，请立即复制并保存，可通过环境变量或密码管理器统一管理。

重要提示

若令牌泄露需立刻删除并重新生成，切勿将 Token 写入代码仓库。

三、配置管理工具（CC Switch）

CC Switch 通过图形化界面集中管理 Claude Code 的多个供应商与配置，大幅降低频繁切换带来的成本。

CC Switch

下载 CC Switch Release 版本

1. 解决的痛点

手动编辑 ~/.claude/config.toml 容易出错且难以回滚
不同项目需要不同的 API Key、模型和环境变量
需要在 PackyAPI、官方 API、本地模型之间快速切换
需要可视化备份与分享配置

2. 安装与启动

2.1 下载安装包

下载 CC-Switch-v3.7.0-macOS-Intel.dmg

2.2 安装步骤

下载 .dmg 文件后打开
将 CC Switch 拖入 Applications
若提示“无法验证开发者”，到“系统设置 → 隐私与安全性”中允许运行

3. 添加 PackyAPI 配置

启动 CC Switch，点击“添加供应商”
工具类型 选择 Claude Code
配置名称 例如 PackyAPI - Claude Sonnet 4.5
供应商类型 使用 OpenAI Compatible
填写 API 参数：
- Base URL：https://www.packyapi.com/v1
- API Key：粘贴刚刚生成的令牌
- 模型名称：claude-sonnet-4.5

4. 多配置切换与备份

4.1 快速启用配置

在配置列表中选择目标配置
点击“启用”
根据提示必要时重启 Claude Code

切换说明

启用后 CC Switch 会自动改写 ~/.claude/config.toml 并更新环境变量，因此无需再手动编辑配置文件。

4.2 导出与版本管理

在“设置”中点击“导出配置”即可获得 JSON
建议将导出的文件保存至安全位置或纳入私有 Git 仓库

4.3 批量管理 API Key

Key-1（主力）：日常开发
Key-2（备用）：主力额度耗尽时立即切换
Key-3（测试）：验证新模型或实验功能

四、MCP 工具生态配置

1. MCP 概述

MCP（Model Context Protocol） 让模型通过标准协议访问外部工具，扩展了信息检索、代码执行与系统集成能力。

流程示意：

text

用户输入 → Claude Code → 判断是否需要工具 → 调用 MCP 服务器 → 返回结果

价值点：

🔍 实时搜索与文档查询
🛠️ 自动化脚本与浏览器操作
🧠 结构化推理与跨会话记忆
🔗 与数据库、API、第三方服务无缝连接

2. 推荐工具清单

以下配置写入 ~/.claude/config.toml：

Context7｜文档查询

功能：检索开源项目文档、API 示例

toml

[mcp_servers.context7]
type = "stdio"
command = "npx"
args = [
  "-y",
  "@upstash/context7-mcp"
]

五、Codex 全自动模式风险提示

codex --dangerously-bypass-approvals-and-sandbox 会跳过审批、沙箱及安全检查，存在极高风险。

新手勿用

仅在完全隔离、可随时重置的实验环境中考虑启用该模式。一旦在主力设备或生产环境运行，极易造成数据泄露或系统被入侵。

bash

codex --dangerously-bypass-approvals-and-sandbox

更安全的做法是保留审批流程，逐步扩展权限，并在每次操作前确认风险。

Mac上的AI编程环境完整配置指南

评论区