Claude Code

What

Display Claude Code session information including the current AI model, token usage, costs, and workspace details. Shows a visual gauge of context window usage and formatted cost/token information for monitoring your Claude usage.

This segment integrates with Claude Code's statusline functionality to provide real-time session data in your prompt.

Sample Configuration

json

{
  "type": "claude",
  "style": "diamond",
  "leading_diamond": "",
  "trailing_diamond": "",
  "foreground": "#FFFFFF",
  "background": "#FF6B35",
  "template": " 󰯉 {{ .Model.DisplayName }}  {{ .TokenUsagePercent.Gauge }} "
}

yaml

type: claude
style: diamond
leading_diamond: 
trailing_diamond: 
foreground: "#FFFFFF"
background: "#FF6B35"
template: " 󰯉 {{ .Model.DisplayName }}  {{ .TokenUsagePercent.Gauge }} "

toml

type = "claude"
style = "diamond"
leading_diamond = ""
trailing_diamond = ""
foreground = "#FFFFFF"
background = "#FF6B35"
template = " 󰯉 {{ .Model.DisplayName }}  {{ .TokenUsagePercent.Gauge }} "

Template (info)

default template

 \udb82\udfc9 {{ .Model.DisplayName }} \uf2d0 {{ .TokenUsagePercent.Gauge }}

Properties

Name	Type	Description
.SessionID	string	Unique identifier for the Claude session
.Model	Model	AI model information
.Workspace	Workspace	Workspace directory information
.Cost	Cost	Cost and duration information
.ContextWindow	ContextWindow	Token usage information
.TokenUsagePercent	Percentage	Percentage of context window used (0-100)
.FormattedCost	string	Formatted cost string (e.g., "$0.15" or "$0.0012")
.FormattedTokens	string	Human-readable token count (e.g., "1.2K", "15.3M")
.FormattedDuration	string	Total session duration (e.g., "2m 5s")
.FormattedAPIDuration	string	API wait time (e.g., "0m 45s")
.FiveHourUsage	Percentage	5-hour rolling rate limit usage (0-100)
.SevenDayUsage	Percentage	7-day rate limit usage (0-100)

Model Properties

Name	Type	Description
.ID	string	Technical model identifier
.DisplayName	string	Human-readable model name (e.g., "Claude 3.5 Sonnet")

Workspace Properties

Name	Type	Description
.CurrentDir	string	Current working directory
.ProjectDir	string	Root project directory
.GitWorktree	string	Path to the linked git worktree, empty when not inside a linked git worktree

Cost Properties

Name	Type	Description
.TotalCostUSD	float64	Total cost in USD
.TotalDurationMS	DurationMS	Total session duration in milliseconds (formats as "Xm Ys")
.TotalAPIDurationMS	DurationMS	Time spent waiting for API responses (formats as "Xm Ys")
.TotalLinesAdded	int	Lines of code added in the session
.TotalLinesRemoved	int	Lines of code removed in the session

ContextWindow Properties

Name	Type	Description
.TotalInputTokens	int	Total input tokens used in the session
.TotalOutputTokens	int	Total output tokens generated in the session
.ContextWindowSize	int	Maximum context window size for the model
.CurrentUsage	CurrentUsage	Current message token usage

CurrentUsage Properties

Name	Type	Description
.InputTokens	int	Input tokens for the current message
.OutputTokens	int	Output tokens for the current message

RateLimits Properties

Available when Claude Code provides rate limit data (Pro/Max subscribers). Access via .RateLimits.

Name	Type	Description
.FiveHour	RateLimitWindow	5-hour rolling window
.SevenDay	RateLimitWindow	7-day rolling window

RateLimitWindow Properties

Name	Type	Description
.UsedPercentage	*float64	Usage percentage (0-100), nil if unknown
.ResetsAt	*int64	Unix epoch seconds when window resets

Percentage Methods

The TokenUsagePercent property is a Percentage type that provides additional functionality:

Method	Returns	Description
.Gauge	string	Visual gauge showing remaining capacity using 5 bar blocks (▰▰▰▰▱)
.GaugeUsed	string	Visual gauge showing used capacity using 5 bar blocks (▰▱▱▱▱)
.String	string	Numeric percentage value (e.g., "75" for use in templates)

How it works

The segment reads session information from the POSH_CLAUDE_STATUS environment variable, which is automatically set when using the oh-my-posh claude command. The data includes:

• Current AI model information
• Token usage and context window utilization
• Session costs and duration
• Workspace directory information

The segment only displays when Claude Code is actively providing session data.