Gajae-Code环境变量完全参考清单：6级$env解析顺序与密钥变量优先级详解-北京尧图网络

Gajae-Code环境变量完全参考清单6级$env解析顺序与密钥变量优先级详解【免费下载链接】gajae-codeGajae Code MVP项目地址: https://gitcode.com/gh_mirrors/ga/gajae-codeGajae-Code命令名gjc是一个开源的终端 AI 编程代理coding agent让你用自己已订阅的 AI 编码计划在任何仓库里直接跑起编码代理。要用好它核心就是配置好对应的环境变量尤其是模型 API Key。本文整理 Gajae-Code 环境变量的完全参考清单重点讲透6 级$env解析顺序与密钥变量优先级帮你一次性配对环境变量少走弯路。一张表看懂6级$env解析顺序Gajae-Code 运行时并不只看终端里已经导出的变量。它会通过统一模块packages/utils/src/env.ts按固定顺序合并多个来源的环境变量。官方文档中定义的$env加载顺序如下级别来源路径说明1进程环境Bun.env终端里已export的变量2项目.env$PWD/.env仅补充尚未设置的键3Agent.env~/.gjc/agent/.env受GJC_CONFIG_DIR/GJC_CODING_AGENT_DIR影响4配置根.env~/.gjc/.env受GJC_CONFIG_DIR影响5主目录.env~/.env全局兜底6Shell 配置文件~/.zshrc、~/.bashrc、~/.zprofile等逐行扫描字面量赋值核心规则先找到就用它。变量一旦在更高级别被设置低级别的同名值不会覆盖它。两个容易踩坑的细节第 6 级不会真正执行 shell它只是逐行扫描 rc 文件里的字面量export NAMEvalue赋值值是命令替换如FOO$(...)的会被直接丢弃而且嵌在if块里的赋值也会被当作顶层赋值无条件读入。键名按原样使用PI_前缀的键不会自动镜像到对应的GJC_键反之亦然——只有读取代码同时查询两个名字时才都生效。密钥变量优先级详解API Key是怎么被选中的模型供应商的鉴权统一走packages/ai/src/stream.ts中的getEnvApiKey()。Gajae-Code 支持几十家供应商每家一个专属 Key 变量部分供应商还有回退链多个变量按优先级取第一个已设置的。常见密钥回退链取第一个已设置的值场景优先级高 → 低Anthropic 鉴权ANTHROPIC_FOUNDRY_API_KEY仅 Foundry 模式→ANTHROPIC_OAUTH_TOKEN→ANTHROPIC_API_KEYGitHub CopilotCOPILOT_GITHUB_TOKEN→GH_TOKEN→GITHUB_TOKENQwen PortalQWEN_OAUTH_TOKEN→QWEN_PORTAL_API_KEYHugging FaceHUGGINGFACE_HUB_TOKEN→HF_TOKENAWS 区域AWS_REGION→AWS_DEFAULT_REGION→ 默认us-east-1完整供应商清单含 Azure、Vertex、Bedrock、本地 Ollama/LM Studio 等见官方文档docs/environment-variables.md。关键安全设计$env≠$credentialEnv️一个极易被忽视的细节项目cwd/.env无法提供模型鉴权凭证。Gajae-Code 内部凭证解析使用专用的$credentialEnv源码见 env.ts其解析路径主动排除了项目.env。这意味着你 clone 来的陌生仓库无法通过.env塞一个假 Key把请求劫持到别处——你的密钥放在~/.gjc/agent/.env或终端环境里是安全的。常用环境变量速查清单模型 / 供应商鉴权最高频变量用途ANTHROPIC_API_KEY/ANTHROPIC_OAUTH_TOKENAnthropicClaudeOPENAI_API_KEYOpenAIGEMINI_API_KEY/GOOGLE_API_KEYGoogle GeminiDEEPSEEK_API_KEYDeepSeekOPENROUTER_API_KEYOpenRouterGROQ_API_KEY/MISTRAL_API_KEY/MOONSHOT_API_KEYGroq / Mistral / MoonshotGJC_AUTH_BROKER_URLGJC_AUTH_BROKER_TOKEN远程凭证代理vault 模式CLAUDE_CONFIG_DIR/CODEX_HOME指定 Claude Code / Codex CLI 已有凭证的位置存储路径与配置根变量默认值用途GJC_CONFIG_DIR.gjc修改主目录下的配置根目录名GJC_CODING_AGENT_DIR~/.gjc/agent完整覆盖 agent 数据目录GJC_WORKTREE_DIR{repo}/.worktrees--worktree工作树的存放位置行为开关与调试变量效果GJC_UI_LANGUAGE首次启动界面语言en/ko/zh/jaGJC_NO_TITLE禁用会话标题自动生成GJC_DISABLE_TELEMETRY设为1立即关闭遥测GJC_TIMING输出启动耗时树排查性能问题GJC_BASH_NO_LOGINbash 工具改用非登录 shell 模式GJC_PY求值后端0仅 JS、1仅 Python、mix双开实战配置3步搞定环境变量第 1 步密钥放进受信位置⭐️长期有效的 API Key 建议写入~/.gjc/agent/.env——它在主目录下不会被误提交进仓库echo ANTHROPIC_API_KEYsk-ant-... ~/.gjc/agent/.env第 2 步项目级差异写进项目.env像OPENAI_BASE_URL代理地址这类随项目变化的变量写进项目根目录$PWD/.env即可。注意此文件不能用来存放模型 API Key安全原因见上文。第 3 步终端验证最终生效值级别 1进程环境优先级最高终端export会覆盖所有.env文件。配置后用env | grep _API_KEY确认一下避免设了但没生效。常见问题Q1变量设置了为什么没生效按 6 级顺序排查终端里旧export可能盖住了.env或反过来。另外第 6 级只读字面量赋值非字面量一律被丢弃。Q2项目.env能覆盖我的密钥吗不能。一般运行变量中项目.env第 2 级优先于主目录文件第 3~6 级但模型鉴权凭证走专用通道项目.env被排除在外。Q3旧项目的PI_前缀变量还能用吗部分PI_*变量保留为兼容别名如PI_SHELL_PREFIX、PI_DISABLE_LSPMUX其余仅当代码明确双查两个名字时生效不会自动镜像。新配置建议统一使用GJC_前缀。总结记住三点Gajae-Code 的环境变量就不会乱6 级解析顺序进程环境 → 项目.env→~/.gjc/agent/.env→~/.gjc/.env→~/.env→ shell rc 文件先到先生效密钥走专用通道项目.env碰不到模型 API Key供应商有回退链同一供应商多个变量时取第一个已设置的。权威完整清单以官方文档 docs/environment-variables.md 为准源码实现位于 packages/utils/src/env.ts。【免费下载链接】gajae-codeGajae Code MVP项目地址: https://gitcode.com/gh_mirrors/ga/gajae-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Gajae-Code环境变量完全参考清单：6级$env解析顺序与密钥变量优先级详解

相关推荐

容器镜像部署实战：从镜像命名到docker compose排错全指南

OPC UA实战：一人公司如何搞定工业数据采集与项目交付

Unity Android统计SDK手动接入核心原理与避坑指南

更多资讯

家具家装行业AI智能体层落地：Agent、MCP、Skill与Token实战

AgentScope 从 Framework 到 Harness：Agent 生产环境稳定性治理实践

AI Agent实战：用WorkBuddy打造每日情报自动推送系统

从零搭建AI工程化：模型到可靠系统的完整路径与踩坑指南

Tomcat注册Windows服务：从启动失败到生产级稳定运维

Substance Painter 6.1.0.6中文版次世代PBR贴图全流程实战指南

今日更新

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

本周精选

如何彻底离线使用 Laya-CoreML：Hugging Face 下载、缓存机制与 local_files_only 详解

基于1Panel 部署MySQL MCP 服务：TaoToken 统一 Key 接入与 config.toml 配置实战

崇州园区营销网站建设避坑指南：5大注意事项保备案安全

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？