# ショートカットコマンド

> ccam shortcutで、アカウントにccworkのような専用のコマンドを付け、ccam shims installで~/.local/binのリンクを作り直します。

Source: https://ccam.dev/ja/features/shortcuts/ · Updated 2026-10-19

ショートカットは、1つのアカウントとしてClaude Codeを起動する、自分で名前を付けたコマンドです。`ccwork --resume`は`ccam work --resume`と同じ動作をします。実体は`~/.local/bin`にあるccamへのリンクなので、bash、zsh、スクリプトなど、`PATH`からプログラムを実行するあらゆる場所で動作します。ショートカットは任意です。よく起動するアカウントに作成してください。

## 使い方

```sh
ccam shortcut work ccwork     # create the shortcut ccwork for work
ccam shortcut 2 ccside        # the account with number 2
ccam shortcut work            # show it
ccam shortcut work ccw        # rename it; the old link is removed
ccam shortcut work --remove   # delete it
ccam add side --shortcut ccside
ccam shims install            # recreate missing links of all accounts
ccwork -p "summarise" --output-format json
```

ccamは変更のたびに結果を表示します。

```console
$ ccam shortcut work ccwork
✓ shortcut for work: ccwork
$ ccam shortcut work ccw
✓ shortcut for work: ccw (was ccwork)
$ ccam shortcut work --remove
✓ ccw removed; work has no shortcut now
$ ccam shortcut work
work: none (add one with `ccam shortcut work ccwork`)
```

1つのアカウントが持てるショートカットは最大1つで、`~/.config/ccam/config.toml`に`shortcut`として保存されます。`ccam add`のウィザードは`Create a shortcut command for <name>? [y/N]`と尋ね、続いて`Shortcut name [cc<name>]:`と尋ねます。ウィザード以外では、`ccam add`は`--shortcut`を付けた場合だけショートカットを作成します。`ccam list`は各アカウントのショートカットを表示し、ない場合は`-`と表示します。

ショートカットは、`ccam <name>`が名前より後の引数を扱うのと同じように、すべての引数をClaude Codeに渡します。`--dry-run`や`--help`も含まれます。起動をプレビューするには、`ccam --dry-run work`を使ってください。

## オプション

| オプション | 効果 | デフォルト |
| --- | --- | --- |
| `--remove` | アカウントのショートカットとそのリンクを削除します | オフ |
| `-h`、`--help` | コマンドのヘルプ | |
| `--dry-run` | `ccam shortcut`は対応しています。名前を確認し、保存もリンクもせずに`Would set the shortcut of work to ccwork.`または`Would remove ccwork, the shortcut of work.`と表示します | オフ |

`ccam shims install`は引数を取らず、`--dry-run`を`` ccam: --dry-run is not supported by `ccam shims install`; nothing was changed ``で拒否します。

名前の規則は、次の順序で確認されます。

- `a-z`、`0-9`、`.`、`-`、`_`を使った1～64文字で、先頭は英字か数字であること
- `ccam`、`claude`、`run`や`usage`などのccamのコマンドではないこと
- ほかのアカウントのショートカットではないこと
- `~/.local/bin`にある、ccamへのリンクではないファイルと同じ名前ではないこと
- `PATH`上にあるほかの実行ファイルの名前ではないこと

コマンドと`--remove`を同時に指定すると、`give a command or --remove, not both`で停止します。アカウントがすでに持っている名前を設定すると`work: ccwork (unchanged)`と表示し、リンクがなければ作り直します。

## しくみ

名前を設定すると`checkShortcut`が実行され、binフォルダーとccamのバイナリの実際のパスを指定して`shim.Check`を呼び出します。

名前は確認を順に通っていきます。各確認の横には、その確認で拒否される名前を示しています。`Work`はパターンに合わず、`run`はccamのコマンドで、`ccside`はほかのアカウントのもので、`ccfile`は`~/.local/bin`にある既存のファイルで、`git`は`/usr/bin/git`を隠してしまいます。すべての確認に通った名前だけが保存され、リンクされます。

