AI编程CLI两种配置方案（macOS专用）

文章目录方案一CC-Switch自动配置推荐一键切换多模型1. 前置确认2. 接入DeepSeek完整配置步骤3. 切换验证生效4. 托盘快捷切换方案二手动原生配置不使用CC-Switch仅单模型固定一、Claude Code 手动配置macOS二、CodexOpenAI协议工具手动配置三、Gemini CLI 手动配置三、两种配置方式对比四、常见报错排查方案一CC-Switch自动配置推荐一键切换多模型CC-Switch会自动读写各CLI的配置文件不用手动改JSON适配DeepSeek、Claude、Kimi、GLM等所有模型。1. 前置确认已装好 Node.js claude-code/codex/gemini-cli装好CC-Switch拿到DeepSeek API Keyplatform.deepseek.com2. 接入DeepSeek完整配置步骤打开CC-Switch顶部切换标签以Claude Code为例右上角 添加供应商预设列表直接选DeepSeek填入你的DeepSeek API Key模型下拉选deepseek-v4-flash底部点「添加」保存配置顶部齿轮「设置」→ 打开路由总开关、Claude路由开关必须开否则调用失败返回列表点击DeepSeek条目右侧启用软件自动写入~/.claude/settings.json3. 切换验证生效彻底关闭所有终端、VS Code重新打开校验命令claude status输出出现api.deepseek.com、deepseek-v4-flash即配置成功。4. 托盘快捷切换窗口最小化后mac顶部菜单栏右键CC-Switch图标可直接切换所有已保存模型。方案二手动原生配置不使用CC-Switch仅单模型固定一、Claude Code 手动配置macOS配置文件路径~/.claude/settings.json创建目录mkdir-p~/.claude编辑配置文件nano~/.claude/settings.json粘贴DeepSeek标准配置替换你的Key{env:{ANTHROPIC_AUTH_TOKEN:sk-xxxxxxxxxxxxxxxx,ANTHROPIC_BASE_URL:https://api.deepseek.com,ANTHROPIC_MODEL:deepseek-v4-flash}}保存CtrlO→ 回车 →CtrlX3. 重启终端执行claude chat测试二、CodexOpenAI协议工具手动配置路径~/.openai/settings.json{apiKey:sk-xxx,baseUrl:https://api.deepseek.com/v1,model:deepseek-v4-flash}三、Gemini CLI 手动配置# 终端临时配置重启失效exportGOOGLE_API_KEYxxx# 永久写入zsh配置echoexport GOOGLE_API_KEYxxx~/.zshrcsource~/.zshrc三、两种配置方式对比对比项CC-Switch自动配置手动JSON/环境变量多模型切换一键切换保存多套密钥手动改文件只能存一套配置文件软件自动读写无语法错误风险容易JSON格式报错国内模型适配内置DeepSeek/GLM/Kimi预设全部参数手动填写路由代理自带本地路由兼容OpenAI/Anthropic双协议需自己配代理多工具统一管理Claude/Codex/Gemini一套面板管理每个工具单独配置四、常见报错排查切换后模型不变关闭全部终端窗口清空缓存CC-Switch内重新启用供应商鉴权401报错API Key不要带空格DeepSeek预设不要手动修改BaseURL路由调用失败CC-Switch设置页打开对应工具路由开关不要同时手动写环境变量环境变量优先级高于配置文件macOS权限不足安装npm全局工具时执行修复权限命令mkdir-p~/.npm-globalnpmconfigsetprefix~/.npm-globalechoexport PATH~/.npm-global/bin:$PATH~/.zshrcsource~/.zshrc