variableway/fire-skills

AI Config Skill

다양한 AI 프로그래밍 도구에 AI Agent Provider를 한 번에 설정합니다.

지원 도구 및 Provider

도구	GLM	OpenRouter	OpenAI	Anthropic
Claude Code	✅	❌	❌	✅
Codex CLI	✅	✅	✅	❌
OpenCode	✅	❌	✅	❌
Cline	✅	❌	✅	❌
OpenClaw	✅	❌	❌	❌

두 가지 설정 방식

방식 A: 자동 설치 (권장)

공식 도구를 사용하여 설치, 설정, MCP 관리를 자동으로 완료합니다.

GLM (지푸 코딩 플랜) — 원클릭 설정:

npx @z_ai/coding-helper

이 도구가 자동으로 수행하는 작업:

• 도구 설치 (Claude Code / OpenCode / Crush / Factory Droid)
• API Key 설정
• 모델 요금제 로딩
• MCP Server 관리

OpenCode (GLM 내장 지원):

opencode auth login
# "Zhipu AI Coding Plan" 선택 후 API Key 입력
opencode
# /models 명령어로 GLM 모델 선택

방식 B: 템플릿 복사

ai-config/templates/에서 미리 준비된 템플릿을 대상 위치로 복사한 후, 사용자가 API Key만 수정하면 됩니다.

각 도구별 템플릿 파일 및 대상 경로:

도구	템플릿 파일	복사 위치
Claude Code + GLM	templates/claude-code/glm.sh	터미널에 source
Claude Code + GLM 모델 매핑	templates/claude-code/glm-settings.json	~/.claude/settings.json에 병합
Claude Code + Anthropic	templates/claude-code/anthropic.sh	터미널에 source
Codex + GLM	templates/codex/glm.toml	~/.codex/config.toml
Codex + OpenRouter	templates/codex/openrouter.toml	~/.codex/config.toml
Codex + OpenAI	templates/codex/openai.toml	~/.codex/config.toml
OpenCode + GLM	templates/opencode/glm.json	~/.config/opencode/opencode.json
OpenCode + OpenAI	templates/opencode/openai.json	~/.config/opencode/opencode.json
Cline + GLM	templates/cline/glm.md	IDE 내 설정 참조
OpenClaw + GLM	templates/openclaw/glm.json	~/.openclaw/openclaw.json에 병합

사용 가이드

사용자가 "GLM 설정", "OpenRouter 설정", "ai-config glm" 등을 요청할 때:

Step 1: Provider 확인

• glm → 방식 A 우선 권장 (npx @z_ai/coding-helper), 방식 B도 가능
• openrouter / openai → 방식 B 사용 (템플릿 복사)
• anthropic → 방식 B 사용

Step 2: 설정 실행

GLM 설정 (권장 방식 A)

npx @z_ai/coding-helper

대화형 안내에 따라 진행합니다. 수동 설정을 선호하는 경우 방식 B 사용:

# Claude Code + GLM
source ai-config/templates/claude-code/glm.sh
# glm-settings.json을 ~/.claude/settings.json에 병합하면 모델이 GLM-5.1로 전환됩니다

# Codex CLI + GLM
mkdir -p ~/.codex
cp ai-config/templates/codex/glm.toml ~/.codex/config.toml

# OpenCode + GLM
cp ai-config/templates/opencode/glm.json ~/.config/opencode/opencode.json

OpenRouter / OpenAI 설정 (방식 B)

# Codex CLI + OpenRouter
mkdir -p ~/.codex
cp ai-config/templates/codex/openrouter.toml ~/.codex/config.toml

# Codex CLI + OpenAI
mkdir -p ~/.codex
cp ai-config/templates/codex/openai.toml ~/.codex/config.toml

Step 3: API Key 설정 안내

Provider	환경 변수	획득 주소
GLM	ANTHROPIC_API_KEY (Claude Code) / GLM_API_KEY (Codex)	https://open.bigmodel.cn
OpenRouter	OPENROUTER_API_KEY	https://openrouter.ai
OpenAI	OPENAI_API_KEY	https://platform.openai.com
Anthropic	ANTHROPIC_API_KEY	https://console.anthropic.com

echo 'export XXX_API_KEY="your-key"' >> ~/.zshrc
source ~/.zshrc

주요 API 엔드포인트

용도	엔드포인트 URL
GLM Coding Plan (일반)	https://open.bigmodel.cn/api/coding/paas/v4
GLM Coding Plan (Claude Code)	https://open.bigmodel.cn/api/anthropic
GLM 일반 API	https://open.bigmodel.cn/api/paas/v4
OpenRouter	https://openrouter.ai/api/v1
OpenAI	https://api.openai.com/v1

Claude Code 모델 매핑

GLM 설정 후 Claude Code의 자동 매핑:

Claude 모델 계층	기본 GLM 모델
Opus	GLM-5.1
Sonnet	GLM-5.1
Haiku	GLM-4.5-Air

이는 glm-settings.json 설정 결과입니다. 해당 설정을 사용하지 않으면 기본 매핑은 Opus→GLM-4.7, Sonnet→GLM-4.7, Haiku→GLM-4.5-Air입니다.

실행 후 /status 명령어로 현재 모델 상태를 확인하세요.

템플릿 디렉토리 구조

ai-config/
├── SKILL.md                          # 본 파일
└── templates/
    ├── claude-code/
    │   ├── glm.sh                    # Claude Code + GLM 환경 변수
    │   ├── glm-settings.json         # Claude Code + GLM 모델 매핑
    │   └── anthropic.sh              # Claude Code + Anthropic 복원
    ├── codex/
    │   ├── glm.toml                  # Codex CLI + GLM
    │   ├── openrouter.toml           # Codex CLI + OpenRouter
    │   └── openai.toml               # Codex CLI + OpenAI
    ├── opencode/
    │   ├── glm.json                  # OpenCode + GLM
    │   └── openai.json               # OpenCode + OpenAI
    ├── cline/
    │   └── glm.md                    # Cline + GLM 설정 설명
    └── openclaw/
        └── glm.json                  # OpenClaw + GLM 설정 조각

주의사항

1. API Key 보안: API Key를 Git 저장소에 커밋하지 마세요.
2. GLM Coding Plan 전용 엔드포인트: 반드시 coding/paas/v4를 사용해야 하며, paas/v4를 사용하면 요금제 할당량이 차감되지 않습니다.
3. 기존 Claude 사용자: 기존 설정을 덮어쓰지 않으려면 alias 방식 사용: alias glm-cc='ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic ANTHROPIC_API_KEY="your-key" claude'
4. GLM 사용 가능 모델: GLM-5.1, GLM-5, GLM-4.7, GLM-4.6, GLM-4.5, GLM-4.5-Air
5. Codex CLI 설정 우선순위: 프로젝트 수준 .codex/config.toml > 전역 ~/.codex/config.toml