macOS Menu Bar App macOS 菜单栏应用

The elegant way to switch
Claude Code environments

优雅切换
Claude Code 环境

A native macOS menu bar app that makes switching between different Claude Code API configurations effortless. Manage GAC Code, Kimi, Anyrouter, and custom endpoints with a single click.

原生 macOS 菜单栏应用,让切换不同的 Claude Code API 配置变得轻松简单。 一键管理 GAC Code、Kimi、Anyrouter 和自定义端点。

Configuration Management

配置管理

Create, edit, and organize multiple Claude Code API configurations. Support for custom endpoints and presets like GAC Code, Kimi, and Anyrouter.

创建、编辑和管理多个 Claude Code API 配置。支持自定义端点以及 GAC Code、Kimi、Anyrouter 等预设配置。

Smart Shell Integration

智能Shell集成

Automatically updates your shell configuration files (.zshrc, .bashrc) with environment variables. Supports custom config paths and validation.

自动更新您的 shell 配置文件(.zshrc、.bashrc)中的环境变量。支持自定义配置路径和验证。

Menu Bar Convenience

菜单栏便捷操作

Quick access from macOS menu bar with instant configuration switching. Launch at login support and seamless system integration.

从 macOS 菜单栏快速访问,一键切换配置。支持开机启动,与系统无缝集成。

Built for productivity

专为效率而生

Everything you need to manage your Claude Code environments, right from your menu bar.

从菜单栏管理您的 Claude Code 环境所需的一切功能。

One-Click Switching

一键切换

Switch between different Claude Code configurations instantly from your menu bar. No need to restart your terminal or reconfigure environment variables manually.

从菜单栏即时切换不同的 Claude Code 配置。 无需重启终端或手动重新配置环境变量。

Native macOS Experience

原生 macOS 体验

Built with SwiftUI and following Apple's Human Interface Guidelines. Feels right at home on your Mac with native performance and design.

使用 SwiftUI 构建,遵循 Apple 人机界面指南。 原生性能和设计,完美融入您的 Mac。

Secure & Private

安全隐私

Your API keys and configurations are stored locally on your device and never transmitted elsewhere. All configuration changes are applied locally to your shell configuration files.

您的 API 密钥和配置本地存储在您的设备上,绝不传输到其他地方。 所有配置更改都在本地应用到您的 shell 配置文件。

Frequently Asked Questions

常见问题

Important things to know before using CCSwitch

使用 CCSwitch 前需要了解的重要事项

Why does the app request folder access permissions?

为什么应用需要请求文件夹访问权限?

+

CCSwitch needs to read and modify your shell configuration files (.zshrc, .bashrc, etc.) to update environment variables. When you first run the app, macOS will prompt you to grant access to your home directory or specific folders. This permission is required for the app to function properly. All file operations are performed locally on your device.

CCSwitch 需要读取和修改您的 shell 配置文件(.zshrc、.bashrc 等)来更新环境变量。 首次运行应用时,macOS 会提示您授予对主目录或特定文件夹的访问权限。 此权限是应用正常运行所必需的。所有文件操作都在您的设备上本地执行。

Why don't configuration changes take effect immediately?

为什么配置更改不会立即生效?

+

When CCSwitch updates your shell configuration file, the changes only affect new terminal sessions. Existing terminal windows will continue using the old environment variables. To apply changes to current terminals, you need to manually run:

当 CCSwitch 更新您的 shell 配置文件时,更改只会影响新的终端会话。 现有的终端窗口将继续使用旧的环境变量。要将更改应用到当前终端,您需要手动运行:

source ~/.zshrc # or your custom config file # 或您的自定义配置文件

Tip: You can also close and reopen your terminal to load the new configuration.

提示:您也可以关闭并重新打开终端来加载新配置。

How do I set up a custom shell configuration file?

如何设置自定义的 shell 配置文件?

+

By default, CCSwitch modifies ~/.zshrc. If you use a different shell or custom configuration file:

默认情况下,CCSwitch 会修改 ~/.zshrc。如果您使用不同的 shell 或自定义配置文件:

  1. Open CCSwitch Settings (⌘,)
  2. Enable "Use custom config file"
  3. Select your config file (e.g., ~/.bashrc, ~/.profile)
  4. The app will validate the file path and permissions
  1. 打开 CCSwitch 设置(⌘,)
  2. 启用"使用自定义配置文件"
  3. 选择您的配置文件(如 ~/.bashrc, ~/.profile)
  4. 应用会验证文件路径和权限

How can I verify that a configuration is working?

如何验证配置是否正常工作?

+

After switching configurations, you can verify the environment variables in a new terminal:

切换配置后,您可以在新终端中验证环境变量:

echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL
claude-code --version

You can also test the connection by running a simple Claude Code command to ensure it's using the correct API endpoint.

您也可以通过运行简单的 Claude Code 命令来测试连接,确保它使用了正确的 API 端点。

What should I do if the app stops working after a macOS update?

如果 macOS 更新后应用停止工作怎么办?

+

macOS updates sometimes reset app permissions. If CCSwitch stops working:

macOS 更新有时会重置应用权限。如果 CCSwitch 停止工作:

  1. Go to System Preferences → Security & Privacy → Privacy
  2. Select "Files and Folders" or "Full Disk Access"
  3. Ensure CCSwitch has the necessary permissions
  4. Restart the app if needed
  1. 前往系统偏好设置 → 安全性与隐私 → 隐私
  2. 选择"文件和文件夹"或"完全磁盘访问权限"
  3. 确保 CCSwitch 具有必要的权限
  4. 如有需要请重启应用

Ready to get started?

准备开始使用?

Download CCSwitch for macOS and streamline your Claude Code workflow today.

下载 CCSwitch macOS 版,立即优化您的 Claude Code 工作流程。

Download for macOS
下载 macOS 版
Requires macOS 13.0 or later 需要 macOS 13.0 或更高版本

Support the Project

支持项目

Help us continue improving CCSwitch

帮助我们持续改进 CCSwitch

Buy Me a Coffee 请我喝咖啡

Support through Buy Me a Coffee platform

通过 Buy Me a Coffee 平台支持

Alipay 支付宝

Scan QR code with Alipay app

使用支付宝扫码支付

Alipay QR Code

Open Alipay and scan this code

打开支付宝扫描此二维码

WeChat Pay 微信支付

Scan QR code with WeChat app

使用微信扫码支付

WeChat Pay QR Code

Open WeChat and scan this code

打开微信扫描此二维码