导航
Claude Code配置
getting-started / Claude Code配置
Claude Code配置
配置必需的环境变量
在启动 Claude Code CLI 或 VS Code 插件之前,需要先准备若干环境变量。推荐一次性配置在 shell/系统设置里,并在修改后重新打开终端或编辑器,这样每个新会话都会自动继承。
macOS 或 Linux
将下列内容添加到 ~/.zshrc(zsh)或 ~/.bashrc(bash)中:
1 # Claude Code2 export ANTHROPIC_BASE_URL="https://www.codebyai.net/api/agent"3 export ANTHROPIC_AUTH_TOKEN="sk-proj-xxxx" # 替换成刚刚复制的 apikey4 export API_TIMEOUT_MS=6000005 export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
保存文件后运行 source ~/.zshrc 使配置立即生效。
若希望逐条追加,可运行(bash 用户将 ~/.zshrc 改为 ~/.bashrc):
1 echo 'export ANTHROPIC_BASE_URL="https://www.codebyai.net/api/agent"' >> ~/.zshrc2 echo 'export ANTHROPIC_AUTH_TOKEN="sk-proj-xxxx"' >> ~/.zshrc3 echo 'export API_TIMEOUT_MS=600000' >> ~/.zshrc4 echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1' >> ~/.zshrc5 6 source ~/.zshrc
Windows
以下任意方式都可以完成同样的配置:
方式 1 · GUI(推荐,永久生效)
- 按
Win + R,输入sysdm.cpl并回车。 - 打开 高级 → 环境变量。
- 在 用户变量 中点击 新建,逐个添加:
ANTHROPIC_BASE_URL→https://www.codebyai.net/api/agentANTHROPIC_AUTH_TOKEN→sk-proj-xxxxAPI_TIMEOUT_MS→600000CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC→1
- 关闭所有窗口,重启终端或 IDE。
方式 2 · 命令提示符(永久)
1 setx ANTHROPIC_BASE_URL "https://www.codebyai.net/api/agent"2 setx ANTHROPIC_AUTH_TOKEN "sk-proj-xxxx"3 setx API_TIMEOUT_MS "600000"4 setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC "1"
方式 3 · PowerShell(永久)
1 [System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://www.codebyai.net/api/agent', 'User')2 [System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-proj-xxxx', 'User')3 [System.Environment]::SetEnvironmentVariable('API_TIMEOUT_MS', '600000', 'User')4 [System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC', '1', 'User')
方式 4 · 临时会话(只对当前 CMD 窗口生效)
1 set ANTHROPIC_BASE_URL=https://www.codebyai.net/api/agent2 set ANTHROPIC_AUTH_TOKEN=sk-proj-xxxx3 set API_TIMEOUT_MS=6000004 set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
启动 Claude 编码环境
在任意项目目录中运行:
1 cd your-project2 claude
成功启动后将出现类似界面:

若使用 VS Code(或其他 IDE)插件,也需要上述环境变量。若看到如下提示:

说明插件没有读到配置,需要重新检查。也可以直接在配置文件里写死这些值:
-
Claude 全局设置
- macOS/Linux:
~/.claude/settings.json - Windows:
C:/Users/<UserName>/.claude/settings.json
内容示例:
1 {2 "env": {3 "ANTHROPIC_AUTH_TOKEN": "sk-proj-xxxx",4 "ANTHROPIC_BASE_URL": "https://www.codebyai.net/api/agent",5 "API_TIMEOUT_MS": "600000",6 "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"7 }8 } - macOS/Linux:
-
VS Code settings.json – 添加:
1 "claudeCode.environmentVariables": [2 { "name": "ANTHROPIC_BASE_URL", "value": "https://www.codebyai.net/api/agent" },3 { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-proj-xxxx" }4 ],
修改后请重新加载 VS Code 或重启终端。