AtomCode 环境变量完整参考手册
持续深度分析 — 所有
ATOMCODE_*环境变量与系统配置 2026-06-23
1. 核心路径与目录
| 变量 | 默认值 | 说明 |
|---|---|---|
ATOMCODE_HOME | ~/.atomcode/ | AtomCode 数据根目录（配置、会话、插件、日志） |
ATOMCODE_GIT_PATH | git (from PATH) | Git 可执行文件路径（用于插件市场） |
ATOMCODE_PLUGIN_ROOT | ~/.atomcode/plugins/ | 插件安装根目录 |
ATOMCODE_PREFIX | /usr/local/bin 或 ~/.local/bin | 安装前缀目录（安装脚本用） |
2. 遥测与隐私
| 变量 | 值类型 | 说明 |
|---|---|---|
ATOMCODE_TELEMETRY | 0 / 1 | 禁用(=0)或启用遥测。优先级高于 config |
DO_NOT_TRACK | 1 | 标准 DNT 信号，等效于禁用遥测 |
ATOMCODE_TELEMETRY_ENDPOINT | URL | 自定义遥测端点（默认：https://acs.atomgit.com/api/v1/events） |
3. 认证与平台
| 变量 | 值类型 | 说明 |
|---|---|---|
ATOMCODE_GITHUB_MCP_CLIENT_ID | String | GitHub MCP OAuth 客户端 ID |
ATOMCODE_PLATFORM_SERVER | URL | AtomGit 平台服务器地址 |
ATOMCODE_INVITE | String (8 位字母数字) | 邀请码（安装时使用） |
4. CodingPlan
| 变量 | 值类型 | 说明 |
|---|---|---|
ATOMCODE_CODINGPLAN_API_BASE | URL | CodingPlan API 基础 URL（默认：https://api.gitcode.com/api/v5） |
ATOMCODE_CODINGPLAN_LLM_BASE_URL | URL | CodingPlan LLM 代理 URL（自定义 LLM 端点） |
5. 网络与超时
| 变量 | 值类型 | 默认值 | 说明 |
|---|---|---|---|
ATOMCODE_FIRST_TOKEN_TIMEOUT_SECS | u64 | — | 首个 token 超时（秒） |
ATOMCODE_STREAM_TIMEOUT_SECS | u64 | 120 | 流超时（默认 120 秒，二进制中 Stream timeout: no data received for 120 seconds） |
ATOMCODE_DAEMON_ENABLE_DANGEROUS_TOOLS | bool | false | 允许 daemon 使用危险工具 |
6. 调试与诊断
| 变量 | 值类型 | 说明 |
|---|---|---|
ATOMCODE_WIRE_DUMP | bool | 启用网络数据包转储（写入 ~/.atomcode/wire-dump/） |
ATOMCODE_RENDER_DUMP | bool | 转储 TUI 渲染输出 |
ATOMCODE_SHOW_RAW_API_ERROR | bool | 显示原始 API 错误（默认不显示） |
ATOMCODE_TUIX_LOG | String | TUIX 日志级别 |
ATOMCODE_CJK_WIDTH | Number | CJK 字符宽度覆盖 |
ATOMCODE_USAGE_DEBUG_PERCENT | Number | 使用量调试百分比 |
ATOMCODE_USAGE_DEBUG_THRESHOLD | Number | 使用量调试阈值 |
ATOMCODE_ENABLE_CD | bool | 启用目录切换调试 |
ATOMCODE_DISABLE_TOOLS | String | 禁用工具列表（逗号分隔，如 bash,web_fetch） |
7. 内部/升级
| 变量 | 说明 |
|---|---|
ATOMCODE_INTERNAL_PREPARE_UPGRADE | 内部：准备升级标记 |
ATOMCODE_UPGRADED_FROM | 内部：记录从哪个版本升级而来 |
8. Hooks 与扩展
| 变量 | 说明 |
|---|---|
ATOMCODE_HOOK_EVENT | 当前钩子事件名称（钩子执行时设置） |
ATOMCODE_HOOK_CONTEXT | 当前钩子上下文 JSON（钩子执行时设置） |
ATOMCODE_TOOL_NAME | 当前工具名称（钩子执行时设置） |
这些变量在钩子脚本执行期间被设置，钩子可通过读取这些变量获取上下文。
9. 兼容性变量
| 变量 | 说明 |
|---|---|
CLAUDE_PLUGIN_ROOT | Claude Code 兼容性（等同于 ATOMCODE_PLUGIN_ROOT） |
CLAUDE_SESSION_ID | Claude Code 兼容性会话 ID |
CLAUDE_SKILL_DIR | Claude Code 兼容性 Skill 目录 |
10. TUI 与终端
| 变量 | 说明 |
|---|---|
ATOMCODE_PLAIN | 纯文本模式（无 TUI 渲染） |
ATOMCODE_RETAIN | 保留输出模式 |
ATOMCODE_WEBUI_DEV | WebUI 开发者模式 |
ATOMCODE_QR_DENSE | QR 码使用密集模式 |
ATOMCODE_QR_BRAILLE | QR 码使用盲文点阵 |
ATOMCODE_ASCII | ASCII 模式（减少 Unicode 使用） |
ATOMCODE_UNICODE | Unicode 模式控制 |
ATOMCODE_KBD_NOT_ENHANCED | 禁用增强键盘协议 |
ATOMCODE_CODINGPLAN_REPORT | CodingPlan 报告输出 |
11. GitHub Codespaces / 容器
| 变量 | 说明 |
|---|---|
ATOMCODE_DAEMON_URL | Daemon URL（容器/Python 代理使用，默认 http://localhost:13456） |
12. 环境文件与配置层级
环境变量 (最高优先级)
↓
CLI 参数 (--no-telemetry, --dev 等)
↓
$ATOMCODE_HOME/config.toml (TOML 格式)
↓
二进制内置默认值 (最低优先级)config.toml 结构（推测）
toml
[telemetry]
# enabled = true
# endpoint = "https://..."
[datalog]
# dir = "~/.atomcode/datalog"
[plugin]
# auto_install_default_skills = true
# auto_update_marketplaces = true
[provider]
# ...
[hooks]
# ...
[lsp]
# auto_detect = true
# diagnostics_settle_delay_ms = 500
[ui]
# theme = "dark"
# language = "en"
[notifications]
# ...
[auto_update]
# enabled = true
[auto_commit]
# enabled = false13. 环境变量统计
| 类别 | 数量 |
|---|---|
| 核心路径 | 4 |
| 遥测与隐私 | 3 |
| 认证与平台 | 3 |
| CodingPlan | 2 |
| 网络与超时 | 3 |
| 调试与诊断 | 12 |
| 内部/升级 | 2 |
| Hooks | 3 |
| 兼容性 | 3 |
| TUI 与终端 | 11 |
逆向命令索引
bash
# 提取所有 ATOMCODE_* 环境变量
strings atomcode.bin.bak | grep -oP 'ATOMCODE_[A-Z_]+' | sort -u
# 输出: 35+ 个变量
# 提取其他控制变量
strings atomcode.bin.bak | grep -E "DO_NOT_TRACK|SUDO_USER|HOME|CWD" | sort -u
# 输出: DO_NOT_TRACK SUDO_USER <HOME> <CWD>
# 查看 ATOMCODE_HOME 值
echo "${ATOMCODE_HOME:-~/.atomcode}"
# 查看 DO_NOT_TRACK
echo "${DO_NOT_TRACK:-not set}"| 容器 | 1 | | 总计 | ~47 个 |
本报告由持续分析循环生成 — 环境变量完整覆盖