CLI 与终端参考

这页把官方 CLI reference、advanced setup、environment variables、terminal config、keybindings、fullscreen、voice dictation 和 deep links 合成一个速查。安装失败和登录失败仍优先看 安装与登录排错。

#常用 CLI

接 Passion8 的最小测试:

ANTHROPIC_BASE_URL=https://passion8.cc \
ANTHROPIC_AUTH_TOKEN=sk-你的 Passion8 API Key \
claude -p "用一句话回答 ping"

#安装和版本

Windows 选择:

安装后验证:

claude --version
claude doctor
claude auth status --text

#环境变量

长期配置建议写进 ~/.claude/settings.json 的 env,但不要把团队共享项目文件里写入个人 Key。

#终端快捷键和输入

如果 Shift+Enter 不工作,运行:

/terminal-setup

某些终端或 JetBrains 内置终端不支持这个方案,需要使用替代快捷键。

#Fullscreen rendering

Fullscreen rendering 提供更稳定的全屏渲染、鼠标和 transcript 浏览体验。

如果你依赖原生终端选择文本,可以保留 native selection。tmux 下要同时考虑 tmux 自己的 copy mode。

#Voice dictation

语音输入适合长 prompt、移动场景或不方便打字时使用。

常见问题:

#Deep links

Deep links 用 claude-cli:// 从 runbook、告警、dashboard 或内部平台打开 Claude Code。

示例:

claude-cli://open?q=Investigate%20the%205xx%20rate&repo=acme/web-gateway

不要在 deep link 里放 secrets。敏感信息由本地工具或安全存储读取。

#PATH 和冲突安装

#缓存策略

默认不写时走 5 分钟 TTL。如果你在 1 小时内反复进入同一个大项目,可考虑:

export ENABLE_PROMPT_CACHING_1H=1

#官方参考

• CLI reference
• Advanced setup
• Environment variables
• Terminal config
• Keybindings
• Fullscreen
• Voice dictation
• Deep links
• Troubleshoot install