1. `shim.Check`は、名前を`^[a-z0-9][a-z0-9._-]{0,63}$`、`config.Reserved`、`cfg.FindShortcut`の順に照合します。`~/.local/bin/<name>`に対して`os.Lstat`を呼び出し、`PATH`上のそれ以外の各フォルダーに対しては`os.Stat`を呼び出して、ccamへのリンクではない実行ファイルがあれば拒否します。
2. ccamは`fsutil.AtomicWrite`（一時ファイル、`fsync`、rename）で`config.toml`を保存します。
3. `shim.Remove`が古いショートカットのリンクを削除します。ただし、それがccamへのリンクである場合だけです。
4. `shim.Install`が、設定されているショートカットのうち足りないものについて、`os.Symlink`でccamのバイナリへのリンクを作成します。バイナリのパスは`os.Executable`と`filepath.EvalSymlinks`で求めます。何かを削除することはありません。

`os.Readlink`がccamのパスを返す場合、またはリンクとccamのパスが同じファイルに解決される場合、そのリンクはccam自身のものとみなされます。削除と上書きの確認はすべてこの判定を通るので、ccamが自分で作成していないファイルに触れることはありません。

ショートカットを実行したとき、ccamが必要とするのは入力された名前だけです。

シェルが`PATH`上で`ccwork`を見つけ、カーネルがリンクをたどってccamのバイナリを起動します。このとき`argv[0]`は`ccwork`のままです。`app.Main`では、`ccam`以外の名前の場合、`config.toml`を一度読み込んで`shim.Lookup`を呼び出し、`shortcut`が`filepath.Base(argv[0])`と一致するアカウントを見つけます。続いて`launcher.LaunchWith`が、読み込み済みの設定を使って[`ccam <name>`](https://ccam.dev/ja/features/launch.md)と同じ手順をたどり、`argv[1:]`をそのまま`claude`に渡します。

シェルのエイリアスやラッパースクリプトではなくシンボリックリンクを使う理由は、すべてのシェルとスクリプトで動作し、シェルの起動が余分に発生せず（約1～2 ms）、起動時に読むファイルも1つのままだからです。`scripts/perf-check.sh`は、`ccam <name>`と同じ10 ms（p95）の上限で、`hyperfine`を使ってショートカットを計測します。

## 安全性と特殊なケース

- **どのアカウントのものでもないリンク。** `config.toml`の`shortcut`を手動で編集した後などに、`~/.local/bin`にあるccamへのリンクの名前をどのアカウントも使っていない場合、ccamはデフォルトのアカウントにフォールバックしません。`` ccam: ccold is not the shortcut of any account (see `ccam list`, `ccam shortcut`) ``で停止します。`ccam shortcut`で名前を設定し直すか、リンクを削除してください。
- **既存のファイル。** ccamは自分で作成していないファイルを置き換えることはありません。`ccam shims install`は`<path> already exists and is not a ccam link, so it was left alone`で停止します。
- **ccamのバイナリを移動した場合。** 古いリンクは存在しないパスを指すことになり、ccamはそれを自身のものとみなしません。それらを削除してから`ccam shims install`を実行してください。
- **名前の変更と削除。** `ccam rename`ではショートカットの名前は変わらず、リンクも動作し続けます。リンクはccamを指しており、ccamが`config.toml`で名前を調べるためです。`ccam remove`はアカウントのリンクを削除します。`ccam shortcut <account> <new>`は、新しいリンクを作成する前に古いリンクを削除します。
- **PATH。** ccamがリンクを作成したときに`~/.local/bin`が`PATH`にない場合、`Note: /home/me/.local/bin is not in PATH. Add it to ~/.bashrc or ~/.zshrc:`に続けて、追加すべき`export PATH=...`の行を表示します。
- **あとから確認する。** `ccam doctor`は`missing shortcuts in /home/me/.local/bin: ccwork`と報告し、フォルダーが`PATH`にない場合は警告します。`ccam doctor --fix`は足りないリンクを作成します。

## 関連項目

- [Claude Codeの起動](https://ccam.dev/ja/features/launch.md)
- [アカウントの管理](https://ccam.dev/ja/features/accounts.md)
- [コマンドリファレンス](https://ccam.dev/ja/docs/commands.md#shortcuts)
- [ccamのインストール](https://ccam.dev/ja/docs/install.md)