sdaduanbilei/cc-haha

Fork 0

mirror of https://github.com/NanmiCoder/cc-haha synced 2026-08-01 16:43:37 +08:00

程序员阿江(Relakkes) c2fd674662 docs: rebuild documentation site with React

2026-07-23 20:46:33 +08:00

5.5 KiB

Raw Blame History

环境变量

Claude Code Haha 有两条配置路径：

桌面端用户优先在 设置 → Providers 中选择、测试并激活提供商。应用会管理对应的认证、模型映射和协议代理。
从源码运行 CLI 时，可以使用 .env、Shell 环境变量或 Claude Code 的 settings.json。

不要在多个位置重复保存同一把 API Key。排查问题时，先确认当前是否激活了桌面端 Provider。

常用变量

Anthropic 兼容接口

变量	必填	说明
`ANTHROPIC_API_KEY`	与 Auth Token 二选一	通过 `x-api-key` 请求头发送
`ANTHROPIC_AUTH_TOKEN`	与 API Key 二选一	通过 `Authorization: Bearer` 请求头发送
`ANTHROPIC_BASE_URL`	否	Anthropic Messages 兼容端点的基础地址
`ANTHROPIC_MODEL`	否	当前会话的默认模型
`ANTHROPIC_DEFAULT_FABLE_MODEL`	否	Fable 模型槽位；仅在提供商支持时配置
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	否	Haiku 模型槽位
`ANTHROPIC_DEFAULT_SONNET_MODEL`	否	Sonnet 模型槽位
`ANTHROPIC_DEFAULT_OPUS_MODEL`	否	Opus 模型槽位
`API_TIMEOUT_MS`	否	API 请求超时，单位为毫秒；默认 `600000`

认证变量取决于服务端要求的请求头，不能仅凭提供商名称判断。如果返回 401，先核对服务商文档和桌面端 Provider 的认证策略。

Azure OpenAI

Azure OpenAI 使用独立的 Responses API 路径：

变量	必填	说明
`CLAUDE_CODE_USE_AZURE_OPENAI`	是	设为 `1` 启用 Azure OpenAI
`AZURE_OPENAI_BASE_URL`	是	Azure 资源基础地址；也接受 `AZURE_OPENAI_ENDPOINT`
`AZURE_OPENAI_API_VERSION`	否	API 版本；默认 `2025-04-01-preview`
`AZURE_OPENAI_API_KEY`	是	Azure OpenAI API Key
`AZURE_OPENAI_CODEX_DEPLOYMENT`	视模型而定	Codex 模型对应的 Azure deployment 名称

示例：

CLAUDE_CODE_USE_AZURE_OPENAI=1
AZURE_OPENAI_BASE_URL=https://your-resource.cognitiveservices.azure.com
AZURE_OPENAI_API_VERSION=2025-04-01-preview
AZURE_OPENAI_API_KEY=your_azure_openai_key
AZURE_OPENAI_CODEX_DEPLOYMENT=your_codex_deployment

本地运行与隐私

变量	说明
`CLAUDE_CONFIG_DIR`	改用指定配置目录，而不是默认的 `~/.claude`；适合便携模式和隔离测试
`CLAUDE_CODE_FORCE_RECOVERY_CLI`	设为 `1` 使用简化的 Recovery CLI
`CLAUDE_CODE_SHELL_PREFIX`	为 Bash 工具增加 Shell 前缀，例如 Windows 下的 `wsl -e bash -lc`
`DISABLE_TELEMETRY`	设为 `1` 禁用遥测
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	设为 `1` 禁用非必要网络请求

本地 Server 的 SERVER_HOST、SERVER_PORT、SERVER_AUTH_REQUIRED 等变量见本地 Server。

配置方式

桌面端 Provider

桌面端把 Provider 索引保存到：

~/.claude/cc-haha/providers.json

应用管理的 Provider 环境写入隔离的 Haha 配置，不需要手工复制到 ~/.claude/settings.json。当 CLI 读取到已激活的 Provider 时，会复用其认证、模型和协议设置；openai_chat 与 openai_responses Provider 会自动使用本机回环代理。

详细流程见第三方模型。

`.env` 文件

源码仓库中的 bin/claude-haha 会在项目根目录存在 .env 时加载它：

cp .env.example .env

一个 Anthropic 兼容接口的最小示例：

ANTHROPIC_AUTH_TOKEN=sk-example
ANTHROPIC_BASE_URL=https://provider.example.com/anthropic
ANTHROPIC_MODEL=provider-model
ANTHROPIC_DEFAULT_HAIKU_MODEL=provider-model
ANTHROPIC_DEFAULT_SONNET_MODEL=provider-model
ANTHROPIC_DEFAULT_OPUS_MODEL=provider-model

.env 只用于源码启动脚本。桌面端创建的 CLI 子进程会跳过仓库 .env，避免旧密钥覆盖当前激活的 Provider。

`settings.json`

用户级设置位于 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-example",
    "ANTHROPIC_BASE_URL": "https://provider.example.com/anthropic",
    "ANTHROPIC_MODEL": "provider-model"
  }
}

项目还可能包含 .claude/settings.json 或 .claude/settings.local.json。这些文件属于工作区输入；只在可信项目中使用，尤其不要从不可信仓库接受 PATH、LD_PRELOAD、代理地址或认证相关环境变量。

实际生效顺序

这里不存在可靠的“Shell > .env > settings”三段式规则：

bin/claude-haha 先让 Bun 加载仓库 .env。
CLI 初始化时合并已启用的用户、项目、本地、命令行和受管设置来源。
已激活的 Haha Provider 会覆盖普通 Claude 设置中的 Provider 路由变量，防止两个客户端互相污染。
桌面端 host 注入的运行时变量受到保护，不能被 settings.json 中的同名字段替换。
企业受管策略和 --setting-sources 也会影响最终结果。

因此，切换模型提供商时应只保留一个主要配置入口。桌面端用户使用 Providers 设置页；纯 CLI 用户使用 .env 或用户级 settings.json 之一。

安全建议

不要提交 .env、Provider 配置或包含密钥的 settings.json。
不要在截图、Issue、日志或诊断包中暴露完整 Token。
使用 CLAUDE_CONFIG_DIR 做测试隔离，避免读写真实用户配置。
--print 会跳过工作区信任对话框，只能在可信目录运行。更多限制见 CLI 参考。
远程访问本地 Server 时，不要把 CORS 当成身份认证；请启用 H5 Token 或显式鉴权。

5.5 KiB Raw Blame History Unescape Escape