Claude Code 구성

필수 환경 변수 구성

Claude Code CLI 또는 VS Code 확장을 시작하기 전에, 몇 가지 환경 변수를 준비해야 합니다. 셸/시스템 설정에서 한 번 구성한 다음 터미널이나 편집기를 다시 열어 수정 사항을 적용하는 것이 좋습니다. 이렇게 하면 모든 새 세션이 자동으로 상속받습니다.

macOS 또는 Linux

다음 내용을 ~/.zshrc (zsh) 또는 ~/.bashrc (bash)에 추가하세요:

Copy
1
# Claude Code
2
export ANTHROPIC_BASE_URL="https://www.codebyai.net/api/agent"
3
export ANTHROPIC_AUTH_TOKEN="sk-proj-xxxx" # 방금 복사한 API Key로 교체하세요
4
export API_TIMEOUT_MS=600000
5
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

파일을 저장한 후 source ~/.zshrc를 실행하여 구성이 즉시 적용되도록 하세요.

하나씩 추가하려면 다음을 실행하세요 (bash 사용자는 ~/.zshrc를 ~/.bashrc로 변경):

Copy
1
echo 'export ANTHROPIC_BASE_URL="https://www.codebyai.net/api/agent"' >> ~/.zshrc
2
echo 'export ANTHROPIC_AUTH_TOKEN="sk-proj-xxxx"' >> ~/.zshrc
3
echo 'export API_TIMEOUT_MS=600000' >> ~/.zshrc
4
echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1' >> ~/.zshrc
5
 
6
source ~/.zshrc

Windows

다음 방법 중 하나를 사용하여 동일한 구성을 완료할 수 있습니다:

방법 1 · GUI (권장, 영구적)

1. Win + R을 누르고 sysdm.cpl을 입력한 다음 Enter를 누르세요.
2. 고급 → 환경 변수를 엽니다.
3. 사용자 변수에서 새로 만들기를 클릭하고 하나씩 추가합니다:
   • ANTHROPIC_BASE_URL → https://www.codebyai.net/api/agent
   • ANTHROPIC_AUTH_TOKEN → sk-proj-xxxx
   • API_TIMEOUT_MS → 600000
   • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC → 1
4. 모든 창을 닫고 터미널이나 IDE를 다시 시작하세요.

방법 2 · 명령 프롬프트 (영구적)

Copy
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 (영구적)

Copy
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 창에서만 유효)

Copy
1
set ANTHROPIC_BASE_URL=https://www.codebyai.net/api/agent
2
set ANTHROPIC_AUTH_TOKEN=sk-proj-xxxx
3
set API_TIMEOUT_MS=600000
4
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Claude 코딩 환경 시작

아무 프로젝트 디렉토리에서나 다음을 실행하세요:

Copy
1
cd your-project
2
claude

성공적으로 시작되면 다음과 유사한 인터페이스가 나타납니다:

VS Code(또는 다른 IDE) 확장을 사용하는 경우에도 이러한 환경 변수가 필요합니다. 다음 프롬프트가 표시되는 경우:

확장이 구성을 읽지 못했음을 의미하므로 다시 확인해야 합니다. 구성 파일에 이 값들을 직접 하드코딩할 수도 있습니다:

• Claude 전역 설정

  • macOS/Linux: ~/.claude/settings.json
  • Windows: C:/Users/<UserName>/.claude/settings.json 예시 내용:

  Copy
  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
  }

• VS Code settings.json – 추가:

  Copy
  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를 다시 로드하거나 터미널을 다시 시작하세요.