1
0
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2026-03-30 19:23:56 +08:00
ohmyzsh-mirror/plugins/claude-code
2026-03-21 12:10:33 -06:00
..
claude-code.plugin.zsh feat(claude-code): add initial plugin implementation with aliases, helpers, and tab completion 2026-03-21 12:10:33 -06:00
README.md feat(claude-code): add initial plugin implementation with aliases, helpers, and tab completion 2026-03-21 12:10:33 -06:00

Claude Code Plugin

The claude-code plugin adds several aliases and helper functions for Claude Code, the CLI for Claude.

To use it, add claude-code to the plugins array of your zshrc file:

plugins=(... claude-code)

Aliases

Core

Alias Command Description
cl claude Start interactive session
clc claude --continue Continue last conversation
clr claude --resume Open session picker
clp claude -p Headless/print mode
clv claude --version Show version
clu claude update Update Claude Code

Sessions

Alias Command Description
cln claude -n Start a named session
clw claude -w Start in a git worktree
clfork claude --fork-session Fork current session

Auth

Alias Command Description
clas claude auth status Check auth status
clal claude auth login Sign in
clao claude auth logout Sign out

Config

Alias Command Description
clmcp claude mcp Manage MCP servers
clag claude agents List configured agents

Channels

Alias Command Description Plugin Install
clch-tg claude --channels plugin:telegram@... Start with Telegram channel /plugin install telegram@claude-plugins-official
clch-dc claude --channels plugin:discord@... Start with Discord channel /plugin install discord@claude-plugins-official
clch <spec> claude --channels <spec> Start with custom channel

Functions

Function Description Example
clm <model> Start with a specific model clm opus
cle <effort> Start with a specific effort level cle high
clds Directory session — create/resume a session named after $PWD cd my-project && clds
clfp <pr> Resume sessions linked to a GitHub PR clfp 123

Configuration Variables

Set these in your ~/.zshrc before the plugins line:

Variable Default Description
ZSH_CLAUDE_DEFAULT_MODEL (unset) Default model for clm and _claude_with_defaults
ZSH_CLAUDE_DEFAULT_EFFORT (unset) Default effort level
ZSH_CLAUDE_DEFAULT_PERMISSION_MODE (unset) Default permission mode (plan/auto/manual)
ZSH_CLAUDE_AUTO_CONTINUE false Auto-continue last session when opening a new shell

Example configuration

# ~/.zshrc
ZSH_CLAUDE_DEFAULT_MODEL="sonnet"
ZSH_CLAUDE_DEFAULT_EFFORT="high"
ZSH_CLAUDE_AUTO_CONTINUE=false

plugins=(... claude-code)

Tab Completion

  • clm [TAB] — completes model names (opus, sonnet, haiku)
  • cle [TAB] — completes effort levels (low, medium, high, max)