Skip to content

Conversation

@lehmacdj
Copy link
Owner

@lehmacdj lehmacdj commented Nov 16, 2025

Stack doesn't configure the proxy properly.

Documents the TLS/SSL handshake failure issue that occurs when using Stack
in Claude Code web environments. Stack's HTTP library doesn't automatically
use the https_proxy environment variable, causing connection failures to
Hackage and other Haskell resources.

The workaround involves creating ~/.stack/config.yaml with explicit proxy
settings pointing to the internal egress proxy service.
Major improvements to cli/docs/claude-code-web.md:

- Add Quick Start section for experienced users with complete setup script
- Reorganize into logical flow: Install → Configure → Verify → Develop
- Move proxy configuration earlier (before any Stack commands)
- Remove STACK_ROOT=~/.stack references (not needed with proper config)
- Add comprehensive Troubleshooting section
- Improve formatting and clarity throughout
- Consolidate Development Workflow section
- Add concrete examples for running the CLI

The new structure makes it much easier to follow and reduces setup errors.
Complete rewrite focused on actionable commands and quick reference:

- Lead with copy-paste setup commands (no fluff)
- Clear sections: First Time Setup, Every Session, Common Commands
- Explicit "Errors You Can Ignore" vs "Real Errors" sections
- Quick checks for debugging
- Build time expectations
- Pro tips for efficient workflow
- Removed verbose explanations
- Added inline comments in code blocks

This is now a practical reference card rather than tutorial documentation.
@lehmacdj
Copy link
Owner Author

apply ormolu

@lehmacdj lehmacdj merged commit 03cca09 into main Nov 16, 2025
3 of 4 checks passed
@lehmacdj lehmacdj deleted the claude/fix-haskell-proxy-config-01RPcCqA5rxLs7N6EMYvUCSM branch November 16, 2025 00:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants