CCX (Claude Code Context)

English

CLI 工具，用於管理多組 Claude Code settings。可在不同情境（工作、個人、專案）之間快速切換 ~/.claude/settings.json 設定。

安裝

$3

``bash
brew tap tim80411/tap
brew install ccx
`

更新：

`bash
brew update
brew upgrade ccx
`

$3

`bash
git clone
cd ccx
bun install
bun link
`

使用方式

$3

從目前的 Claude Code 設定建立新的 setting：

`bash
ccx setting create


例如: ccx setting create work


`

$3

`bash
ccx setting list
`

$3

切換到指定的 setting（會自動備份目前設定到 previous）：

`bash
ccx setting use


例如: ccx setting use personal


`

未指定名稱時，會進入互動選擇模式：

`bash
ccx setting use
`

$3

顯示目前使用中的 setting 名稱：

`bash
ccx setting status
`

$3

用目前的 Claude Code 設定覆蓋指定的 setting：

`bash
ccx setting update


例如: ccx setting update work


`

未指定名稱時，會更新當前使用中的 setting（需確認）：

`bash
ccx setting update
`

$3

顯示當前 setting 的檔案路徑：

`bash
ccx setting path
`

顯示 Claude 官方設定檔路徑：

`bash
ccx setting path --official
`

$3

顯示當前 setting 的內容：

`bash
ccx setting show
ccx setting show --raw # 輸出非格式化的 JSON
`

顯示 Claude 官方設定檔內容：

`bash
ccx setting show --official
`

$3

比較當前 setting 與 Claude 官方設定：

`bash
ccx setting diff
`

比較指定 setting 與 Claude 官方設定：

`bash
ccx setting diff


例如: ccx setting diff work


`

比較兩個 setting：

`bash
ccx setting diff


例如: ccx setting diff work personal


`

使用語意化輸出（依 added/removed/modified 分組）：

`bash
ccx setting diff --semantic
`

環境變數

| 變數 | 說明 |
|------|------|
| CLAUDE_CONFIG_DIR | 自訂 Claude 設定目錄路徑（預設為 ~/.claude） |

檔案路徑

| 用途 | 路徑 |
|------|------|
| Claude Code 設定 | ~/.claude/settings.json |
| 儲存的 Settings | ~/.config/ccx/settings/.json |
| 自動備份 | ~/.config/ccx/settings/previous.json |
| 狀態追蹤 | ~/.config/ccx/state.json |

開發

`bash


執行測試

bun test

直接執行 CLI

bun run src/index.ts setting [args]

全域安裝（開發用）

bun link
``

授權

MIT